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

package/dist/azure/financialSavingsSurfaceProjection.d.ts

@@ -0,0 +1,146 @@
+import type { ArtifactGeneration } from '../common/artifactGeneration';
+import type { CostBasis, EstimateLens } from './costComposition';
+import type { FinancialBaselinePeriodV2, FinancialChargeInclusionPolicyRefV2 } from './financialScopeBaseline';
+import type { FinancialSavingsUnavailableReasonV1 } from './financialSavingsAuthority';
+export declare const FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1: 1;
+export declare const FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1: "financial-savings-surface-projection/v1";
+export type FinancialSavingsSurfaceV1 = 'recommendations' | 'resources' | 'dashboard';
+export declare const FINANCIAL_SAVINGS_QUERY_SELECTION_CONTRACT_VERSION_V1: "financial-savings-query-selection/v1";
+/**
+ * Non-monetary query membership selected by an authorized transport. The UI
+ * Financial Domain applies this membership to a producer-owned full projection
+ * through the shared Kernel; the API never composes financial totals.
+ */
+export interface FinancialSavingsQuerySelectionV1 {
+    contractVersion: typeof FINANCIAL_SAVINGS_QUERY_SELECTION_CONTRACT_VERSION_V1;
+    filterFingerprint: string;
+    recommendationIds: string[];
+}
+export declare const FINANCIAL_SAVINGS_RESOURCE_QUERY_SELECTION_CONTRACT_VERSION_V1: "financial-savings-resource-query-selection/v1";
+/** Non-monetary canonical allocation membership selected by a resource query. */
+export interface FinancialSavingsResourceQuerySelectionV1 {
+    contractVersion: typeof FINANCIAL_SAVINGS_RESOURCE_QUERY_SELECTION_CONTRACT_VERSION_V1;
+    filterFingerprint: string;
+    allocationIds: string[];
+    recommendationIds: string[];
+}
+export type FinancialSavingsSurfaceScopeV1 = {
+    kind: 'subscription-full';
+} | {
+    kind: 'recommendation-query';
+    filterFingerprint: string;
+    /** Complete matched recommendation set before sorting and pagination. */
+    recommendationIds: string[];
+} | {
+    kind: 'resource-query';
+    filterFingerprint: string;
+    /** Complete canonical allocation set owned by matched resources before pagination. */
+    allocationIds: string[];
+    recommendationIds: string[];
+};
+export interface FinancialSavingsAllocationContributionV1 {
+    allocationId: string;
+    savingsMinorUnits: number;
+    /**
+     * Exact denominator bound to this allocation by the Financial Savings
+     * Authority. Optional only for projections produced before denominator
+     * evidence was added; consumers must withhold percentages when absent.
+     */
+    denominator?: {
+        denominatorId: string;
+        amount: string;
+        currencyCode: string;
+    };
+}
+export interface FinancialSavingsRecommendationContributionV1 {
+    recommendationId: string;
+    allocationIds: [string, ...string[]];
+    savingsMinorUnits: number;
+    /**
+     * Exact allocation amounts retained so resource membership can be composed
+     * without approximation. Optional only for V1 projections produced before
+     * resource-query composition was introduced; resource-query projection
+     * fails closed when this evidence is absent.
+     */
+    allocations?: [FinancialSavingsAllocationContributionV1, ...FinancialSavingsAllocationContributionV1[]];
+}
+/** Producer-computed percentage for one canonical resource owner. */
+export interface FinancialSavingsSurfaceResourceContributionV1 {
+    resourceId: string;
+    allocationIds: [string, ...string[]];
+    savingsMinorUnits: number;
+    denominator: {
+        denominatorIds: [string, ...string[]];
+        amount: string;
+        currencyCode: string;
+    };
+    percentage: number;
+}
+/**
+ * Non-monetary lifecycle membership retained with a full savings surface.
+ * It lets a reader invalidate an immutable projection when a resource-scoped
+ * recommendation changes state without reading or recomputing financial data.
+ */
+export interface FinancialSavingsLifecycleBindingV1 {
+    resourceId: string;
+    recommendationId: string;
+    allocationIds: [string, ...string[]];
+}
+interface FinancialSavingsSurfaceCoordinateCommonV1 {
+    /** Identity of the exact source Financial Authority coordinate. */
+    coordinateId: string;
+    periodRole: 'current' | 'previous';
+    period: FinancialBaselinePeriodV2;
+    costBasis: CostBasis;
+    estimateLens: EstimateLens;
+    /** Exact charge scope inherited from the current Financial Authority baseline. */
+    chargeInclusionPolicyRef: FinancialChargeInclusionPolicyRefV2;
+    requestedCurrencyCode?: string;
+    currentAggregateBaselineId?: string;
+}
+export interface AvailableFinancialSavingsSurfaceCoordinateV1 extends FinancialSavingsSurfaceCoordinateCommonV1 {
+    status: 'available';
+    currentAggregateBaselineId: string;
+    currentAggregate: {
+        amount: string;
+        currencyCode: string;
+    };
+    accountingCurrencyCode: string;
+    minorUnitScale: number;
+    roundingMode: 'half-away-from-zero';
+    recommendationContributions: FinancialSavingsRecommendationContributionV1[];
+    /** Optional only for projections produced before canonical percentages were added. */
+    resourceContributions?: FinancialSavingsSurfaceResourceContributionV1[];
+    aggregate: {
+        allocationIds: string[];
+        savingsMinorUnits: number;
+    };
+}
+/** Proven contributions retained while one or more in-scope scenarios lack target evidence. */
+export interface PartialFinancialSavingsSurfaceCoordinateV1 extends Omit<AvailableFinancialSavingsSurfaceCoordinateV1, 'status'> {
+    status: 'partial';
+    unavailableRecommendationIds: [string, ...string[]];
+}
+export interface UnavailableFinancialSavingsSurfaceCoordinateV1 extends FinancialSavingsSurfaceCoordinateCommonV1 {
+    status: 'unavailable';
+    unavailableReason: FinancialSavingsUnavailableReasonV1;
+}
+export type FinancialSavingsSurfaceCoordinateEnvelopeV1 = AvailableFinancialSavingsSurfaceCoordinateV1 | PartialFinancialSavingsSurfaceCoordinateV1 | UnavailableFinancialSavingsSurfaceCoordinateV1;
+export interface FinancialSavingsSurfaceProjectionV1 {
+    schemaVersion: typeof FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1;
+    contractVersion: typeof FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1;
+    projectionId: string;
+    surface: FinancialSavingsSurfaceV1;
+    scope: FinancialSavingsSurfaceScopeV1;
+    provider: 'azure';
+    providerAccountRefs: [string, ...string[]];
+    artifactGeneration: ArtifactGeneration;
+    financialAuthorityId: string;
+    savingsAuthorityId: string;
+    /** Optional for pre-binding V1 artifacts; readers fail savings closed when required evidence is absent. */
+    lifecycleBindings?: [FinancialSavingsLifecycleBindingV1, ...FinancialSavingsLifecycleBindingV1[]];
+    coordinates: [FinancialSavingsSurfaceCoordinateEnvelopeV1, ...FinancialSavingsSurfaceCoordinateEnvelopeV1[]];
+}
+export type FinancialSavingsSurfaceProjectionIdentityPreimageV1 = Omit<FinancialSavingsSurfaceProjectionV1, 'projectionId'>;
+export {};
+//# sourceMappingURL=financialSavingsSurfaceProjection.d.ts.map

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

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

