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

package/dist/esm/azure/financialChargeCompositionValidation.js

@@ -0,0 +1,155 @@
+import { formatExactDecimalValue, sumCanonicalDecimals } from '../common/exactDecimal.js';
+import { sha256Utf8 } from '../common/sha256.js';
+import { FINANCIAL_CHARGE_COMPOSITION_CONTRACT_VERSION_V1, FINANCIAL_CHARGE_COMPOSITION_SCHEMA_VERSION_V1, resolveFinancialChargeInclusionPolicyV1, } from './financialChargeComposition.js';
+import { canonicalizeFinancialDataflowJsonV1, hasFinancialDataflowExactFieldsV1, isFinancialDataflowCurrencyV1, isFinancialDataflowHashV1, isFinancialDataflowIdentityV1, isFinancialDataflowRecordV1, isFinancialDataflowValueWithinLimitsV1, } from './financialDataflowValidation.js';
+import { isFinancialBaselinePeriodV2 } from './financialScopeBaselineValidation.js';
+import { isCanonicalExactMoney } from './financialValidationPrimitives.js';
+const SOURCES = new Set(['azure-native', 'marketplace', 'unknown']);
+const RECURRENCES = new Set(['one-time', 'recurring', 'usage-based', 'unknown']);
+const CLASSIFICATIONS = new Set(['usage', 'purchase', 'adjustment', 'tax', 'credit', 'refund', 'residual']);
+const COST_BASES = new Set(['billed', 'amortized']);
+const ESTIMATE_LENSES = new Set(['actual-only', 'actual-plus-estimated', 'estimates-only']);
+const isSortedUniqueHashes = (value) => Array.isArray(value) && value.length > 0 && value.length <= 20000 && value.every(isFinancialDataflowHashV1) &&
+    value.every((entry, index) => index === 0 || value[index - 1] < entry);
+const isBucket = (value) => isFinancialDataflowRecordV1(value) &&
+    hasFinancialDataflowExactFieldsV1(value, [
+        'chargeSource',
+        'chargeRecurrence',
+        'chargeClassification',
+        'amount',
+        'componentIds',
+        'evidenceRefIds',
+    ]) &&
+    SOURCES.has(value.chargeSource) &&
+    RECURRENCES.has(value.chargeRecurrence) &&
+    CLASSIFICATIONS.has(value.chargeClassification) &&
+    isCanonicalExactMoney({ amount: value.amount, currencyCode: 'AUD' }) &&
+    isSortedUniqueHashes(value.componentIds) &&
+    isSortedUniqueHashes(value.evidenceRefIds);
+const isIdentity = (value) => {
+    if (!isFinancialDataflowRecordV1(value) ||
+        !hasFinancialDataflowExactFieldsV1(value, [
+            'schemaVersion',
+            'contractVersion',
+            'baselineId',
+            'ownerScopeId',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'accountingCurrencyCode',
+            'buckets',
+            'reconciliation',
+            'algorithmVersion',
+        ]) ||
+        value.schemaVersion !== FINANCIAL_CHARGE_COMPOSITION_SCHEMA_VERSION_V1 ||
+        value.contractVersion !== FINANCIAL_CHARGE_COMPOSITION_CONTRACT_VERSION_V1 ||
+        !isFinancialDataflowHashV1(value.baselineId) ||
+        !isFinancialDataflowIdentityV1(value.ownerScopeId) ||
+        !isFinancialBaselinePeriodV2(value.period) ||
+        !COST_BASES.has(value.costBasis) ||
+        !ESTIMATE_LENSES.has(value.estimateLens) ||
+        !isFinancialDataflowCurrencyV1(value.accountingCurrencyCode) ||
+        !Array.isArray(value.buckets) ||
+        value.buckets.length === 0 ||
+        value.buckets.length > 20000 ||
+        !value.buckets.every(isBucket) ||
+        !isFinancialDataflowIdentityV1(value.algorithmVersion) ||
+        !isFinancialDataflowRecordV1(value.reconciliation) ||
+        !hasFinancialDataflowExactFieldsV1(value.reconciliation, ['status', 'bucketTotal', 'sourceTotal', 'difference']) ||
+        value.reconciliation.status !== 'reconciled' ||
+        value.reconciliation.difference !== '0' ||
+        !isCanonicalExactMoney({ amount: value.reconciliation.bucketTotal, currencyCode: value.accountingCurrencyCode }) ||
+        !isCanonicalExactMoney({ amount: value.reconciliation.sourceTotal, currencyCode: value.accountingCurrencyCode }))
+        return false;
+    const componentIds = value.buckets.flatMap(bucket => bucket.componentIds);
+    if (new Set(componentIds).size !== componentIds.length)
+        return false;
+    const keys = value.buckets.map(bucket => `${bucket.chargeSource}\u0000${bucket.chargeRecurrence}\u0000${bucket.chargeClassification}`);
+    if (!keys.every((key, index) => index === 0 || keys[index - 1] < key))
+        return false;
+    try {
+        const bucketTotal = formatExactDecimalValue(sumCanonicalDecimals(value.buckets.map(bucket => bucket.amount)));
+        return bucketTotal === value.reconciliation.bucketTotal && bucketTotal === value.reconciliation.sourceTotal;
+    }
+    catch {
+        return false;
+    }
+};
+export const canonicalizeFinancialChargeCompositionIdentityV1 = (value) => {
+    if (!isFinancialDataflowValueWithinLimitsV1(value) || !isIdentity(value)) {
+        throw new TypeError('Invalid FinancialChargeCompositionIdentityPreimageV1.');
+    }
+    return canonicalizeFinancialDataflowJsonV1(value);
+};
+export const createFinancialChargeCompositionIdV1 = (value) => `sha256:${sha256Utf8(canonicalizeFinancialChargeCompositionIdentityV1(value))}`;
+export const isFinancialChargeCompositionV1 = (value) => {
+    if (!isFinancialDataflowValueWithinLimitsV1(value) ||
+        !isFinancialDataflowRecordV1(value) ||
+        !hasFinancialDataflowExactFieldsV1(value, [
+            'chargeCompositionId',
+            'schemaVersion',
+            'contractVersion',
+            'baselineId',
+            'ownerScopeId',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'accountingCurrencyCode',
+            'buckets',
+            'reconciliation',
+            'algorithmVersion',
+        ]))
+        return false;
+    const { chargeCompositionId, ...identity } = value;
+    return isFinancialDataflowHashV1(chargeCompositionId) && isIdentity(identity) &&
+        chargeCompositionId === createFinancialChargeCompositionIdV1(identity);
+};
+export const isFinancialChargeInclusionPolicyRefV1 = (value) => isFinancialDataflowRecordV1(value) &&
+    hasFinancialDataflowExactFieldsV1(value, ['policyId', 'policyDigest']) &&
+    isFinancialDataflowIdentityV1(value.policyId) &&
+    isFinancialDataflowHashV1(value.policyDigest) &&
+    resolveFinancialChargeInclusionPolicyV1(value) !== undefined;
+const sumBuckets = (buckets) => formatExactDecimalValue(sumCanonicalDecimals(buckets.map(bucket => bucket.amount)));
+const sourcesFor = (policy, role) => role === 'include' ? policy.includeSources : role === 'exclude' ? policy.excludeSources : policy.withholdSources;
+export const selectFinancialChargesV1 = (composition, policyRef) => {
+    if (!isFinancialChargeCompositionV1(composition))
+        throw new TypeError('Invalid financial charge composition.');
+    const policy = resolveFinancialChargeInclusionPolicyV1(policyRef);
+    if (!policy)
+        throw new TypeError('Unregistered financial charge-inclusion policy.');
+    const partition = (role) => composition.buckets.filter(bucket => sourcesFor(policy, role).includes(bucket.chargeSource));
+    const included = partition('include');
+    const excluded = partition('exclude');
+    const withheld = partition('withhold');
+    if (included.length + excluded.length + withheld.length !== composition.buckets.length) {
+        throw new TypeError('Financial charge-inclusion policy does not partition every charge source.');
+    }
+    const includedAmount = sumBuckets(included);
+    const excludedAmount = sumBuckets(excluded);
+    const withheldAmount = sumBuckets(withheld);
+    const forecastEligibleAmount = sumBuckets(included.filter(bucket => bucket.chargeRecurrence === 'recurring' || bucket.chargeRecurrence === 'usage-based'));
+    const oneTimeAmount = sumBuckets(included.filter(bucket => bucket.chargeRecurrence === 'one-time'));
+    const unknownRecurrenceAmount = sumBuckets(included.filter(bucket => bucket.chargeRecurrence === 'unknown'));
+    const reasonCodes = [];
+    if (withheldAmount !== '0')
+        reasonCodes.push('charge-source-unknown');
+    const forecastReasonCodes = [...reasonCodes];
+    if (unknownRecurrenceAmount !== '0')
+        forecastReasonCodes.push('charge-recurrence-unknown');
+    const result = {
+        status: withheldAmount === '0' ? 'available' : 'partial',
+        includedAmount,
+        excludedAmount,
+        withheldAmount,
+        forecastEligibleAmount,
+        oneTimeAmount,
+        unknownRecurrenceAmount,
+        forecastStatus: withheldAmount === '0' && unknownRecurrenceAmount === '0' ? 'available' : 'partial',
+        currencyCode: composition.accountingCurrencyCode,
+        ...(reasonCodes.length === 0 ? {} : { reasonCodes: reasonCodes }),
+        ...(forecastReasonCodes.length === 0
+            ? {}
+            : { forecastReasonCodes: forecastReasonCodes }),
+    };
+    return result;
+};

