@spottoai/types-package 1.0.2-dev1138.13 → 1.0.2-dev1138.14

package/dist/esm/azure/financialSavingsSurfaceProjectionValidation.js

@@ -2,7 +2,9 @@ import { sha256Utf8 } from '../common/sha256.js';
 import { canonicalizeFinancialSavingsJsonValue, hasExactFinancialSavingsFields, haveSameFinancialSavingsSet, isFinancialSavingsHash, isFinancialSavingsIdentity, isFinancialSavingsIsoInstant, isFinancialSavingsMinorUnits, isFinancialSavingsRecord, sumFinancialSavingsMinorUnits, } from './financialSavingsAuthorityValidationPrimitives.js';
 import { FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1, FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1, } from './financialSavingsSurfaceProjection.js';
 import { isFinancialBaselinePeriodV2 } from './financialScopeBaselineValidation.js';
+import { isFinancialChargeInclusionPolicyRefV1 } from './financialChargeCompositionValidation.js';
 import { isCanonicalExactMoney } from './financialValidationPrimitives.js';
+import { composeFinancialSavingsAllocationPercentageV1 } from './financialSavingsPercentageKernel.js';
 const COST_BASES = new Set(['billed', 'amortized']);
 const ESTIMATE_LENSES = new Set(['actual-only', 'actual-plus-estimated', 'estimates-only']);
 const UNAVAILABLE_REASONS = new Set([
@@ -18,7 +20,22 @@ const MAX_ALLOCATIONS = 20000;
 export const canonicalizeFinancialSavingsSurfaceProjectionIdentityV1 = (value) => JSON.stringify(canonicalizeFinancialSavingsJsonValue({
     ...value,
     providerAccountRefs: [...value.providerAccountRefs].sort(),
-    scope: value.scope.kind === 'subscription-full' ? value.scope : { ...value.scope, recommendationIds: [...value.scope.recommendationIds].sort() },
+    ...(value.lifecycleBindings === undefined
+        ? {}
+        : {
+            lifecycleBindings: [...value.lifecycleBindings]
+                .sort((left, right) => left.resourceId.localeCompare(right.resourceId) || left.recommendationId.localeCompare(right.recommendationId))
+                .map(binding => ({ ...binding, allocationIds: [...binding.allocationIds].sort() })),
+        }),
+    scope: value.scope.kind === 'subscription-full'
+        ? value.scope
+        : value.scope.kind === 'recommendation-query'
+            ? { ...value.scope, recommendationIds: [...value.scope.recommendationIds].sort() }
+            : {
+                ...value.scope,
+                allocationIds: [...value.scope.allocationIds].sort(),
+                recommendationIds: [...value.scope.recommendationIds].sort(),
+            },
     coordinates: [...value.coordinates]
         .sort((left, right) => left.coordinateId.localeCompare(right.coordinateId))
         .map(coordinate => coordinate.status === 'unavailable'
@@ -27,7 +44,29 @@ export const canonicalizeFinancialSavingsSurfaceProjectionIdentityV1 = (value) =
             ...coordinate,
             recommendationContributions: [...coordinate.recommendationContributions]
                 .sort((left, right) => left.recommendationId.localeCompare(right.recommendationId))
-                .map(contribution => ({ ...contribution, allocationIds: [...contribution.allocationIds].sort() })),
+                .map(contribution => ({
+                ...contribution,
+                allocationIds: [...contribution.allocationIds].sort(),
+                ...(contribution.allocations === undefined
+                    ? {}
+                    : {
+                        allocations: [...contribution.allocations].sort((left, right) => left.allocationId.localeCompare(right.allocationId)),
+                    }),
+            })),
+            ...(coordinate.resourceContributions === undefined
+                ? {}
+                : {
+                    resourceContributions: [...coordinate.resourceContributions]
+                        .sort((left, right) => left.resourceId.localeCompare(right.resourceId))
+                        .map(contribution => ({
+                        ...contribution,
+                        allocationIds: [...contribution.allocationIds].sort(),
+                        denominator: {
+                            ...contribution.denominator,
+                            denominatorIds: [...contribution.denominator.denominatorIds].sort(),
+                        },
+                    })),
+                }),
             aggregate: { ...coordinate.aggregate, allocationIds: [...coordinate.aggregate.allocationIds].sort() },
         }),
 }));
@@ -38,12 +77,24 @@ const isScope = (value) => {
         return false;
     if (value.kind === 'subscription-full')
         return hasExactFinancialSavingsFields(value, ['kind']);
-    return (value.kind === 'recommendation-query' &&
+    if (value.kind === 'recommendation-query' &&
         hasExactFinancialSavingsFields(value, ['kind', 'filterFingerprint', 'recommendationIds']) &&
         isFinancialSavingsHash(value.filterFingerprint) &&
         Array.isArray(value.recommendationIds) &&
         value.recommendationIds.length <= MAX_ALLOCATIONS &&
         value.recommendationIds.every(isFinancialSavingsIdentity) &&
+        new Set(value.recommendationIds).size === value.recommendationIds.length)
+        return true;
+    return (value.kind === 'resource-query' &&
+        hasExactFinancialSavingsFields(value, ['kind', 'filterFingerprint', 'allocationIds', 'recommendationIds']) &&
+        isFinancialSavingsHash(value.filterFingerprint) &&
+        Array.isArray(value.allocationIds) &&
+        value.allocationIds.length <= MAX_ALLOCATIONS &&
+        value.allocationIds.every(isFinancialSavingsHash) &&
+        new Set(value.allocationIds).size === value.allocationIds.length &&
+        Array.isArray(value.recommendationIds) &&
+        value.recommendationIds.length <= MAX_ALLOCATIONS &&
+        value.recommendationIds.every(isFinancialSavingsIdentity) &&
         new Set(value.recommendationIds).size === value.recommendationIds.length);
 };
 const isCoordinateCommon = (value) => isFinancialSavingsHash(value.coordinateId) &&
@@ -53,9 +104,20 @@ const isCoordinateCommon = (value) => isFinancialSavingsHash(value.coordinateId)
     COST_BASES.has(value.costBasis) &&
     typeof value.estimateLens === 'string' &&
     ESTIMATE_LENSES.has(value.estimateLens) &&
+    isFinancialChargeInclusionPolicyRefV1(value.chargeInclusionPolicyRef) &&
     (value.requestedCurrencyCode === undefined || isCurrency(value.requestedCurrencyCode)) &&
     (value.currentAggregateBaselineId === undefined || isFinancialSavingsHash(value.currentAggregateBaselineId));
-const isAvailableCoordinate = (value, queryRecommendationIds) => {
+const isLifecycleBinding = (value) => isFinancialSavingsRecord(value) &&
+    hasExactFinancialSavingsFields(value, ['resourceId', 'recommendationId', 'allocationIds']) &&
+    isFinancialSavingsIdentity(value.resourceId) &&
+    isFinancialSavingsIdentity(value.recommendationId) &&
+    Array.isArray(value.allocationIds) &&
+    value.allocationIds.length > 0 &&
+    value.allocationIds.length <= MAX_ALLOCATIONS &&
+    value.allocationIds.every(isFinancialSavingsHash) &&
+    new Set(value.allocationIds).size === value.allocationIds.length;
+const isComposedCoordinate = (value, queryRecommendationIds, queryAllocationIds) => {
+    const partial = value.status === 'partial';
     if (!hasExactFinancialSavingsFields(value, [
         'status',
         'coordinateId',
@@ -63,6 +125,7 @@ const isAvailableCoordinate = (value, queryRecommendationIds) => {
         'period',
         'costBasis',
         'estimateLens',
+        'chargeInclusionPolicyRef',
         'currentAggregateBaselineId',
         'currentAggregate',
         'accountingCurrencyCode',
@@ -70,7 +133,8 @@ const isAvailableCoordinate = (value, queryRecommendationIds) => {
         'roundingMode',
         'recommendationContributions',
         'aggregate',
-    ], ['requestedCurrencyCode']) ||
+        ...(partial ? ['unavailableRecommendationIds'] : []),
+    ], ['requestedCurrencyCode', 'resourceContributions']) ||
         !isCoordinateCommon(value) ||
         !isFinancialSavingsHash(value.currentAggregateBaselineId) ||
         !isCanonicalExactMoney(value.currentAggregate) ||
@@ -90,12 +154,21 @@ const isAvailableCoordinate = (value, queryRecommendationIds) => {
         new Set(value.aggregate.allocationIds).size !== value.aggregate.allocationIds.length ||
         !isFinancialSavingsMinorUnits(value.aggregate.savingsMinorUnits))
         return false;
+    if (partial &&
+        (!Array.isArray(value.unavailableRecommendationIds) ||
+            value.unavailableRecommendationIds.length === 0 ||
+            value.unavailableRecommendationIds.length > MAX_ALLOCATIONS ||
+            !value.unavailableRecommendationIds.every(isFinancialSavingsIdentity) ||
+            new Set(value.unavailableRecommendationIds).size !== value.unavailableRecommendationIds.length ||
+            (queryRecommendationIds !== undefined && value.unavailableRecommendationIds.some(id => !queryRecommendationIds.has(id)))))
+        return false;
     const recommendationIds = new Set();
     const allocationIds = [];
     const contributionAmounts = [];
+    const allocationById = new Map();
     for (const contribution of value.recommendationContributions) {
         if (!isFinancialSavingsRecord(contribution) ||
-            !hasExactFinancialSavingsFields(contribution, ['recommendationId', 'allocationIds', 'savingsMinorUnits']) ||
+            !hasExactFinancialSavingsFields(contribution, ['recommendationId', 'allocationIds', 'savingsMinorUnits'], ['allocations']) ||
             !isFinancialSavingsIdentity(contribution.recommendationId) ||
             recommendationIds.has(contribution.recommendationId) ||
             (queryRecommendationIds !== undefined && !queryRecommendationIds.has(contribution.recommendationId)) ||
@@ -104,17 +177,99 @@ const isAvailableCoordinate = (value, queryRecommendationIds) => {
             contribution.allocationIds.length > MAX_ALLOCATIONS ||
             !contribution.allocationIds.every(isFinancialSavingsHash) ||
             new Set(contribution.allocationIds).size !== contribution.allocationIds.length ||
-            !isFinancialSavingsMinorUnits(contribution.savingsMinorUnits))
+            !isFinancialSavingsMinorUnits(contribution.savingsMinorUnits) ||
+            (queryAllocationIds !== undefined && !Array.isArray(contribution.allocations)) ||
+            (contribution.allocations !== undefined &&
+                (!Array.isArray(contribution.allocations) || contribution.allocations.length !== contribution.allocationIds.length)))
+            return false;
+        const exactAllocations = contribution.allocations;
+        if (exactAllocations === undefined) {
+            recommendationIds.add(contribution.recommendationId);
+            allocationIds.push(...contribution.allocationIds);
+            contributionAmounts.push(contribution.savingsMinorUnits);
+            continue;
+        }
+        const exactAllocationIds = [];
+        const exactAllocationAmounts = [];
+        for (const allocation of exactAllocations) {
+            if (!isFinancialSavingsRecord(allocation) ||
+                !hasExactFinancialSavingsFields(allocation, ['allocationId', 'savingsMinorUnits'], ['denominator']) ||
+                !isFinancialSavingsHash(allocation.allocationId) ||
+                (queryAllocationIds !== undefined && !queryAllocationIds.has(allocation.allocationId)) ||
+                !isFinancialSavingsMinorUnits(allocation.savingsMinorUnits) ||
+                (allocation.denominator !== undefined &&
+                    (!isFinancialSavingsRecord(allocation.denominator) ||
+                        !hasExactFinancialSavingsFields(allocation.denominator, ['denominatorId', 'amount', 'currencyCode']) ||
+                        !isFinancialSavingsHash(allocation.denominator.denominatorId) ||
+                        !isCanonicalExactMoney({
+                            amount: allocation.denominator.amount,
+                            currencyCode: allocation.denominator.currencyCode,
+                        }))))
+                return false;
+            exactAllocationIds.push(allocation.allocationId);
+            exactAllocationAmounts.push(allocation.savingsMinorUnits);
+            allocationById.set(allocation.allocationId, allocation);
+        }
+        if (new Set(exactAllocationIds).size !== exactAllocationIds.length ||
+            !haveSameFinancialSavingsSet(exactAllocationIds, contribution.allocationIds) ||
+            sumFinancialSavingsMinorUnits(exactAllocationAmounts) !== contribution.savingsMinorUnits)
             return false;
         recommendationIds.add(contribution.recommendationId);
         allocationIds.push(...contribution.allocationIds);
         contributionAmounts.push(contribution.savingsMinorUnits);
     }
+    if (value.resourceContributions !== undefined) {
+        if (!Array.isArray(value.resourceContributions) || value.resourceContributions.length > MAX_ALLOCATIONS)
+            return false;
+        const resourceIds = new Set();
+        const resourceAllocationIds = [];
+        for (const contribution of value.resourceContributions) {
+            if (!isFinancialSavingsRecord(contribution) ||
+                !hasExactFinancialSavingsFields(contribution, ['resourceId', 'allocationIds', 'savingsMinorUnits', 'denominator', 'percentage']) ||
+                !isFinancialSavingsIdentity(contribution.resourceId) ||
+                resourceIds.has(contribution.resourceId) ||
+                !Array.isArray(contribution.allocationIds) ||
+                contribution.allocationIds.length === 0 ||
+                contribution.allocationIds.length > MAX_ALLOCATIONS ||
+                !contribution.allocationIds.every(isFinancialSavingsHash) ||
+                new Set(contribution.allocationIds).size !== contribution.allocationIds.length ||
+                !isFinancialSavingsMinorUnits(contribution.savingsMinorUnits) ||
+                !isFinancialSavingsRecord(contribution.denominator) ||
+                !hasExactFinancialSavingsFields(contribution.denominator, ['denominatorIds', 'amount', 'currencyCode']) ||
+                !Array.isArray(contribution.denominator.denominatorIds) ||
+                contribution.denominator.denominatorIds.length === 0 ||
+                !contribution.denominator.denominatorIds.every(isFinancialSavingsHash) ||
+                new Set(contribution.denominator.denominatorIds).size !== contribution.denominator.denominatorIds.length ||
+                !isCanonicalExactMoney({ amount: contribution.denominator.amount, currencyCode: contribution.denominator.currencyCode }) ||
+                typeof contribution.percentage !== 'number' ||
+                !Number.isFinite(contribution.percentage) ||
+                contribution.percentage < 0)
+                return false;
+            const allocations = contribution.allocationIds.map(allocationId => allocationById.get(allocationId));
+            if (allocations.some(allocation => allocation === undefined))
+                return false;
+            const exactAllocations = allocations;
+            const composed = composeFinancialSavingsAllocationPercentageV1(exactAllocations, Number(value.minorUnitScale));
+            if (!composed ||
+                sumFinancialSavingsMinorUnits(exactAllocations.map(allocation => allocation.savingsMinorUnits)) !==
+                    contribution.savingsMinorUnits ||
+                !haveSameFinancialSavingsSet(composed.denominatorIds, contribution.denominator.denominatorIds) ||
+                composed.denominatorAmount !== contribution.denominator.amount ||
+                composed.denominatorCurrencyCode !== contribution.denominator.currencyCode ||
+                composed.percentage !== contribution.percentage)
+                return false;
+            resourceIds.add(contribution.resourceId);
+            resourceAllocationIds.push(...contribution.allocationIds);
+        }
+        if (new Set(resourceAllocationIds).size !== resourceAllocationIds.length ||
+            !haveSameFinancialSavingsSet(resourceAllocationIds, allocationIds))
+            return false;
+    }
     return (new Set(allocationIds).size === allocationIds.length &&
         haveSameFinancialSavingsSet(allocationIds, value.aggregate.allocationIds) &&
         sumFinancialSavingsMinorUnits(contributionAmounts) === value.aggregate.savingsMinorUnits);
 };
-const isUnavailableCoordinate = (value) => hasExactFinancialSavingsFields(value, ['status', 'coordinateId', 'periodRole', 'period', 'costBasis', 'estimateLens', 'unavailableReason'], ['requestedCurrencyCode', 'currentAggregateBaselineId']) &&
+const isUnavailableCoordinate = (value) => hasExactFinancialSavingsFields(value, ['status', 'coordinateId', 'periodRole', 'period', 'costBasis', 'estimateLens', 'chargeInclusionPolicyRef', 'unavailableReason'], ['requestedCurrencyCode', 'currentAggregateBaselineId']) &&
     isCoordinateCommon(value) &&
     typeof value.unavailableReason === 'string' &&
     UNAVAILABLE_REASONS.has(value.unavailableReason);
@@ -132,13 +287,15 @@ export const isFinancialSavingsSurfaceProjectionV1 = (value) => {
             'financialAuthorityId',
             'savingsAuthorityId',
             'coordinates',
-        ]) ||
+        ], ['lifecycleBindings']) ||
         value.schemaVersion !== FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1 ||
         value.contractVersion !== FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1 ||
         !isFinancialSavingsHash(value.projectionId) ||
-        (value.surface !== 'recommendations' && value.surface !== 'dashboard') ||
+        (value.surface !== 'recommendations' && value.surface !== 'resources' && value.surface !== 'dashboard') ||
         !isScope(value.scope) ||
         (value.surface === 'dashboard' && value.scope.kind !== 'subscription-full') ||
+        (value.surface === 'recommendations' && value.scope.kind === 'resource-query') ||
+        (value.surface === 'resources' && value.scope.kind === 'recommendation-query') ||
         value.provider !== 'azure' ||
         !Array.isArray(value.providerAccountRefs) ||
         value.providerAccountRefs.length === 0 ||
@@ -151,21 +308,50 @@ export const isFinancialSavingsSurfaceProjectionV1 = (value) => {
         !isFinancialSavingsIsoInstant(value.artifactGeneration.generatedAt) ||
         !isFinancialSavingsHash(value.financialAuthorityId) ||
         !isFinancialSavingsHash(value.savingsAuthorityId) ||
+        (value.lifecycleBindings !== undefined &&
+            (!Array.isArray(value.lifecycleBindings) ||
+                value.lifecycleBindings.length === 0 ||
+                value.lifecycleBindings.length > MAX_ALLOCATIONS ||
+                !value.lifecycleBindings.every(isLifecycleBinding))) ||
         !Array.isArray(value.coordinates) ||
         value.coordinates.length === 0 ||
         value.coordinates.length > MAX_COORDINATES)
         return false;
     const projection = value;
-    const queryRecommendationIds = projection.scope.kind === 'recommendation-query' ? new Set(projection.scope.recommendationIds) : undefined;
+    const queryRecommendationIds = projection.scope.kind === 'recommendation-query' || projection.scope.kind === 'resource-query'
+        ? new Set(projection.scope.recommendationIds)
+        : undefined;
+    const queryAllocationIds = projection.scope.kind === 'resource-query' ? new Set(projection.scope.allocationIds) : undefined;
     if (!projection.coordinates.every(coordinate => {
         if (!isFinancialSavingsRecord(coordinate))
             return false;
-        return coordinate.status === 'available'
-            ? isAvailableCoordinate(coordinate, queryRecommendationIds)
+        return coordinate.status === 'available' || coordinate.status === 'partial'
+            ? isComposedCoordinate(coordinate, queryRecommendationIds, queryAllocationIds)
             : coordinate.status === 'unavailable' && isUnavailableCoordinate(coordinate);
     }) ||
         new Set(projection.coordinates.map(coordinate => coordinate.coordinateId)).size !== projection.coordinates.length)
         return false;
+    if (projection.lifecycleBindings !== undefined) {
+        const lifecycleKeys = projection.lifecycleBindings.map(binding => `${binding.resourceId}\u0000${binding.recommendationId}`);
+        const boundAllocationIds = projection.lifecycleBindings.flatMap(binding => binding.allocationIds);
+        const projectedAllocationOwners = new Map();
+        for (const coordinate of projection.coordinates) {
+            if (coordinate.status === 'unavailable')
+                continue;
+            for (const contribution of coordinate.recommendationContributions) {
+                for (const allocationId of contribution.allocationIds) {
+                    if (projectedAllocationOwners.has(allocationId))
+                        return false;
+                    projectedAllocationOwners.set(allocationId, contribution.recommendationId);
+                }
+            }
+        }
+        if (new Set(lifecycleKeys).size !== lifecycleKeys.length ||
+            new Set(boundAllocationIds).size !== boundAllocationIds.length ||
+            boundAllocationIds.length !== projectedAllocationOwners.size ||
+            projection.lifecycleBindings.some(binding => binding.allocationIds.some(allocationId => projectedAllocationOwners.get(allocationId) !== binding.recommendationId)))
+            return false;
+    }
     const { projectionId: _projectionId, ...identity } = projection;
     return projection.projectionId === createFinancialSavingsSurfaceProjectionIdV1(identity);
 };

