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

package/dist/azure/financialChargeComposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"financialChargeComposition.js","sourceRoot":"","sources":["../../src/azure/financialChargeComposition.ts"],"names":[],"mappings":";;;AAAA,6CAA8C;AAIjC,QAAA,8CAA8C,GAAG,CAAU,CAAC;AAC5D,QAAA,gDAAgD,GAAG,iCAA0C,CAAC;AAC9F,QAAA,qDAAqD,GAAG,sCAA+C,CAAC;AAgBrH,MAAM,sBAAsB,GAAG,CAAC,UAA4B,EAAoC,EAAE;IAChG,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,UAAU,CAAC;IAC3C,MAAM,UAAU,GAAG;QACjB,GAAG,MAAM;QACT,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;QACzD,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;QACzD,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3D,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,IAAA,mBAAU,EAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC;KACzG,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC,CAAC;AAEW,QAAA,kCAAkC,GAAG,sBAAsB,CAAC;IACvE,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,6DAAqD;IACtE,QAAQ,EAAE,6BAA6B;IACvC,cAAc,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,SAAS,CAAC;IAC1D,cAAc,EAAE,EAAE;IAClB,eAAe,EAAE,EAAE;CACpB,CAAC,CAAC;AAEU,QAAA,oDAAoD,GAAG,sBAAsB,CAAC;IACzF,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,6DAAqD;IACtE,QAAQ,EAAE,+CAA+C;IACzD,cAAc,EAAE,CAAC,cAAc,CAAC;IAChC,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,eAAe,EAAE,CAAC,SAAS,CAAC;CAC7B,CAAC,CAAC;AAEU,QAAA,sCAAsC,GAAG,MAAM,CAAC,MAAM,CAAC;IAClE,0CAAkC;IAClC,4DAAoD;CAC5C,CAAC,CAAC;AAEL,MAAM,uCAAuC,GAAG,CACrD,SAA8C,EACA,EAAE,CAChD,SAAS,KAAK,IAAI,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,8CAAsC,CAAC,IAAI,CAChG,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,YAAY,KAAK,SAAS,CAAC,YAAY,CACvH,IAAI,SAAS,CAAC;AALJ,QAAA,uCAAuC,2CAKnC"}

package/dist/azure/financialChargeCompositionKernel.d.ts

@@ -0,0 +1,3 @@
+import { type CreateFinancialChargeCompositionRequestV1, type FinancialChargeCompositionV1 } from './financialChargeComposition';
+export declare const createFinancialChargeCompositionV1: (request: CreateFinancialChargeCompositionRequestV1) => FinancialChargeCompositionV1;
+//# sourceMappingURL=financialChargeCompositionKernel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"financialChargeCompositionKernel.d.ts","sourceRoot":"","sources":["../../src/azure/financialChargeCompositionKernel.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,yCAAyC,EAG9C,KAAK,4BAA4B,EAElC,MAAM,8BAA8B,CAAC;AAMtC,eAAO,MAAM,kCAAkC,GAC7C,SAAS,yCAAyC,KACjD,4BA4CF,CAAC"}

package/dist/azure/financialChargeCompositionKernel.js

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

package/dist/azure/financialChargeCompositionKernel.js.map

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

package/dist/azure/financialChargeCompositionValidation.d.ts