package/dist/esm/azure/financialDataflowKernel.js

@@ -1,5 +1,6 @@
 import { formatExactDecimalValue, parseCanonicalDecimal, subtractExactDecimalValues, sumCanonicalDecimals, } from '../common/exactDecimal.js';
 import { FINANCIAL_CURRENT_SPEND_COMPOSITION_CONTRACT_VERSION_V1, FINANCIAL_DATAFLOW_SCHEMA_VERSION_V1, } from './financialDataflow.js';
+import { selectFinancialChargesV1 } from './financialChargeCompositionValidation.js';
 import { createCurrentSpendCompositionIdV1, createCurrentSpendMembershipDigestV1, isCurrentSpendCompositionCompatibleV1, } from './financialDataflowValidation.js';
 import { isCompleteFinancialBaselinePeriodV2 } from './financialScopeBaseline.js';
 export const CURRENT_SPEND_COMPOSITION_ALGORITHM_VERSION_V1 = 'current-spend-composition/shared-v1';
@@ -58,17 +59,50 @@ export const composeCurrentSpendV1 = (request) => {
     }
     if (request.baselines.length === 0)
         throw new TypeError('Current-spend composition requires an authoritative baseline member.');
+    if (request.chargeCompositions.length > request.baselines.length) {
+        throw new TypeError('Current-spend composition has more charge compositions than baseline members.');
+    }
+    const chargeCompositionByBaselineId = new Map(request.chargeCompositions.map(composition => [composition.baselineId, composition]));
+    if (chargeCompositionByBaselineId.size !== request.chargeCompositions.length) {
+        throw new TypeError('Current-spend composition cannot contain duplicate charge compositions.');
+    }
     const sortedBaselines = [...request.baselines].sort((left, right) => left.scopeId.localeCompare(right.scopeId));
     if (new Set(sortedBaselines.map(baseline => baseline.scopeId)).size !== sortedBaselines.length) {
         throw new TypeError('Current-spend composition cannot contain duplicate member scopes.');
     }