package/dist/esm/azure/financialScope.js

@@ -1,7 +1,11 @@
 export * from './financialScopeEvidence.js';
+export * from './financialEvidenceCoverage.js';
 export * from './financialScopeBaseline.js';
 export * from './financialScopeBaselineIdentity.js';
 export * from './financialScopeBaselineValidation.js';
+export * from './financialChargeComposition.js';
+export * from './financialChargeCompositionValidation.js';
+export * from './financialChargeCompositionKernel.js';
 export * from './financialEvidenceAssessmentValidation.js';
 export * from './financialProjection.js';
 export * from './financialProjectionValidation.js';
@@ -9,17 +13,27 @@ export * from './financialDisplayRollup.js';
 export * from './financialDisplayRollupValidation.js';
 export * from './financialAuthorityView.js';
 export * from './financialAuthorityViewValidation.js';
+export * from './financialAuthorityProjectionKernel.js';
 export * from './financialSavingsAuthority.js';
 export * from './financialSavingsAuthorityValidation.js';
 export * from './financialSavingsSurfaceProjection.js';
 export * from './financialSavingsSurfaceProjectionValidation.js';
+export * from './financialSavingsSurfaceProjectionKernel.js';
+export * from './financialSavingsPercentageKernel.js';
+export * from './financialCurrentSpendSurfaceProjection.js';
+export * from './financialCurrentSpendSurfaceProjectionValidation.js';
+export * from './financialResourceSurfaceProjection.js';
+export * from './financialResourceSurfaceProjectionValidation.js';
 export * from './financialDataflow.js';
 export * from './financialDataflowValidation.js';