package/dist/azure/financialSavingsSurfaceProjection.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FINANCIAL_SAVINGS_RESOURCE_QUERY_SELECTION_CONTRACT_VERSION_V1 = exports.FINANCIAL_SAVINGS_QUERY_SELECTION_CONTRACT_VERSION_V1 = exports.FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1 = exports.FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1 = void 0;
+exports.FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1 = 1;
+exports.FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1 = 'financial-savings-surface-projection/v1';
+exports.FINANCIAL_SAVINGS_QUERY_SELECTION_CONTRACT_VERSION_V1 = 'financial-savings-query-selection/v1';
+exports.FINANCIAL_SAVINGS_RESOURCE_QUERY_SELECTION_CONTRACT_VERSION_V1 = 'financial-savings-resource-query-selection/v1';
+//# sourceMappingURL=financialSavingsSurfaceProjection.js.map

package/dist/azure/financialSavingsSurfaceProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"financialSavingsSurfaceProjection.js","sourceRoot":"","sources":["../../src/azure/financialSavingsSurfaceProjection.ts"],"names":[],"mappings":";;;AAKa,QAAA,sDAAsD,GAAG,CAAU,CAAC;AACpE,QAAA,wDAAwD,GAAG,yCAAkD,CAAC;AAI9G,QAAA,qDAAqD,GAAG,sCAA+C,CAAC;AAaxG,QAAA,8DAA8D,GACzE,+CAAwD,CAAC"}

package/dist/azure/financialSavingsSurfaceProjectionKernel.d.ts