-    const members = sortedBaselines.map(baseline => baseline.status === 'available'
-        ? { memberScopeId: baseline.scopeId, baselineId: baseline.baselineId, status: 'included' }
-        : { memberScopeId: baseline.scopeId, status: 'unavailable', reasonCode: baseline.unavailableReason });
+    const selections = new Map();
+    const members = sortedBaselines.map(baseline => {
+        if (baseline.status === 'unavailable') {
+            return { memberScopeId: baseline.scopeId, status: 'unavailable', reasonCode: baseline.unavailableReason };
+        }
+        if (baseline.baselineKind !== 'owner') {
+            return { memberScopeId: baseline.scopeId, status: 'unavailable', reasonCode: 'charge-composition-requires-owner-baseline' };
+        }
+        const chargeComposition = chargeCompositionByBaselineId.get(baseline.baselineId);
+        if (!chargeComposition || chargeComposition.ownerScopeId !== baseline.scopeId) {
+            return { memberScopeId: baseline.scopeId, status: 'unavailable', reasonCode: 'charge-composition-unavailable' };
+        }
+        const selection = selectFinancialChargesV1(chargeComposition, request.coordinate.chargeInclusionPolicyRef);
+        selections.set(baseline.baselineId, selection);
+        return {
+            memberScopeId: baseline.scopeId,
+            baselineId: baseline.baselineId,
+            chargeCompositionId: chargeComposition.chargeCompositionId,
+            status: 'included',
+        };
+    });
     const available = sortedBaselines.filter((baseline) => baseline.status === 'available');
+    const includedBaselineIds = new Set(members.flatMap(member => (member.status === 'included' ? [member.baselineId] : [])));
+    const includedBaselines = available.filter(baseline => includedBaselineIds.has(baseline.baselineId));
     const unavailableReasons = new Set(sortedBaselines
         .filter((baseline) => baseline.status === 'unavailable')
         .map(baseline => baseline.unavailableReason));