@@ -0,0 +1,8 @@
+import { type FinancialChargeCompositionIdentityPreimageV1, type FinancialChargeCompositionV1, type FinancialChargeSelectionV1 } from './financialChargeComposition';
+import type { FinancialChargeInclusionPolicyRefV2 } from './financialScopeBaseline';
+export declare const canonicalizeFinancialChargeCompositionIdentityV1: (value: FinancialChargeCompositionIdentityPreimageV1) => string;
+export declare const createFinancialChargeCompositionIdV1: (value: FinancialChargeCompositionIdentityPreimageV1) => string;
+export declare const isFinancialChargeCompositionV1: (value: unknown) => value is FinancialChargeCompositionV1;
+export declare const isFinancialChargeInclusionPolicyRefV1: (value: unknown) => value is FinancialChargeInclusionPolicyRefV2;
+export declare const selectFinancialChargesV1: (composition: FinancialChargeCompositionV1, policyRef: FinancialChargeInclusionPolicyRefV2) => FinancialChargeSelectionV1;
+//# sourceMappingURL=financialChargeCompositionValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"financialChargeCompositionValidation.d.ts","sourceRoot":"","sources":["../../src/azure/financialChargeCompositionValidation.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,4CAA4C,EACjD,KAAK,4BAA4B,EAEjC,KAAK,0BAA0B,EAChC,MAAM,8BAA8B,CAAC;AAYtC,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,0BAA0B,CAAC;AA6EpF,eAAO,MAAM,gDAAgD,GAC3D,OAAO,4CAA4C,KAClD,MAKF,CAAC;AAEF,eAAO,MAAM,oCAAoC,GAAI,OAAO,4CAA4C,KAAG,MAC1B,CAAC;AAElF,eAAO,MAAM,8BAA8B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,4BAsBxE,CAAC;AAEF,eAAO,MAAM,qCAAqC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,mCAKgC,CAAC;AAQjH,eAAO,MAAM,wBAAwB,GACnC,aAAa,4BAA4B,EACzC,WAAW,mCAAmC,KAC7C,0BAsCF,CAAC"}