@@ -0,0 +1,26 @@
+import type { AzureResourcesView } from './views';
+import type { FinancialAuthorityViewV1 } from './financialAuthorityView';
+import type { FinancialSavingsAuthorityV1 } from './financialSavingsAuthority';
+import type { FinancialChargeInclusionPolicyRefV2 } from './financialScopeBaseline';
+import { type FinancialSavingsSurfaceProjectionV1, type FinancialSavingsSurfaceV1 } from './financialSavingsSurfaceProjection';
+export declare class FinancialSavingsSurfaceProjectionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Private projection input used while a producer still holds the full authority
+ * in memory. Full authorities are deliberately not part of persisted Resources
+ * views; only the bounded surface projection crosses the artifact boundary.
+ */
+export type FinancialSavingsSurfaceProjectionSourceV1 = Pick<AzureResourcesView, 'artifactGeneration'> & {
+    financialAuthority: FinancialAuthorityViewV1;
+    financialSavingsAuthority: FinancialSavingsAuthorityV1;
+};
+export declare const projectFinancialSavingsSurfaceQueryV1: (source: FinancialSavingsSurfaceProjectionV1, recommendationIds: readonly string[], filterFingerprint: string) => FinancialSavingsSurfaceProjectionV1;
+export declare const projectFinancialSavingsSurfaceResourceQueryV1: (source: FinancialSavingsSurfaceProjectionV1, allocationIds: readonly string[], recommendationIds: readonly string[], filterFingerprint: string) => FinancialSavingsSurfaceProjectionV1;
+/**
+ * Projects a validated Resources authority into a compact, immutable surface.
+ * It partitions canonical allocation amounts for display and never recalculates
+ * scenario economics from legacy recommendation or resource fields.
+ */
+export declare const buildFinancialSavingsSurfaceProjectionV1: (resourcesView: FinancialSavingsSurfaceProjectionSourceV1, surface: FinancialSavingsSurfaceV1, chargeInclusionPolicyRef?: FinancialChargeInclusionPolicyRefV2) => FinancialSavingsSurfaceProjectionV1;
+//# sourceMappingURL=financialSavingsSurfaceProjectionKernel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"financialSavingsSurfaceProjectionKernel.d.ts","sourceRoot":"","sources":["../../src/azure/financialSavingsSurfaceProjectionKernel.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAkC,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,EAQL,KAAK,mCAAmC,EAExC,KAAK,yBAAyB,EAC/B,MAAM,qCAAqC,CAAC;AAO7C,qBAAa,sCAAuC,SAAQ,KAAK;gBAC5C,OAAO,EAAE,MAAM;CAInC;AAED;;;;GAIG;AACH,MAAM,MAAM,yCAAyC,GAAG,IAAI,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,GAAG;IACvG,kBAAkB,EAAE,wBAAwB,CAAC;IAC7C,yBAAyB,EAAE,2BAA2B,CAAC;CACxD,CAAC;AAoGF,eAAO,MAAM,qCAAqC,GAChD,QAAQ,mCAAmC,EAC3C,mBAAmB,SAAS,MAAM,EAAE,EACpC,mBAAmB,MAAM,KACxB,mCA2EF,CAAC;AAmDF,eAAO,MAAM,6CAA6C,GACxD,QAAQ,mCAAmC,EAC3C,eAAe,SAAS,MAAM,EAAE,EAChC,mBAAmB,SAAS,MAAM,EAAE,EACpC,mBAAmB,MAAM,KACxB,mCAoGF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wCAAwC,GACnD,eAAe,yCAAyC,EACxD,SAAS,yBAAyB,EAClC,2BAA0B,mCAAkF,KAC3G,mCAiLF,CAAC"}

package/dist/azure/financialSavingsSurfaceProjectionKernel.js