+    members.filter(member => member.status === 'unavailable').forEach(member => unavailableReasons.add(member.reasonCode));
+    const selectionReasonCodes = new Set();
+    selections.forEach(selection => selection.reasonCodes?.forEach(reason => {
+        selectionReasonCodes.add(reason);
+        unavailableReasons.add(reason);
+    }));
     if (available.some(baseline => !isCompleteFinancialBaselinePeriodV2(baseline.period)))
         unavailableReasons.add('coverage-incomplete');
     if (request.coordinate.accountingCurrency.status === 'unresolved') {
@@ -84,7 +118,7 @@ export const composeCurrentSpendV1 = (request) => {
     };
     const currency = request.coordinate.accountingCurrency.status === 'resolved' ? request.coordinate.accountingCurrency.currencyCode : undefined;
     let identity;
-    if (!currency || available.length === 0) {
+    if (!currency || includedBaselines.length === 0) {
         identity = {
             ...common,
             amount: {
@@ -94,17 +128,36 @@ export const composeCurrentSpendV1 = (request) => {
         };
     }
     else {
-        const knownAmount = formatExactDecimalValue(sumCanonicalDecimals(available.map(baseline => baseline.total.amount)));
+        const includedSelections = members.flatMap(member => member.status === 'included' ? [selections.get(member.baselineId)] : []);
+        const aggregateSelection = {
+            status: includedSelections.some(selection => selection.status === 'partial') ? 'partial' : 'available',
+            includedAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.includedAmount))),
+            excludedAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.excludedAmount))),
+            withheldAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.withheldAmount))),
+            forecastEligibleAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.forecastEligibleAmount))),
+            oneTimeAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.oneTimeAmount))),
+            unknownRecurrenceAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.unknownRecurrenceAmount))),
+            forecastStatus: includedSelections.some(selection => selection.forecastStatus === 'partial') ? 'partial' : 'available',
+            currencyCode: currency,
+            ...(selectionReasonCodes.size === 0 ? {} : { reasonCodes: uniqueSorted(selectionReasonCodes) }),
+            ...(includedSelections.every(selection => selection.forecastReasonCodes === undefined)
+                ? {}
+                : {
+                    forecastReasonCodes: uniqueSorted(includedSelections.flatMap(selection => selection.forecastReasonCodes ?? [])),
+                }),
+        };
+        const knownAmount = aggregateSelection.includedAmount;
         identity =
             unavailableReasons.size === 0
-                ? { ...common, amount: { status: 'available', amount: knownAmount, currencyCode: currency } }
+                ? { ...common, amount: { status: 'available', amount: knownAmount, currencyCode: currency }, chargeSelection: aggregateSelection }
                 : {
                     ...common,
                     amount: { status: 'partial', knownAmount, currencyCode: currency, reasonCodes: uniqueSorted(unavailableReasons) },
+                    chargeSelection: aggregateSelection,
                 };
     }
     const composition = { ...identity, compositionId: createCurrentSpendCompositionIdV1(identity) };