package/dist/azure/financialChargeCompositionValidation.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectFinancialChargesV1 = exports.isFinancialChargeInclusionPolicyRefV1 = exports.isFinancialChargeCompositionV1 = exports.createFinancialChargeCompositionIdV1 = exports.canonicalizeFinancialChargeCompositionIdentityV1 = void 0;
+const exactDecimal_1 = require("../common/exactDecimal");
+const sha256_1 = require("../common/sha256");
+const financialChargeComposition_1 = require("./financialChargeComposition");
+const financialDataflowValidation_1 = require("./financialDataflowValidation");
+const financialScopeBaselineValidation_1 = require("./financialScopeBaselineValidation");
+const financialValidationPrimitives_1 = require("./financialValidationPrimitives");
+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(financialDataflowValidation_1.isFinancialDataflowHashV1) &&
+    value.every((entry, index) => index === 0 || value[index - 1] < entry);
+const isBucket = (value) => (0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value) &&
+    (0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value, [
+        'chargeSource',
+        'chargeRecurrence',
+        'chargeClassification',
+        'amount',
+        'componentIds',
+        'evidenceRefIds',
+    ]) &&
+    SOURCES.has(value.chargeSource) &&
+    RECURRENCES.has(value.chargeRecurrence) &&
+    CLASSIFICATIONS.has(value.chargeClassification) &&
+    (0, financialValidationPrimitives_1.isCanonicalExactMoney)({ amount: value.amount, currencyCode: 'AUD' }) &&
+    isSortedUniqueHashes(value.componentIds) &&
+    isSortedUniqueHashes(value.evidenceRefIds);
+const isIdentity = (value) => {
+    if (!(0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value) ||
+        !(0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value, [
+            'schemaVersion',
+            'contractVersion',
+            'baselineId',
+            'ownerScopeId',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'accountingCurrencyCode',
+            'buckets',
+            'reconciliation',
+            'algorithmVersion',
+        ]) ||
+        value.schemaVersion !== financialChargeComposition_1.FINANCIAL_CHARGE_COMPOSITION_SCHEMA_VERSION_V1 ||
+        value.contractVersion !== financialChargeComposition_1.FINANCIAL_CHARGE_COMPOSITION_CONTRACT_VERSION_V1 ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowHashV1)(value.baselineId) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowIdentityV1)(value.ownerScopeId) ||
+        !(0, financialScopeBaselineValidation_1.isFinancialBaselinePeriodV2)(value.period) ||
+        !COST_BASES.has(value.costBasis) ||
+        !ESTIMATE_LENSES.has(value.estimateLens) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowCurrencyV1)(value.accountingCurrencyCode) ||
+        !Array.isArray(value.buckets) ||
+        value.buckets.length === 0 ||
+        value.buckets.length > 20000 ||
+        !value.buckets.every(isBucket) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowIdentityV1)(value.algorithmVersion) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value.reconciliation) ||
+        !(0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value.reconciliation, ['status', 'bucketTotal', 'sourceTotal', 'difference']) ||
+        value.reconciliation.status !== 'reconciled' ||
+        value.reconciliation.difference !== '0' ||
+        !(0, financialValidationPrimitives_1.isCanonicalExactMoney)({ amount: value.reconciliation.bucketTotal, currencyCode: value.accountingCurrencyCode }) ||
+        !(0, financialValidationPrimitives_1.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 = (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(value.buckets.map(bucket => bucket.amount)));
+        return bucketTotal === value.reconciliation.bucketTotal && bucketTotal === value.reconciliation.sourceTotal;
+    }
+    catch {
+        return false;
+    }
+};
+const canonicalizeFinancialChargeCompositionIdentityV1 = (value) => {
+    if (!(0, financialDataflowValidation_1.isFinancialDataflowValueWithinLimitsV1)(value) || !isIdentity(value)) {
+        throw new TypeError('Invalid FinancialChargeCompositionIdentityPreimageV1.');
+    }
+    return (0, financialDataflowValidation_1.canonicalizeFinancialDataflowJsonV1)(value);
+};
+exports.canonicalizeFinancialChargeCompositionIdentityV1 = canonicalizeFinancialChargeCompositionIdentityV1;
+const createFinancialChargeCompositionIdV1 = (value) => `sha256:${(0, sha256_1.sha256Utf8)((0, exports.canonicalizeFinancialChargeCompositionIdentityV1)(value))}`;
+exports.createFinancialChargeCompositionIdV1 = createFinancialChargeCompositionIdV1;
+const isFinancialChargeCompositionV1 = (value) => {
+    if (!(0, financialDataflowValidation_1.isFinancialDataflowValueWithinLimitsV1)(value) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value) ||
+        !(0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value, [
+            'chargeCompositionId',
+            'schemaVersion',
+            'contractVersion',
+            'baselineId',
+            'ownerScopeId',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'accountingCurrencyCode',
+            'buckets',
+            'reconciliation',
+            'algorithmVersion',
+        ]))
+        return false;
+    const { chargeCompositionId, ...identity } = value;
+    return (0, financialDataflowValidation_1.isFinancialDataflowHashV1)(chargeCompositionId) && isIdentity(identity) &&
+        chargeCompositionId === (0, exports.createFinancialChargeCompositionIdV1)(identity);
+};
+exports.isFinancialChargeCompositionV1 = isFinancialChargeCompositionV1;
+const isFinancialChargeInclusionPolicyRefV1 = (value) => (0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value) &&
+    (0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value, ['policyId', 'policyDigest']) &&
+    (0, financialDataflowValidation_1.isFinancialDataflowIdentityV1)(value.policyId) &&
+    (0, financialDataflowValidation_1.isFinancialDataflowHashV1)(value.policyDigest) &&
+    (0, financialChargeComposition_1.resolveFinancialChargeInclusionPolicyV1)(value) !== undefined;
+exports.isFinancialChargeInclusionPolicyRefV1 = isFinancialChargeInclusionPolicyRefV1;
+const sumBuckets = (buckets) => (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(buckets.map(bucket => bucket.amount)));
+const sourcesFor = (policy, role) => role === 'include' ? policy.includeSources : role === 'exclude' ? policy.excludeSources : policy.withholdSources;
+const selectFinancialChargesV1 = (composition, policyRef) => {
+    if (!(0, exports.isFinancialChargeCompositionV1)(composition))
+        throw new TypeError('Invalid financial charge composition.');
+    const policy = (0, financialChargeComposition_1.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;
+};
+exports.selectFinancialChargesV1 = selectFinancialChargesV1;
+//# sourceMappingURL=financialChargeCompositionValidation.js.map

package/dist/azure/financialChargeCompositionValidation.js.map

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

package/dist/azure/financialChargePolicy.d.ts

@@ -0,0 +1,215 @@
+import type { CostBasis } from './costComposition.js';
+import type { MoneyUnavailableReason } from './costComposition.js';
+import type { SavingsAggregateV2 } from './savings.js';
+export declare const AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_REF_V1: "azure-cloud-services-excluding-marketplace/v1";
+export type AzureFinancialChargePolicyRefV1 = typeof AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_REF_V1;
+export type AzureFinancialChargeSourceV1 = 'azure-native' | 'marketplace' | 'unknown';
+export type AzureFinancialChargeSourceUnknownReasonV1 = 'publisher-type-missing' | 'publisher-type-unsupported' | 'publisher-type-unrecognized';
+/** One rolling-spend basis split by billing-backed and estimated provenance. */
+export type AzureFinancialChargeSpendBasisTotalsV1 = {
+    status: 'available';
+    totalMinorUnits: number;
+    billingBackedMinorUnits: number;
+    estimatedMinorUnits: number;
+} | {
+    status: 'unavailable';
+    reasonCode: MoneyUnavailableReason;
+};
+/** Billed and amortized projections for one financial charge source. */
+export interface AzureFinancialChargeSpendSourceTotalsV1 {
+    billed: AzureFinancialChargeSpendBasisTotalsV1;
+    amortized: AzureFinancialChargeSpendBasisTotalsV1;
+}
+/** Subject whose rolling spend is represented by the breakdown. */
+export type AzureFinancialChargeSpendSubjectV1 = {
+    kind: 'provider-scope';
+    providerScopeId: string;
+} | {
+    kind: 'resource';
+    providerScopeId: string;
+    resourceId: string;
+};
+/** Evidence that keeps material unknown rows distinct from their signed net. */
+export interface AzureFinancialChargeUnknownMaterialV1 {
+    nonZeroRowCount: number;
+    billedAbsoluteMinorUnits: number;
+    amortizedAbsoluteMinorUnits: number;
+}
+/**
+ * Rolling resource-page spend partition. This deliberately remains separate from
+ * the fixed formal-report coordinate because its period follows the page's
+ * rolling cost window.
+ */
+export interface AzureFinancialChargeSpendBreakdownV1<TSubject extends AzureFinancialChargeSpendSubjectV1 = AzureFinancialChargeSpendSubjectV1> {
+    contractVersion: 'financial-charge-spend/v1';
+    policyRef: AzureFinancialChargePolicyRefV1;
+    generationId: string;
+    subject: TSubject;
+    period: {
+        startDate: string;
+        endDateExclusive: string;
+    };
+    currencyCode: string;
+    minorUnitScale: number;
+    status: 'complete' | 'partial';
+    allCharge: AzureFinancialChargeSpendSourceTotalsV1;
+    azureNative: AzureFinancialChargeSpendSourceTotalsV1;
+    marketplace: AzureFinancialChargeSpendSourceTotalsV1;
+    unknown: AzureFinancialChargeSpendSourceTotalsV1;
+    unknownMaterial: AzureFinancialChargeUnknownMaterialV1;
+}
+export type AzureProviderScopeFinancialChargeSpendBreakdownV1 = AzureFinancialChargeSpendBreakdownV1<Extract<AzureFinancialChargeSpendSubjectV1, {
+    kind: 'provider-scope';
+}>>;
+export type AzureResourceFinancialChargeSpendBreakdownV1 = AzureFinancialChargeSpendBreakdownV1<Extract<AzureFinancialChargeSpendSubjectV1, {
+    kind: 'resource';
+}>>;
+/** Publisher evidence retained from the provider billing source before financial classification. */
+export type AzurePublisherTypeEvidenceV1 = {
+    status: 'available';
+    publisherType: string;
+    publisherName?: string;
+} | {
+    status: 'unavailable';
+    reasonCode: Exclude<AzureFinancialChargeSourceUnknownReasonV1, 'publisher-type-unrecognized'>;
+};
+/** Result of classifying one billing component. Display heuristics are not authoritative inputs. */
+export type AzureFinancialChargeClassificationV1 = {
+    source: 'azure-native' | 'marketplace';
+    publisherType: string;
+    publisherName?: string;
+} | {
+    source: 'unknown';
+    reasonCode: AzureFinancialChargeSourceUnknownReasonV1;
+    publisherType?: string;
+    publisherName?: string;
+};
+/** One immutable financial coordinate shared by cost coverage and savings authority. */
+export interface AzureFinancialCoordinateV1 {
+    generationId: string;
+    providerName: 'azure';
+    providerScopeId: string;
+    basis: CostBasis;
+    period: {
+        startDate: string;
+        endDateExclusive: string;
+    };
+    currencyCode: string;
+    minorUnitScale: number;
+}
+/** Signed partition totals. All-charge must equal Azure-native + Marketplace + unknown. */
+export interface AzureFinancialChargeSourceTotalsV1 {
+    allChargeMinorUnits: number;
+    azureNativeMinorUnits: number;
+    marketplaceMinorUnits: number;
+    unknownMinorUnits: number;
+    /** Sum of absolute values for material unknown-source rows, even when their signed net is zero. */
+    unknownAbsoluteMinorUnits: number;
+    rowCount: number;
+    azureNativeRowCount: number;
+    marketplaceRowCount: number;
+    unknownRowCount: number;
+    unknownNonZeroRowCount: number;
+}
+/** Complete reportable identity and selected-basis cost for a material unknown-source object. */
+export interface AzureUnknownFinancialChargeObjectV1 {
+    objectKey: string;
+    name: string;
+    resourceType: string;
+    resourceId?: string;
+    billableComponentKey: string;
+    signedCostMinorUnits: number;
+    absoluteCostMinorUnits: number;
+    rowCount: number;
+    nonZeroRowCount: number;
+    reasonCodes: AzureFinancialChargeSourceUnknownReasonV1[];
+}
+/** Coverage for the fixed Marketplace-excluding policy at one financial coordinate. */
+export interface AzureFinancialChargeCoverageV1 {
+    contractVersion: 'financial-charge-policy/v1';
+    policyRef: AzureFinancialChargePolicyRefV1;
+    coordinate: AzureFinancialCoordinateV1;
+    status: 'complete' | 'partial';
+    sourceTotals: AzureFinancialChargeSourceTotalsV1;
+    /** Sorted by objectKey and complete for all material unknown-source rows. */
+    unknownObjects: AzureUnknownFinancialChargeObjectV1[];
+}
+/** Canonical savings aggregate computed only from policy-eligible Azure-native billing components. */
+export interface AzurePolicyBoundSavingsAggregateV1 {
+    contractVersion: 'financial-charge-policy/v1';
+    policyRef: AzureFinancialChargePolicyRefV1;
+    coordinate: AzureFinancialCoordinateV1;
+    coverage: AzureFinancialChargeCoverageV1;
+    savingsAggregate: SavingsAggregateV2;
+}
+export type AzureChargeableSavingsUnavailableReasonV1 = 'partial-source-coverage' | 'policy-mismatch' | 'generation-mismatch' | 'coordinate-mismatch' | 'mixed-currency' | 'source-unavailable' | 'reconciliation-failed';
+/** Billing input. A partial result cannot carry a numeric customer-charge value. */
+export type AzureChargeableSavingsV1 = {
+    contractVersion: 'financial-charge-policy/v1';
+    policyRef: AzureFinancialChargePolicyRefV1;
+    coordinate: AzureFinancialCoordinateV1;
+    status: 'available';
+    coverage: AzureFinancialChargeCoverageV1 & {
+        status: 'complete';
+    };
+    savingsAggregate: SavingsAggregateV2;
+    chargeableMaxSavingsMinorUnits: number;
+} | {
+    contractVersion: 'financial-charge-policy/v1';
+    policyRef: AzureFinancialChargePolicyRefV1;
+    coordinate: AzureFinancialCoordinateV1;
+    status: 'unavailable';
+    coverage: AzureFinancialChargeCoverageV1;
+    reasonCodes: AzureChargeableSavingsUnavailableReasonV1[];
+};
+export type AzureCompanyChargeableSavingsUnavailableReasonV1 = AzureChargeableSavingsUnavailableReasonV1 | 'no-provider-scopes' | 'scope-unavailable' | 'mixed-minor-unit-scale';
+export type AzureCompanyChargeableSavingsScopeResultV1 = {
+    providerScopeId: string;
+    status: 'available';
+    generationId: string;
+    basis: CostBasis;
+    period: AzureFinancialCoordinateV1['period'];
+    currencyCode: string;
+    minorUnitScale: number;
+    chargeableMaxSavingsMinorUnits: number;
+} | {
+    providerScopeId: string;
+    status: 'unavailable';
+    reasonCodes: AzureCompanyChargeableSavingsUnavailableReasonV1[];
+};
+export type AzureCompanyChargeableSavingsTotalV1 = {
+    status: 'available';
+    basis: CostBasis;
+    period: AzureFinancialCoordinateV1['period'];
+    currencyCode: string;
+    minorUnitScale: number;
+    chargeableMaxSavingsMinorUnits: number;
+} | {
+    status: 'unavailable';
+    reasonCodes: AzureCompanyChargeableSavingsUnavailableReasonV1[];
+};
+/** Billing-facing company projection; every numeric value comes from producer-owned per-scope authority. */
+export interface AzureCompanyChargeableSavingsResponseV1 {
+    contractVersion: 'financial-charge-policy/v1';
+    policyRef: AzureFinancialChargePolicyRefV1;
+    companyId: string;
+    scopeResults: AzureCompanyChargeableSavingsScopeResultV1[];
+    companyTotal: AzureCompanyChargeableSavingsTotalV1;
+}
+/** Exact validator for one rolling all-charge/Azure-native/Marketplace/unknown partition. */
+export declare const isAzureFinancialChargeSpendBreakdownV1: (value: unknown) => value is AzureFinancialChargeSpendBreakdownV1;
+export declare const isAzureProviderScopeFinancialChargeSpendBreakdownV1: (value: unknown) => value is AzureProviderScopeFinancialChargeSpendBreakdownV1;
+export declare const isAzureResourceFinancialChargeSpendBreakdownV1: (value: unknown) => value is AzureResourceFinancialChargeSpendBreakdownV1;
+/** Validates both the resource-level shape and its binding to the enclosing resource ID. */
+export declare const isAzureResourceFinancialChargeSpendBreakdownForResourceV1: (value: unknown, resourceId: string) => value is AzureResourceFinancialChargeSpendBreakdownV1;
+/** Exact validator for publisher evidence retained from an Azure billing source. */
+export declare const isAzurePublisherTypeEvidenceV1: (value: unknown) => value is AzurePublisherTypeEvidenceV1;
+/** Exact validator for the authoritative classification of one billing component. */
+export declare const isAzureFinancialChargeClassificationV1: (value: unknown) => value is AzureFinancialChargeClassificationV1;
+export declare const isAzureFinancialCoordinateV1: (value: unknown) => value is AzureFinancialCoordinateV1;
+export declare const isAzureFinancialChargeCoverageV1: (value: unknown) => value is AzureFinancialChargeCoverageV1;
+export declare const isAzurePolicyBoundSavingsAggregateV1: (value: unknown) => value is AzurePolicyBoundSavingsAggregateV1;
+export declare const isAzureChargeableSavingsV1: (value: unknown) => value is AzureChargeableSavingsV1;
+/** Exact boundary validator for the company-level billing projection. */
+export declare const isAzureCompanyChargeableSavingsResponseV1: (value: unknown) => value is AzureCompanyChargeableSavingsResponseV1;
+//# sourceMappingURL=financialChargePolicy.d.ts.map

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

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