+export * from './financialDataflowKernel.js';
 export * from './financialAnalytics.js';
 export * from './financialAnalyticsValidation.js';
+export * from './financialAnalyticsDisplayKernel.js';
 export * from './financialAnalyticsDelivery.js';
 export * from './financialAnalyticsDeliveryValidation.js';
 export * from './financialPolicy.js';
 export * from './financialPolicyValidation.js';
+export * from './financialPolicyKernel.js';
 export * from './financialPolicyDelivery.js';
 export * from './financialPolicyDeliveryValidation.js';

package/dist/esm/azure/financialScopeBaseline.js

@@ -1,5 +1,16 @@
 export const FINANCIAL_SCOPE_BASELINE_SCHEMA_VERSION_V2 = 2;
 export const FINANCIAL_SCOPE_BASELINE_CONTRACT_VERSION_V2 = 'financial-scope-baseline/v2';
+/**
+ * True only when the produced evidence covers the entire requested interval.
+ * Partial periods remain valid monetary evidence for display and forecasting,
+ * but must not be used as the current side of an optimization projection.
+ */
+export const isCompleteFinancialBaselinePeriodV2 = (period) => period.observed !== undefined &&
+    period.observed.startDate === period.requested.startDate &&
+    period.observed.endDateExclusive === period.requested.endDateExclusive &&
+    period.observed.dateBasis === period.requested.dateBasis &&
+    period.observed.timeZone === period.requested.timeZone &&
+    period.gaps.length === 0;
 export const FINANCIAL_SCOPE_BASELINE_UNAVAILABLE_REASONS_V2 = [
     'evidence-not-produced',
     'evidence-not-matched',
@@ -15,5 +26,6 @@ export const FINANCIAL_SCOPE_BASELINE_UNAVAILABLE_REASONS_V2 = [
     'mixed-generation',
     'member-incompatible',
     'reconciliation-failure',
+    'scope-membership-empty',
     'unsupported-scope',
 ];

package/dist/esm/azure/financialScopeBaselineIdentity.js

@@ -85,10 +85,21 @@ const canonicalComponent = (component) => ({
     ownerScopeId: component.ownerScopeId,
     chargeClassification: component.chargeClassification,
     amount: component.amount,
+    ...(component.estimateReason === undefined ? {} : { estimateReason: component.estimateReason }),
     evidenceRefIds: [...component.evidenceRefIds].sort(compareCodePoints),
     coverageIds: [...component.coverageIds].sort(compareCodePoints),
-    ...(component.quantity === undefined ? {} : { quantity: component.quantity }),
-    ...(component.effectiveRate === undefined ? {} : { effectiveRate: component.effectiveRate }),
+    ...(component.quantity === undefined
+        ? {}
+        : { quantity: { amount: component.quantity.amount, unit: component.quantity.unit } }),
+    ...(component.effectiveRate === undefined
+        ? {}
+        : {
+            effectiveRate: {
+                amount: component.effectiveRate.amount,
+                unit: component.effectiveRate.unit,
+                currencyCode: component.effectiveRate.currencyCode,
+            },
+        }),
 });
 /** Canonical UTF-8 text for a validated owner or aggregate baseline identity. */
 export const canonicalizeValidatedFinancialScopeBaselineIdentityV2 = (value) => {
@@ -116,7 +127,10 @@ export const canonicalizeValidatedFinancialScopeBaselineIdentityV2 = (value) =>
                 evidenceRefIds: [...value.accountingCurrency.evidenceRefIds].sort(compareCodePoints),
                 ...(value.accountingCurrency.fxEvidenceRefId === undefined ? {} : { fxEvidenceRefId: value.accountingCurrency.fxEvidenceRefId }),
             },
-            chargeInclusionPolicyRef: value.chargeInclusionPolicyRef,
+            chargeInclusionPolicyRef: {
+                policyId: value.chargeInclusionPolicyRef.policyId,
+                policyDigest: value.chargeInclusionPolicyRef.policyDigest,
+            },
             components: [...value.components].sort((left, right) => compareCodePoints(left.componentId, right.componentId)).map(canonicalComponent),
         });
     }