-    if (!isCurrentSpendCompositionCompatibleV1(composition, sortedBaselines)) {
+    if (!isCurrentSpendCompositionCompatibleV1(composition, sortedBaselines, request.chargeCompositions)) {
         throw new TypeError('Current-spend composition does not reconcile to its authoritative baseline members.');
     }
     return composition;

package/dist/esm/azure/financialDataflowValidation.js

@@ -2,6 +2,8 @@ import { sha256Utf8 } from '../common/sha256.js';
 import { formatExactDecimalValue, sumCanonicalDecimals } from '../common/exactDecimal.js';
 import { toCanonicalEstimateLensV1 } from './costComposition.js';
 import { isCanonicalExactMoney } from './financialValidationPrimitives.js';
+import { AZURE_BILLED_ALL_CHARGES_POLICY_V1, resolveFinancialChargeInclusionPolicyV1, } from './financialChargeComposition.js';
+import { isFinancialChargeCompositionV1, selectFinancialChargesV1 } from './financialChargeCompositionValidation.js';
 import { isCompleteFinancialBaselinePeriodV2 } from './financialScopeBaseline.js';
 import { isFinancialScopeBaselineEnvelopeV2 } from './financialScopeBaselineValidation.js';
 import { FINANCIAL_CURRENT_SPEND_COMPOSITION_CONTRACT_VERSION_V1, FINANCIAL_DATAFLOW_SCHEMA_VERSION_V1, } from './financialDataflow.js';
@@ -361,7 +363,18 @@ export const isFinancialDataflowScopeSelectorV1 = (value) => {
 };
 export const isFinancialDataflowCoordinateV1 = (value) => {
     if (!isFinancialDataflowRecordV1(value) ||
-        !hasFinancialDataflowExactFieldsV1(value, ['companyId', 'provider', 'providerAccountRefs', 'scope', 'periodRole', 'period', 'costBasis', 'estimateLens', 'accountingCurrency'], ['requestedCurrencyCode']) ||
+        !hasFinancialDataflowExactFieldsV1(value, [
+            'companyId',
+            'provider',
+            'providerAccountRefs',
+            'scope',
+            'periodRole',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'accountingCurrency',
+            'chargeInclusionPolicyRef',
+        ], ['requestedCurrencyCode']) ||
         !isFinancialDataflowIdentityV1(value.companyId) ||
         value.provider !== 'azure' ||
         !isFinancialDataflowSortedUniqueStringsV1(value.providerAccountRefs, FINANCIAL_DATAFLOW_LIMITS_V1.maximumProviderAccounts) ||
@@ -375,7 +388,12 @@ export const isFinancialDataflowCoordinateV1 = (value) => {
         typeof value.estimateLens !== 'string' ||
         !ESTIMATE_LENSES.has(value.estimateLens) ||
         (value.requestedCurrencyCode !== undefined && !isFinancialDataflowCurrencyV1(value.requestedCurrencyCode)) ||
-        !isFinancialDataflowRecordV1(value.accountingCurrency)) {
+        !isFinancialDataflowRecordV1(value.accountingCurrency) ||
+        !isFinancialDataflowRecordV1(value.chargeInclusionPolicyRef) ||
+        !hasFinancialDataflowExactFieldsV1(value.chargeInclusionPolicyRef, ['policyId', 'policyDigest']) ||
+        !isFinancialDataflowIdentityV1(value.chargeInclusionPolicyRef.policyId) ||
+        !isFinancialDataflowHashV1(value.chargeInclusionPolicyRef.policyDigest) ||
+        resolveFinancialChargeInclusionPolicyV1(value.chargeInclusionPolicyRef) === undefined) {
         return false;
     }
     if (value.accountingCurrency.status === 'resolved') {
@@ -403,7 +421,9 @@ const isMember = (value) => {
     if (!isFinancialDataflowRecordV1(value) || !isFinancialDataflowIdentityV1(value.memberScopeId))
         return false;
     if (value.status === 'included') {
-        return hasFinancialDataflowExactFieldsV1(value, ['memberScopeId', 'baselineId', 'status']) && isFinancialDataflowHashV1(value.baselineId);
+        return (hasFinancialDataflowExactFieldsV1(value, ['memberScopeId', 'baselineId', 'chargeCompositionId', 'status']) &&
+            isFinancialDataflowHashV1(value.baselineId) &&
+            isFinancialDataflowHashV1(value.chargeCompositionId));
     }
     return (value.status === 'unavailable' &&
         hasFinancialDataflowExactFieldsV1(value, ['memberScopeId', 'status', 'reasonCode']) &&
@@ -421,15 +441,7 @@ export const canonicalizeCurrentSpendMembershipV1 = (members) => {
 export const createCurrentSpendMembershipDigestV1 = (members) => `sha256:${sha256Utf8(canonicalizeCurrentSpendMembershipV1(members))}`;
 const isCompositionIdentity = (value) => {
     if (!isFinancialDataflowRecordV1(value) ||
-        !hasFinancialDataflowExactFieldsV1(value, [
-            'schemaVersion',
-            'contractVersion',
-            'coordinate',
-            'members',
-            'amount',
-            'membershipDigest',
-            'algorithmVersion',
-        ]) ||
+        !hasFinancialDataflowExactFieldsV1(value, ['schemaVersion', 'contractVersion', 'coordinate', 'members', 'amount', 'membershipDigest', 'algorithmVersion'], ['chargeSelection']) ||
         value.schemaVersion !== FINANCIAL_DATAFLOW_SCHEMA_VERSION_V1 ||
         value.contractVersion !== FINANCIAL_CURRENT_SPEND_COMPOSITION_CONTRACT_VERSION_V1 ||
         !isFinancialDataflowCoordinateV1(value.coordinate) ||
@@ -445,11 +457,45 @@ const isCompositionIdentity = (value) => {
         return false;
     }
     const currency = value.coordinate.accountingCurrency.status === 'resolved' ? value.coordinate.accountingCurrency.currencyCode : undefined;
+    const isChargeSelection = (selection) => {
+        if (!isFinancialDataflowRecordV1(selection) ||
+            !hasFinancialDataflowExactFieldsV1(selection, [
+                'status',
+                'includedAmount',
+                'excludedAmount',
+                'withheldAmount',
+                'forecastEligibleAmount',
+                'oneTimeAmount',
+                'unknownRecurrenceAmount',
+                'forecastStatus',
+                'currencyCode',
+            ], ['reasonCodes', 'forecastReasonCodes']) ||
+            (selection.status !== 'available' && selection.status !== 'partial') ||
+            (selection.forecastStatus !== 'available' && selection.forecastStatus !== 'partial') ||
+            !isFinancialDataflowCurrencyV1(selection.currencyCode) ||
+            ![
+                selection.includedAmount,
+                selection.excludedAmount,
+                selection.withheldAmount,
+                selection.forecastEligibleAmount,
+                selection.oneTimeAmount,
+                selection.unknownRecurrenceAmount,
+            ].every(amount => isCanonicalExactMoney({ amount, currencyCode: selection.currencyCode })))
+            return false;
+        return ((selection.status === 'available' ? selection.reasonCodes === undefined : isReasonCodes(selection.reasonCodes)) &&
+            (selection.forecastStatus === 'available'
+                ? selection.forecastReasonCodes === undefined
+                : isReasonCodes(selection.forecastReasonCodes)));
+    };
     if (value.amount.status === 'available') {
         return (currency !== undefined &&
             hasFinancialDataflowExactFieldsV1(value.amount, ['status', 'amount', 'currencyCode']) &&
             isCanonicalExactMoney({ amount: value.amount.amount, currencyCode: value.amount.currencyCode }) &&
             value.amount.currencyCode === currency &&
+            isChargeSelection(value.chargeSelection) &&
+            value.chargeSelection.status === 'available' &&
+            value.chargeSelection.currencyCode === currency &&
+            value.chargeSelection.includedAmount === value.amount.amount &&
             value.members.length > 0 &&
             value.members.every(member => member.status === 'included'));
     }
@@ -459,11 +505,17 @@ const isCompositionIdentity = (value) => {
             isCanonicalExactMoney({ amount: value.amount.knownAmount, currencyCode: value.amount.currencyCode }) &&
             value.amount.currencyCode === currency &&
             isReasonCodes(value.amount.reasonCodes) &&
+            isChargeSelection(value.chargeSelection) &&
+            value.chargeSelection.currencyCode === currency &&
+            value.chargeSelection.includedAmount === value.amount.knownAmount &&
             value.members.some(member => member.status === 'included') &&
-            (value.members.some(member => member.status === 'unavailable') || value.amount.reasonCodes.includes('coverage-incomplete')));
+            (value.members.some(member => member.status === 'unavailable') ||
+                value.amount.reasonCodes.includes('coverage-incomplete') ||
+                value.chargeSelection.status === 'partial'));
     }
     const unresolvedCurrency = value.coordinate.accountingCurrency;
     return (value.amount.status === 'unavailable' &&
+        value.chargeSelection === undefined &&
         hasFinancialDataflowExactFieldsV1(value.amount, ['status', 'reasonCodes']) &&
         isReasonCodes(value.amount.reasonCodes) &&
         (currency !== undefined || (unresolvedCurrency.status === 'unresolved' && value.amount.reasonCodes.includes(unresolvedCurrency.reasonCode))));
@@ -480,6 +532,19 @@ export const canonicalizeCurrentSpendCompositionIdentityV1 = (value) => {
         },
         members: [...value.members].sort((left, right) => left.memberScopeId.localeCompare(right.memberScopeId)),
         amount: value.amount.status === 'available' ? value.amount : { ...value.amount, reasonCodes: [...value.amount.reasonCodes].sort() },
+        ...(value.chargeSelection === undefined
+            ? {}
+            : {
+                chargeSelection: {
+                    ...value.chargeSelection,
+                    ...(value.chargeSelection.reasonCodes === undefined
+                        ? {}
+                        : { reasonCodes: [...value.chargeSelection.reasonCodes].sort() }),
+                    ...(value.chargeSelection.forecastReasonCodes === undefined
+                        ? {}
+                        : { forecastReasonCodes: [...value.chargeSelection.forecastReasonCodes].sort() }),
+                },
+            }),
     };
     return canonicalizeFinancialDataflowJsonV1(canonical);
 };
@@ -496,7 +561,7 @@ export const isCurrentSpendCompositionV1 = (value) => {
             'amount',
             'membershipDigest',
             'algorithmVersion',
-        ])) {
+        ], ['chargeSelection'])) {
         return false;
     }
     const { compositionId, ...identity } = value;
@@ -511,65 +576,118 @@ const hasCompatibleBaselineCoordinate = (coordinate, baseline) => baseline.provi
     toCanonicalEstimateLensV1(baseline.estimateLens) === coordinate.estimateLens &&
     baseline.requestedCurrencyCode === coordinate.requestedCurrencyCode;
 /** Proves that composition membership and money reconcile to exact V2 baseline envelopes. */
-export const isCurrentSpendCompositionCompatibleV1 = (composition, baselines) => {
+export const isCurrentSpendCompositionCompatibleV1 = (composition, baselines, chargeCompositions) => {
     if (!isCurrentSpendCompositionV1(composition) ||
         !Array.isArray(baselines) ||
         baselines.length !== composition.members.length ||
         baselines.length > FINANCIAL_DATAFLOW_LIMITS_V1.maximumMembers ||
-        !baselines.every(isFinancialScopeBaselineEnvelopeV2)) {
+        !baselines.every(isFinancialScopeBaselineEnvelopeV2) ||
+        !Array.isArray(chargeCompositions) ||
+        !chargeCompositions.every(isFinancialChargeCompositionV1)) {
         return false;
     }
     const typedBaselines = baselines;
+    const typedChargeCompositions = chargeCompositions;
+    const chargeCompositionById = new Map(typedChargeCompositions.map(value => [value.chargeCompositionId, value]));
+    if (chargeCompositionById.size !== typedChargeCompositions.length)
+        return false;
     const baselineByScopeId = new Map(typedBaselines.map(baseline => [baseline.scopeId, baseline]));
     if (baselineByScopeId.size !== typedBaselines.length ||
         new Set(typedBaselines.filter(baseline => baseline.status === 'available').map(baseline => baseline.baselineId)).size !==
             typedBaselines.filter(baseline => baseline.status === 'available').length) {
         return false;
     }
-    const includedAmounts = [];
+    const includedSelections = [];
     const expectedReasonCodes = new Set();
     for (const member of composition.members) {
         const baseline = baselineByScopeId.get(member.memberScopeId);
         if (baseline === undefined || !hasCompatibleBaselineCoordinate(composition.coordinate, baseline))
             return false;
         if (member.status === 'included') {
-            if (baseline.status !== 'available' || member.baselineId !== baseline.baselineId)
+            if (baseline.status !== 'available' ||
+                baseline.baselineKind !== 'owner' ||
+                member.baselineId !== baseline.baselineId ||
+                canonicalizeFinancialDataflowJsonV1(baseline.chargeInclusionPolicyRef) !==
+                    canonicalizeFinancialDataflowJsonV1(AZURE_BILLED_ALL_CHARGES_POLICY_V1.policyRef))
+                return false;
+            const chargeComposition = chargeCompositionById.get(member.chargeCompositionId);
+            if (chargeComposition === undefined ||
+                chargeComposition.baselineId !== baseline.baselineId ||
+                chargeComposition.ownerScopeId !== baseline.scopeId ||
+                chargeComposition.period.windowKind !== baseline.period.windowKind ||
+                canonicalizeFinancialDataflowJsonV1(chargeComposition.period.requested) !== canonicalizeFinancialDataflowJsonV1(baseline.period.requested) ||
+                chargeComposition.costBasis !== baseline.costBasis ||
+                chargeComposition.estimateLens !== baseline.estimateLens ||
+                chargeComposition.accountingCurrencyCode !== baseline.total.currencyCode ||
+                chargeComposition.reconciliation.sourceTotal !== baseline.total.amount)
                 return false;
             if (composition.coordinate.accountingCurrency.status === 'resolved' &&
                 baseline.total.currencyCode !== composition.coordinate.accountingCurrency.currencyCode) {
                 return false;
             }
-            includedAmounts.push(baseline.total.amount);
+            includedSelections.push(selectFinancialChargesV1(chargeComposition, composition.coordinate.chargeInclusionPolicyRef));
+            includedSelections[includedSelections.length - 1].reasonCodes?.forEach(reason => expectedReasonCodes.add(reason));
             if (baseline.status === 'available' && !isCompleteFinancialBaselinePeriodV2(baseline.period)) {
                 expectedReasonCodes.add('coverage-incomplete');
             }
             continue;
         }
-        if (baseline.status !== 'unavailable' || member.reasonCode !== baseline.unavailableReason)
-            return false;
-        expectedReasonCodes.add(baseline.unavailableReason);
+        if (baseline.status === 'unavailable') {
+            if (member.reasonCode !== baseline.unavailableReason)
+                return false;
+            expectedReasonCodes.add(baseline.unavailableReason);
+        }
+        else {
+            const expectedDerivedReason = baseline.baselineKind === 'aggregate'
+                ? 'charge-composition-requires-owner-baseline'
+                : 'charge-composition-unavailable';
+            if (member.reasonCode !== expectedDerivedReason)
+                return false;
+            expectedReasonCodes.add(expectedDerivedReason);
+        }
     }
     if (composition.coordinate.accountingCurrency.status === 'unresolved') {
         expectedReasonCodes.add(composition.coordinate.accountingCurrency.reasonCode);
     }
+    if (typedChargeCompositions.length !== includedSelections.length)
+        return false;
     const hasExpectedReasonCodes = (reasonCodes) => reasonCodes.length === expectedReasonCodes.size && reasonCodes.every(reasonCode => expectedReasonCodes.has(reasonCode));
     if (composition.coordinate.accountingCurrency.status === 'unresolved') {
         return composition.amount.status === 'unavailable' && hasExpectedReasonCodes(composition.amount.reasonCodes);
     }
-    if (includedAmounts.length === 0) {
+    if (includedSelections.length === 0) {
         return composition.amount.status === 'unavailable' && hasExpectedReasonCodes(composition.amount.reasonCodes);
     }
-    let includedTotal;
+    let aggregateSelection;
     try {
-        includedTotal = formatExactDecimalValue(sumCanonicalDecimals(includedAmounts));
+        const reasonCodes = new Set(includedSelections.flatMap(selection => selection.reasonCodes ?? []));
+        const forecastReasonCodes = new Set(includedSelections.flatMap(selection => selection.forecastReasonCodes ?? []));
+        aggregateSelection = {
+            status: includedSelections.some(selection => selection.status === 'partial') ? 'partial' : 'available',
+            includedAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.includedAmount))),
+            excludedAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.excludedAmount))),
+            withheldAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.withheldAmount))),
+            forecastEligibleAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.forecastEligibleAmount))),
+            oneTimeAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.oneTimeAmount))),
+            unknownRecurrenceAmount: formatExactDecimalValue(sumCanonicalDecimals(includedSelections.map(selection => selection.unknownRecurrenceAmount))),
+            forecastStatus: includedSelections.some(selection => selection.forecastStatus === 'partial') ? 'partial' : 'available',
+            currencyCode: composition.coordinate.accountingCurrency.currencyCode,
+            ...(reasonCodes.size === 0 ? {} : { reasonCodes: [...reasonCodes].sort() }),
+            ...(forecastReasonCodes.size === 0
+                ? {}
+                : { forecastReasonCodes: [...forecastReasonCodes].sort() }),
+        };
     }
     catch {
         return false;
     }