@@ -0,0 +1,435 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFinancialSavingsSurfaceProjectionV1 = exports.projectFinancialSavingsSurfaceResourceQueryV1 = exports.projectFinancialSavingsSurfaceQueryV1 = exports.FinancialSavingsSurfaceProjectionError = void 0;
+const financialChargeComposition_1 = require("./financialChargeComposition");
+const financialChargeCompositionValidation_1 = require("./financialChargeCompositionValidation");
+const exactDecimal_1 = require("../common/exactDecimal");
+const financialSavingsChargePolicyKernel_1 = require("./financialSavingsChargePolicyKernel");
+const financialSavingsSurfaceProjection_1 = require("./financialSavingsSurfaceProjection");
+const financialSavingsPercentageKernel_1 = require("./financialSavingsPercentageKernel");
+const financialSavingsSurfaceProjectionValidation_1 = require("./financialSavingsSurfaceProjectionValidation");
+class FinancialSavingsSurfaceProjectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FinancialSavingsSurfaceProjectionError';
+    }
+}
+exports.FinancialSavingsSurfaceProjectionError = FinancialSavingsSurfaceProjectionError;
+const sameGeneration = (left, right) => Boolean(left && right && left.runId === right.runId && left.generatedAt === right.generatedAt);
+const exactMinorUnitSum = (values) => {
+    const sum = values.reduce((total, value) => total + BigInt(value), 0n);
+    if (sum > BigInt(Number.MAX_SAFE_INTEGER) || sum < BigInt(Number.MIN_SAFE_INTEGER)) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings surface contribution exceeds the safe integer boundary');
+    }
+    return Number(sum);
+};
+const samePolicy = (left, right) => left.policyId === right.policyId && left.policyDigest === right.policyDigest;
+const selectAggregateForPolicy = (financialCoordinate, policyRef, chargeCompositionByBaselineId) => {
+    if (financialCoordinate.aggregateBaseline.status !== 'available')
+        return undefined;
+    if (samePolicy(policyRef, financialChargeComposition_1.AZURE_BILLED_ALL_CHARGES_POLICY_V1.policyRef)) {
+        return financialCoordinate.aggregateBaseline.total.amount;
+    }
+    if (financialCoordinate.aggregateBaseline.baselineKind !== 'aggregate')
+        return undefined;
+    const memberIds = new Set(financialCoordinate.aggregateBaseline.memberBaselineIds);
+    const compositions = [...memberIds]
+        .map(memberId => chargeCompositionByBaselineId.get(memberId))
+        .filter((composition) => composition !== undefined);
+    if (compositions.length !== memberIds.size)
+        return undefined;
+    const selections = compositions.map(composition => (0, financialChargeCompositionValidation_1.selectFinancialChargesV1)(composition, policyRef));
+    if (selections.some(selection => selection.status !== 'available'))
+        return undefined;
+    return (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(selections.map(selection => selection.includedAmount)));
+};
+const projectLifecycleBindings = (allocations) => {
+    const byLifecycleIdentity = new Map();
+    for (const allocation of allocations) {
+        const key = `${allocation.ownerScopeId}\u0000${allocation.recommendationId}`;
+        const existing = byLifecycleIdentity.get(key);
+        if (existing) {
+            existing.allocationIds.push(allocation.allocationId);
+            continue;
+        }
+        byLifecycleIdentity.set(key, {
+            resourceId: allocation.ownerScopeId,
+            recommendationId: allocation.recommendationId,
+            allocationIds: [allocation.allocationId],
+        });
+    }
+    return [...byLifecycleIdentity.values()]
+        .map(binding => ({ ...binding, allocationIds: [...binding.allocationIds].sort() }))
+        .sort((left, right) => left.resourceId.localeCompare(right.resourceId) || left.recommendationId.localeCompare(right.recommendationId));
+};
+const projectResourceContributions = (recommendationContributions, lifecycleBindings, minorUnitScale) => {
+    if (!lifecycleBindings?.length)
+        return undefined;
+    const allocationById = new Map(recommendationContributions.flatMap(contribution => contribution.allocations ?? []).map(allocation => [allocation.allocationId, allocation]));
+    const allocationIdsByResource = new Map();
+    for (const binding of lifecycleBindings) {
+        const allocationIds = allocationIdsByResource.get(binding.resourceId) ?? new Set();
+        binding.allocationIds.forEach(allocationId => allocationIds.add(allocationId));
+        allocationIdsByResource.set(binding.resourceId, allocationIds);
+    }
+    const contributions = [];
+    for (const [resourceId, allocationIds] of allocationIdsByResource) {
+        const allocations = [...allocationIds].map(allocationId => allocationById.get(allocationId));
+        if (allocations.some(allocation => allocation === undefined))
+            return undefined;
+        const exactAllocations = allocations;
+        const composed = (0, financialSavingsPercentageKernel_1.composeFinancialSavingsAllocationPercentageV1)(exactAllocations, minorUnitScale);
+        if (!composed)
+            return undefined;
+        contributions.push({
+            resourceId,
+            allocationIds: [...allocationIds].sort(),
+            savingsMinorUnits: exactMinorUnitSum(exactAllocations.map(allocation => allocation.savingsMinorUnits)),
+            denominator: {
+                denominatorIds: composed.denominatorIds,
+                amount: composed.denominatorAmount,
+                currencyCode: composed.denominatorCurrencyCode,
+            },
+            percentage: composed.percentage,
+        });
+    }
+    return contributions.sort((left, right) => left.resourceId.localeCompare(right.resourceId));
+};
+const projectFinancialSavingsSurfaceQueryV1 = (source, recommendationIds, filterFingerprint) => {
+    if (!(0, financialSavingsSurfaceProjectionValidation_1.isFinancialSavingsSurfaceProjectionV1)(source) || source.surface !== 'recommendations') {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings source projection is invalid for recommendation filtering');
+    }
+    const uniqueRecommendationIds = [...new Set(recommendationIds)];
+    if (uniqueRecommendationIds.length !== recommendationIds.length ||
+        uniqueRecommendationIds.some(id => !id.trim()) ||
+        !filterFingerprint.trim()) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings query identity is invalid');
+    }
+    const scope = {
+        kind: 'recommendation-query',
+        filterFingerprint,
+        recommendationIds: uniqueRecommendationIds,
+    };
+    const includedRecommendationIds = new Set(uniqueRecommendationIds);
+    const lifecycleBindings = source.lifecycleBindings
+        ?.filter(binding => includedRecommendationIds.has(binding.recommendationId))
+        .map(binding => ({ ...binding, allocationIds: [...binding.allocationIds] }));
+    const coordinates = source.coordinates.map((coordinate) => {
+        if (coordinate.status === 'unavailable')
+            return coordinate;
+        const recommendationContributions = coordinate.recommendationContributions.filter(contribution => includedRecommendationIds.has(contribution.recommendationId));
+        const resourceContributions = projectResourceContributions(recommendationContributions, lifecycleBindings, coordinate.minorUnitScale);
+        const filteredAmounts = {
+            recommendationContributions,
+            ...(resourceContributions?.length ? { resourceContributions } : {}),
+            aggregate: {
+                allocationIds: recommendationContributions.flatMap(contribution => contribution.allocationIds),
+                savingsMinorUnits: exactMinorUnitSum(recommendationContributions.map(contribution => contribution.savingsMinorUnits)),
+            },
+        };
+        if (coordinate.status === 'available')
+            return { ...coordinate, ...filteredAmounts };
+        const { unavailableRecommendationIds: _sourceUnavailableRecommendationIds, ...common } = coordinate;
+        void _sourceUnavailableRecommendationIds;
+        const unavailableRecommendationIds = coordinate.unavailableRecommendationIds.filter(recommendationId => includedRecommendationIds.has(recommendationId));
+        return unavailableRecommendationIds.length > 0
+            ? {
+                ...common,
+                ...filteredAmounts,
+                status: 'partial',
+                unavailableRecommendationIds: unavailableRecommendationIds,
+            }
+            : { ...common, ...filteredAmounts, status: 'available' };
+    });
+    const identity = {
+        schemaVersion: source.schemaVersion,
+        contractVersion: source.contractVersion,
+        surface: source.surface,
+        scope,
+        provider: source.provider,
+        providerAccountRefs: source.providerAccountRefs,
+        artifactGeneration: source.artifactGeneration,
+        financialAuthorityId: source.financialAuthorityId,
+        savingsAuthorityId: source.savingsAuthorityId,
+        ...(lifecycleBindings?.length ? { lifecycleBindings: lifecycleBindings } : {}),
+        coordinates,
+    };
+    const projection = {
+        ...identity,
+        projectionId: (0, financialSavingsSurfaceProjectionValidation_1.createFinancialSavingsSurfaceProjectionIdV1)(identity),
+    };
+    if (!(0, financialSavingsSurfaceProjectionValidation_1.isFinancialSavingsSurfaceProjectionV1)(projection)) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings query projection failed validation');
+    }
+    return projection;
+};
+exports.projectFinancialSavingsSurfaceQueryV1 = projectFinancialSavingsSurfaceQueryV1;
+const projectRecommendationContributions = (allocations) => {
+    const byRecommendation = new Map();
+    for (const allocation of allocations) {
+        const existing = byRecommendation.get(allocation.recommendationId) ?? {
+            allocationIds: [],
+            savingsMinorUnits: [],
+            allocations: [],
+        };
+        existing.allocationIds.push(allocation.allocationId);
+        existing.savingsMinorUnits.push(allocation.savingsMinorUnits);
+        existing.allocations.push({
+            allocationId: allocation.allocationId,
+            savingsMinorUnits: allocation.savingsMinorUnits,
+            ...(allocation.denominator ? { denominator: allocation.denominator } : {}),
+        });
+        byRecommendation.set(allocation.recommendationId, existing);
+    }
+    return Array.from(byRecommendation.entries())
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([recommendationId, contribution]) => ({
+        recommendationId,
+        allocationIds: [...contribution.allocationIds].sort(),
+        savingsMinorUnits: exactMinorUnitSum(contribution.savingsMinorUnits),
+        allocations: contribution.allocations
+            .sort((left, right) => left.allocationId.localeCompare(right.allocationId)),
+    }));
+};
+const projectFinancialSavingsSurfaceResourceQueryV1 = (source, allocationIds, recommendationIds, filterFingerprint) => {
+    if (!(0, financialSavingsSurfaceProjectionValidation_1.isFinancialSavingsSurfaceProjectionV1)(source) || source.surface !== 'resources') {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings source projection is invalid for resource filtering');
+    }
+    const uniqueAllocationIds = [...new Set(allocationIds)];
+    const uniqueRecommendationIds = [...new Set(recommendationIds)];
+    if (uniqueAllocationIds.length !== allocationIds.length ||
+        uniqueRecommendationIds.length !== recommendationIds.length ||
+        uniqueAllocationIds.some(id => !id.trim()) ||
+        uniqueRecommendationIds.some(id => !id.trim()) ||
+        !filterFingerprint.trim()) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings resource query identity is invalid');
+    }
+    const includedAllocationIds = new Set(uniqueAllocationIds);
+    const includedRecommendationIds = new Set(uniqueRecommendationIds);
+    const lifecycleBindings = source.lifecycleBindings
+        ?.map(binding => {
+        const filteredAllocationIds = binding.allocationIds.filter(allocationId => includedAllocationIds.has(allocationId));
+        return filteredAllocationIds.length
+            ? {
+                ...binding,
+                allocationIds: filteredAllocationIds,
+            }
+            : undefined;
+    })
+        .filter((binding) => binding !== undefined);
+    const scope = {
+        kind: 'resource-query',
+        filterFingerprint,
+        allocationIds: uniqueAllocationIds,
+        recommendationIds: uniqueRecommendationIds,
+    };
+    const coordinates = source.coordinates.map((coordinate) => {
+        if (coordinate.status === 'unavailable')
+            return coordinate;
+        const recommendationContributions = coordinate.recommendationContributions
+            .map(contribution => {
+            if (contribution.allocations === undefined) {
+                throw new FinancialSavingsSurfaceProjectionError('Financial savings resource query requires exact allocation contribution evidence');
+            }
+            const allocations = contribution.allocations.filter(allocation => includedAllocationIds.has(allocation.allocationId));
+            if (allocations.length === 0)
+                return undefined;
+            return {
+                recommendationId: contribution.recommendationId,
+                allocationIds: allocations.map(allocation => allocation.allocationId),
+                allocations: allocations,
+                savingsMinorUnits: exactMinorUnitSum(allocations.map(allocation => allocation.savingsMinorUnits)),
+            };
+        })
+            .filter((contribution) => contribution !== undefined);
+        const resourceContributions = projectResourceContributions(recommendationContributions, lifecycleBindings, coordinate.minorUnitScale);
+        const filteredAmounts = {
+            recommendationContributions,
+            ...(resourceContributions?.length ? { resourceContributions } : {}),
+            aggregate: {
+                allocationIds: recommendationContributions.flatMap(contribution => contribution.allocationIds),
+                savingsMinorUnits: exactMinorUnitSum(recommendationContributions.map(contribution => contribution.savingsMinorUnits)),
+            },
+        };
+        if (coordinate.status === 'available')
+            return { ...coordinate, ...filteredAmounts };
+        const { unavailableRecommendationIds: _sourceUnavailableRecommendationIds, ...common } = coordinate;
+        void _sourceUnavailableRecommendationIds;
+        const unavailableRecommendationIds = coordinate.unavailableRecommendationIds.filter(id => includedRecommendationIds.has(id));
+        return unavailableRecommendationIds.length > 0
+            ? {
+                ...common,
+                ...filteredAmounts,
+                status: 'partial',
+                unavailableRecommendationIds: unavailableRecommendationIds,
+            }
+            : { ...common, ...filteredAmounts, status: 'available' };
+    });
+    const identity = {
+        schemaVersion: source.schemaVersion,
+        contractVersion: source.contractVersion,
+        surface: source.surface,
+        scope,
+        provider: source.provider,
+        providerAccountRefs: source.providerAccountRefs,
+        artifactGeneration: source.artifactGeneration,
+        financialAuthorityId: source.financialAuthorityId,
+        savingsAuthorityId: source.savingsAuthorityId,
+        ...(lifecycleBindings?.length ? { lifecycleBindings: lifecycleBindings } : {}),
+        coordinates,
+    };
+    const projection = { ...identity, projectionId: (0, financialSavingsSurfaceProjectionValidation_1.createFinancialSavingsSurfaceProjectionIdV1)(identity) };
+    if (!(0, financialSavingsSurfaceProjectionValidation_1.isFinancialSavingsSurfaceProjectionV1)(projection)) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings resource query projection failed validation');
+    }
+    return projection;
+};
+exports.projectFinancialSavingsSurfaceResourceQueryV1 = projectFinancialSavingsSurfaceResourceQueryV1;
+/**
+ * Projects a validated Resources authority into a compact, immutable surface.
+ * It partitions canonical allocation amounts for display and never recalculates
+ * scenario economics from legacy recommendation or resource fields.
+ */
+const buildFinancialSavingsSurfaceProjectionV1 = (resourcesView, surface, chargeInclusionPolicyRef = financialChargeComposition_1.AZURE_BILLED_ALL_CHARGES_POLICY_V1.policyRef) => {
+    const authority = resourcesView.financialAuthority;
+    const savingsAuthority = resourcesView.financialSavingsAuthority;
+    if (authority.authorityId !== savingsAuthority.financialAuthorityId ||
+        !sameGeneration(resourcesView.artifactGeneration, authority.artifactGeneration) ||
+        !sameGeneration(authority.artifactGeneration, savingsAuthority.artifactGeneration)) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings authority generation or identity binding is invalid');
+    }
+    if (!(0, financialChargeComposition_1.resolveFinancialChargeInclusionPolicyV1)(chargeInclusionPolicyRef)) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings charge-inclusion policy is not registered');
+    }
+    const financialCoordinateById = new Map(authority.coordinates.map(coordinate => [coordinate.coordinateId, coordinate]));
+    const savingsCoordinateById = new Map(savingsAuthority.coordinates.map(coordinate => [coordinate.coordinateId, coordinate]));
+    const eligibilityById = new Map(savingsAuthority.eligibilityAssessments.map(assessment => [assessment.eligibilityId, assessment]));
+    if (financialCoordinateById.size !== authority.coordinates.length ||
+        savingsCoordinateById.size !== savingsAuthority.coordinates.length ||
+        financialCoordinateById.size !== savingsCoordinateById.size ||
+        Array.from(financialCoordinateById.keys()).some(coordinateId => !savingsCoordinateById.has(coordinateId))) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings coordinates are not one-to-one with financial authority coordinates');
+    }
+    const projectedAllocations = [];
+    const coordinates = authority.coordinates.map((financialCoordinate) => {
+        const savingsCoordinate = savingsCoordinateById.get(financialCoordinate.coordinateId);
+        if (!savingsCoordinate) {
+            throw new FinancialSavingsSurfaceProjectionError(`Financial savings coordinate ${financialCoordinate.coordinateId} is missing`);
+        }
+        const common = {
+            coordinateId: financialCoordinate.coordinateId,
+            periodRole: financialCoordinate.periodRole,
+            period: financialCoordinate.period,
+            costBasis: financialCoordinate.costBasis,
+            estimateLens: financialCoordinate.estimateLens,
+            chargeInclusionPolicyRef,
+            ...(financialCoordinate.requestedCurrencyCode === undefined
+                ? {}
+                : { requestedCurrencyCode: financialCoordinate.requestedCurrencyCode }),
+            ...(savingsCoordinate.currentAggregateBaselineId === undefined
+                ? {}
+                : { currentAggregateBaselineId: savingsCoordinate.currentAggregateBaselineId }),
+        };
+        if (savingsCoordinate.status === 'unavailable') {
+            return { ...common, status: 'unavailable', unavailableReason: savingsCoordinate.unavailableReason };
+        }
+        const currentAggregate = financialCoordinate.aggregateBaseline;
+        const chargeCompositions = financialCoordinate.chargeCompositions ?? [];
+        const chargeCompositionByBaselineId = new Map(chargeCompositions.map(composition => [composition.baselineId, composition]));
+        const selectedCurrentAggregate = chargeCompositionByBaselineId.size === chargeCompositions.length
+            ? selectAggregateForPolicy(financialCoordinate, chargeInclusionPolicyRef, chargeCompositionByBaselineId)
+            : undefined;
+        if (currentAggregate.status !== 'available' ||
+            currentAggregate.baselineId !== savingsCoordinate.currentAggregateBaselineId ||
+            currentAggregate.total.currencyCode !== savingsCoordinate.accountingCurrencyCode ||
+            selectedCurrentAggregate === undefined) {
+            return { ...common, status: 'unavailable', unavailableReason: 'allocation-unavailable' };
+        }
+        const sourceUnavailableRecommendationIds = savingsCoordinate.status === 'partial'
+            ? Array.from(new Set(savingsCoordinate.activations
+                .filter(activation => activation.result === 'unavailable')
+                .map(activation => activation.recommendationId))).sort()
+            : [];
+        const policyUnavailableRecommendationIds = new Set();
+        const selectedAllocations = samePolicy(chargeInclusionPolicyRef, financialChargeComposition_1.AZURE_BILLED_ALL_CHARGES_POLICY_V1.policyRef)
+            ? savingsCoordinate.allocations
+            : savingsCoordinate.allocations.filter(allocation => {
+                const disposition = (0, financialSavingsChargePolicyKernel_1.classifyFinancialSavingsAllocationForPolicyV1)(chargeCompositionByBaselineId, allocation, chargeInclusionPolicyRef);
+                if (disposition === 'unavailable')
+                    policyUnavailableRecommendationIds.add(allocation.recommendationId);
+                return disposition === 'included';
+            });
+        const projectionById = new Map(financialCoordinate.projections.map(projection => [projection.projectionId, projection]));
+        const selectedAllocationsWithDenominators = selectedAllocations.map(allocation => {
+            const mappedEligibility = allocation.eligibility?.kind === 'mapped' ? eligibilityById.get(allocation.eligibility.eligibilityId) : undefined;
+            const financialProjection = projectionById.get(allocation.projectionId);
+            const denominator = mappedEligibility?.status === 'available'
+                ? {
+                    denominatorId: mappedEligibility.denominator.denominatorId,
+                    amount: mappedEligibility.denominator.amount,
+                    currencyCode: mappedEligibility.denominator.currencyCode,
+                }
+                : allocation.eligibility?.kind === 'not-applicable' && financialProjection?.status === 'available'
+                    ? {
+                        denominatorId: allocation.denominatorId,
+                        amount: financialProjection.current.affected,
+                        currencyCode: financialProjection.accountingCurrencyCode,
+                    }
+                    : undefined;
+            return { ...allocation, ...(denominator ? { denominator } : {}) };
+        });
+        projectedAllocations.push(...selectedAllocationsWithDenominators);
+        const unavailableRecommendationIds = [
+            ...new Set([...sourceUnavailableRecommendationIds, ...policyUnavailableRecommendationIds]),
+        ].sort();
+        const recommendationContributions = projectRecommendationContributions(selectedAllocationsWithDenominators);
+        const resourceContributions = projectResourceContributions(recommendationContributions, projectLifecycleBindings(selectedAllocationsWithDenominators), savingsCoordinate.minorUnitScale);
+        const composed = {
+            ...common,
+            currentAggregateBaselineId: savingsCoordinate.currentAggregateBaselineId,
+            currentAggregate: { amount: selectedCurrentAggregate, currencyCode: currentAggregate.total.currencyCode },
+            accountingCurrencyCode: savingsCoordinate.accountingCurrencyCode,
+            minorUnitScale: savingsCoordinate.minorUnitScale,
+            roundingMode: savingsCoordinate.roundingMode,
+            recommendationContributions,
+            ...(resourceContributions?.length ? { resourceContributions } : {}),
+            aggregate: {
+                allocationIds: recommendationContributions.flatMap(contribution => contribution.allocationIds),
+                savingsMinorUnits: exactMinorUnitSum(recommendationContributions.map(contribution => contribution.savingsMinorUnits)),
+            },
+        };
+        return unavailableRecommendationIds.length > 0
+            ? {
+                ...composed,
+                status: 'partial',
+                unavailableRecommendationIds: unavailableRecommendationIds,
+            }
+            : { ...composed, status: 'available' };
+    });
+    const lifecycleBindings = projectLifecycleBindings(projectedAllocations);
+    const identity = {
+        schemaVersion: financialSavingsSurfaceProjection_1.FINANCIAL_SAVINGS_SURFACE_PROJECTION_SCHEMA_VERSION_V1,
+        contractVersion: financialSavingsSurfaceProjection_1.FINANCIAL_SAVINGS_SURFACE_PROJECTION_CONTRACT_VERSION_V1,
+        surface,
+        scope: { kind: 'subscription-full' },
+        provider: 'azure',
+        providerAccountRefs: [...authority.providerAccountRefs],
+        artifactGeneration: { ...authority.artifactGeneration },
+        financialAuthorityId: authority.authorityId,
+        savingsAuthorityId: savingsAuthority.savingsAuthorityId,
+        ...(lifecycleBindings.length
+            ? { lifecycleBindings: lifecycleBindings }
+            : {}),
+        coordinates,
+    };
+    const projection = {
+        ...identity,
+        projectionId: (0, financialSavingsSurfaceProjectionValidation_1.createFinancialSavingsSurfaceProjectionIdV1)(identity),
+    };
+    if (!(0, financialSavingsSurfaceProjectionValidation_1.isFinancialSavingsSurfaceProjectionV1)(projection)) {
+        throw new FinancialSavingsSurfaceProjectionError('Financial savings surface projection failed validation');
+    }
+    return projection;
+};
+exports.buildFinancialSavingsSurfaceProjectionV1 = buildFinancialSavingsSurfaceProjectionV1;
+//# sourceMappingURL=financialSavingsSurfaceProjectionKernel.js.map