@@ -124,6 +138,12 @@ export const canonicalizeValidatedFinancialScopeBaselineIdentityV2 = (value) =>
         ...common,
         accountingCurrencyCode: value.accountingCurrencyCode,
         memberBaselineIds: [...value.memberBaselineIds].sort(compareCodePoints),
-        compatibility: value.compatibility,
+        compatibility: {
+            period: value.compatibility.period,
+            costBasis: value.compatibility.costBasis,
+            estimateLens: value.compatibility.estimateLens,
+            accountingCurrency: value.compatibility.accountingCurrency,
+            membership: value.compatibility.membership,
+        },
     });
 };

package/dist/esm/azure/financialScopeBaselineValidation.js

@@ -9,6 +9,7 @@ const MAX_SOURCE_KIND_LENGTH = 128;
 const MAX_IDENTITY_LENGTH = 256;
 const SHA256_ID = /^sha256:[0-9a-f]{64}$/;
 const DATE = /^\d{4}-\d{2}-\d{2}$/;
+const ESTIMATE_REASONS = new Set(['billing-lag', 'billing-unavailable-sponsorship', 'other']);
 const EVIDENCE_ROLES = new Set([
     'billing',
     'billing-currency-declaration',
@@ -17,6 +18,13 @@ const EVIDENCE_ROLES = new Set([
     'retail-rate',
     'commitment-quote',
     'fx-conversion',
+    'commercial-arrangement',
+    'provider-access-observation',
+    'configuration-timeline',
+    'provider-price-schedule',
+    'pricing-function',
+    'charge-inclusion-policy',
+    'settlement-revision',
     'eligibility-rule',
     'recommendation-scenario-set',
     'recommendation-lifecycle',
@@ -35,7 +43,14 @@ const OWNER_SCOPE_KINDS = new Set(['canonical-resource-owner', 'composite-resour
 const AGGREGATE_SCOPE_KINDS = new Set(['subscription-aggregate', 'portfolio-currency-group']);
 const COST_BASES = new Set(['billed', 'amortized']);
 const ESTIMATE_LENSES = new Set(['actual-only', 'actual-plus-estimated', 'estimates-only']);
-const WINDOW_KINDS = new Set(['rolling-30-days', 'calendar-month', 'provider-billing-period', 'stable-billing-window', 'daily']);
+const WINDOW_KINDS = new Set([
+    'rolling-30-days',
+    'calendar-month',
+    'provider-billing-period',
+    'stable-billing-window',
+    'analytics-history',
+    'daily',
+]);
 const SETTLEMENT_STATES = new Set(['settled', 'unsettled', 'mixed', 'unknown']);
 const CHARGE_CLASSIFICATIONS = new Set(['usage', 'purchase', 'adjustment', 'tax', 'credit', 'refund', 'residual']);
 const UNAVAILABLE_REASONS = new Set(FINANCIAL_SCOPE_BASELINE_UNAVAILABLE_REASONS_V2);
@@ -211,9 +226,9 @@ const isCommonBaseline = (value) => value.schemaVersion === FINANCIAL_SCOPE_BASE
     (value.requestedCurrencyCode === undefined || (typeof value.requestedCurrencyCode === 'string' && CURRENCY.test(value.requestedCurrencyCode))) &&
     typeof value.assessmentId === 'string' &&
     SHA256_ID.test(value.assessmentId);
-const isComponent = (value, scopeId, coverageIds, accountingCurrencyCode) => {
+const isComponent = (value, scopeId, coverageIds, accountingCurrencyCode, estimateLens) => {
     if (!isRecord(value) ||
-        !hasExactFields(value, ['componentId', 'billableIdentity', 'ownerScopeId', 'chargeClassification', 'amount', 'evidenceRefIds', 'coverageIds'], ['quantity', 'effectiveRate']) ||
+        !hasExactFields(value, ['componentId', 'billableIdentity', 'ownerScopeId', 'chargeClassification', 'amount', 'evidenceRefIds', 'coverageIds'], ['estimateReason', 'quantity', 'effectiveRate']) ||
         typeof value.componentId !== 'string' ||
         !SHA256_ID.test(value.componentId) ||
         !isBoundedIdentity(value.billableIdentity) ||
@@ -221,6 +236,8 @@ const isComponent = (value, scopeId, coverageIds, accountingCurrencyCode) => {
         typeof value.chargeClassification !== 'string' ||
         !CHARGE_CLASSIFICATIONS.has(value.chargeClassification) ||
         !isCanonicalExactMoney({ amount: value.amount, currencyCode: 'AUD' }) ||
+        (value.estimateReason !== undefined && (typeof value.estimateReason !== 'string' || !ESTIMATE_REASONS.has(value.estimateReason))) ||
+        (estimateLens === 'actual-only' && value.estimateReason !== undefined) ||
         !isHashArray(value.evidenceRefIds) ||
         !isHashArray(value.coverageIds) ||
         !value.coverageIds.every(id => coverageIds.has(id))) {
@@ -299,7 +316,7 @@ const isIdentityPreimage = (value) => {
             return false;
         }
         const coverageIds = new Set(value.period.coverage.map(item => item.coverageId));
-        return (value.components.every(component => isComponent(component, String(value.scopeId), coverageIds, String(value.accountingCurrency.currencyCode))) && new Set(value.components.map(component => component.componentId)).size === value.components.length);
+        return (value.components.every(component => isComponent(component, String(value.scopeId), coverageIds, String(value.accountingCurrency.currencyCode), value.estimateLens)) && new Set(value.components.map(component => component.componentId)).size === value.components.length);
     }
     return (value.baselineKind === 'aggregate' &&
         AGGREGATE_SCOPE_KINDS.has(String(value.scopeKind)) &&

package/dist/esm/azure/governance.js

@@ -6,6 +6,7 @@ export const TENANT_GOVERNANCE_GRAPH_SCHEMA_VERSION = '2026-05-02.tenant-graph-v
 export const GLOBAL_ADMIN_RAW_SCHEMA_VERSION = '2026-06-24.global-admin-raw-v1';
 export const PRIVILEGED_ROLE_SUMMARY_SCHEMA_VERSION = '2026-06-24.privileged-role-summary-v1';
 export const TENANT_GOVERNANCE_ACCESS_SCHEMA_VERSION = '2026-06-24.tenant-governance-access-v1';
+export const TENANT_MFA_POSTURE_SCHEMA_VERSION = '2026-08-25.tenant-mfa-posture-v1';
 export const GOVERNANCE_REPORT_PORTAL_FILE = 'governance.json.gz';
 export const GOVERNANCE_GRAPH_PORTAL_FILE = 'governance-graph.json.gz';
 export const GOVERNANCE_ACCESS_PORTAL_FILE = 'governance-access.json.gz';

package/dist/esm/azure/payloads.js

@@ -1 +1,84 @@
-export {};
+const SCHEDULER_TICK_PREFIX_V1 = 'scheduler:tick:';
+const SCHEDULER_TICK_MAX_ID_LENGTH_V1 = 128;
+const SCHEDULER_TICK_KEYS_V1 = [
+    'schemaVersion',
+    'entity',
+    'action',
+    'companyId',
+    'cloudAccountId',
+    'tenantId',
+    'clientId',
+    'tickId',
+    'scheduledAtUtc',
+    'correlationId',
+];
+const CANONICAL_UTC_TIMESTAMP_MILLISECONDS = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u;
+const isCanonicalUtcTimestampMilliseconds = (value) => {
+    if (typeof value !== 'string' || !CANONICAL_UTC_TIMESTAMP_MILLISECONDS.test(value))
+        return false;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) && new Date(parsed).toISOString() === value;
+};
+const hasExactSchedulerTickKeysV1 = (value) => {
+    const keys = Object.keys(value);
+    return keys.length === SCHEDULER_TICK_KEYS_V1.length && SCHEDULER_TICK_KEYS_V1.every(key => Object.prototype.hasOwnProperty.call(value, key));
+};
+const normalizeSchedulerTickInstantV1 = (scheduledAt) => {
+    if (typeof scheduledAt === 'string') {
+        if (!isCanonicalUtcTimestampMilliseconds(scheduledAt)) {
+            throw new TypeError('Scheduler tick time must be a canonical UTC timestamp with milliseconds');
+        }
+        return scheduledAt;
+    }
+    const milliseconds = scheduledAt instanceof Date ? scheduledAt.getTime() : scheduledAt;
+    if (!Number.isFinite(milliseconds))
+        throw new TypeError('Scheduler tick time must be finite');
+    const normalized = new Date(milliseconds).toISOString();
+    if (!isCanonicalUtcTimestampMilliseconds(normalized)) {
+        throw new TypeError('Scheduler tick time must use a four-digit UTC year');
+    }
+    return normalized;
+};
+/** Creates the deterministic internal queue envelope for one cron occurrence. */
+export const createSchedulerTickRequestMessageV1 = (scheduledAt) => {
+    const scheduledAtUtc = normalizeSchedulerTickInstantV1(scheduledAt);
+    const tickId = `${SCHEDULER_TICK_PREFIX_V1}${scheduledAtUtc}`;
+    return {
+        schemaVersion: 1,
+        entity: 'scheduler',
+        action: 'tick',
+        companyId: '*',
+        cloudAccountId: '*',
+        tenantId: '*',
+        clientId: '*',
+        tickId,
+        scheduledAtUtc,
+        correlationId: tickId,
+    };
+};
+/** Exact validator for the internal scheduler tick queue boundary. */
+export const isSchedulerTickRequestMessageV1 = (value) => {
+    try {
+        if (typeof value !== 'object' || value === null || Array.isArray(value))
+            return false;
+        const candidate = value;
+        if (!hasExactSchedulerTickKeysV1(candidate) || !isCanonicalUtcTimestampMilliseconds(candidate['scheduledAtUtc'])) {
+            return false;
+        }
+        const expectedTickId = `${SCHEDULER_TICK_PREFIX_V1}${candidate['scheduledAtUtc']}`;
+        return (candidate['schemaVersion'] === 1 &&
+            candidate['entity'] === 'scheduler' &&
+            candidate['action'] === 'tick' &&
+            candidate['companyId'] === '*' &&
+            candidate['cloudAccountId'] === '*' &&
+            candidate['tenantId'] === '*' &&
+            candidate['clientId'] === '*' &&
+            typeof candidate['tickId'] === 'string' &&
+            candidate['tickId'].length <= SCHEDULER_TICK_MAX_ID_LENGTH_V1 &&
+            candidate['tickId'] === expectedTickId &&
+            candidate['correlationId'] === expectedTickId);
+    }
+    catch {
+        return false;
+    }
+};