-    if (includedAmounts.length === composition.members.length && expectedReasonCodes.size === 0) {
-        return composition.amount.status === 'available' && composition.amount.amount === includedTotal;
+    const sameSelection = canonicalizeFinancialDataflowJsonV1(composition.chargeSelection) === canonicalizeFinancialDataflowJsonV1(aggregateSelection);
+    if (!sameSelection)
+        return false;
+    if (includedSelections.length === composition.members.length && expectedReasonCodes.size === 0) {
+        return composition.amount.status === 'available' && composition.amount.amount === aggregateSelection.includedAmount;
     }
     return (composition.amount.status === 'partial' &&
-        composition.amount.knownAmount === includedTotal &&
+        composition.amount.knownAmount === aggregateSelection.includedAmount &&
         hasExpectedReasonCodes(composition.amount.reasonCodes));
 };

package/dist/esm/azure/financialPolicyValidation.js

@@ -1,6 +1,7 @@
 import { multiplyExactDecimalValues, parseCanonicalDecimal, subtractExactDecimalValues } from '../common/exactDecimal.js';
 import { sha256Utf8 } from '../common/sha256.js';
 import { isCanonicalExactMoney } from './financialValidationPrimitives.js';
+import { isFinancialChargeInclusionPolicyRefV1 } from './financialChargeCompositionValidation.js';
 import { FINANCIAL_POLICY_DEFINITION_CONTRACT_VERSION_V1, FINANCIAL_POLICY_EVALUATION_CONTRACT_VERSION_V1, } from './financialPolicy.js';
 import { FINANCIAL_DATAFLOW_LIMITS_V1, canonicalizeFinancialDataflowJsonV1, canonicalizeFinancialDataflowCoordinateV1, hasFinancialDataflowExactFieldsV1, isFinancialDataflowCurrencyV1, createFinancialDataflowCoordinateIdV1, isFinancialDataflowHashV1, isFinancialDataflowIdentityV1, isFinancialDataflowIsoInstantV1, isFinancialDataflowRecordV1, isFinancialDataflowScopeSelectorV1, isFinancialDataflowSortedUniqueStringsV1, isFinancialDataflowValueWithinLimitsV1, } from './financialDataflowValidation.js';
 import { isCurrentSpendCompositionV1 } from './financialDataflowValidation.js';
@@ -85,6 +86,7 @@ const isCoordinateRequest = (value, companyId) => isFinancialDataflowRecordV1(va
         'period',
         'costBasis',
         'estimateLens',
+        'chargeInclusionPolicyRef',
         'requiredAccountingCurrencyCode',
     ]) &&
     value.provider === 'azure' &&
@@ -107,6 +109,7 @@ const isCoordinateRequest = (value, companyId) => isFinancialDataflowRecordV1(va
     COST_BASES.has(value.costBasis) &&
     typeof value.estimateLens === 'string' &&
     ESTIMATE_LENSES.has(value.estimateLens) &&
+    isFinancialChargeInclusionPolicyRefV1(value.chargeInclusionPolicyRef) &&
     isFinancialDataflowCurrencyV1(value.requiredAccountingCurrencyCode) &&
     isFinancialDataflowIdentityV1(companyId);
 const isCriteria = (value, currencyCode) => {
@@ -418,6 +421,8 @@ export const isFinancialPolicyEvaluationCompatibleV1 = (evaluation, definition,
         request.scope.scopeId !== coordinate.scope.scopeId ||
         request.costBasis !== coordinate.costBasis ||
         request.estimateLens !== coordinate.estimateLens ||
+        canonicalizeFinancialDataflowJsonV1(request.chargeInclusionPolicyRef) !==
+            canonicalizeFinancialDataflowJsonV1(coordinate.chargeInclusionPolicyRef) ||
         coordinate.requestedCurrencyCode !== request.requiredAccountingCurrencyCode ||
         (currency === undefined
             ? currentSpendComposition.amount.status !== 'unavailable'