@spottoai/types-package 1.0.2-beta.395 → 1.0.2-beta.397

package/dist/esm/environment/validation.js

@@ -1,6 +1,6 @@
 import { ENVIRONMENT_ARTIFACT_KINDS_V1, ENVIRONMENT_CONTRACT_LIMITS_V1, ENVIRONMENT_DOCUMENT_NAMES_V1, ENVIRONMENT_EFFORTS_V1, ENVIRONMENT_FINDING_KINDS_V1, ENVIRONMENT_IMPACTS_V1, ENVIRONMENT_PILLARS_V1, ENVIRONMENT_SEVERITIES_V1, } from './contracts.js';
 import { CURRENCY_PATTERN, DECIMAL_PATTERN, ENVIRONMENT_RUN_ID_PATTERN, SHA256_PATTERN, hasExactKeys, hasSafeContainerShape, isBoundedString, isCanonicalUtcTimestamp, isCustomerString, isNonNegativeInteger, isRecord, isSafeLabel, isScopeIdentifier, isSourceIdentity, utf8ByteLength, } from './internal.js';
-import { isEnvironmentLogicalEvidenceReferenceV1, isEnvironmentLogicalResourceReferenceV1 } from './references.js';
+import { deriveEnvironmentAzureResourceTypeV1, isEnvironmentLogicalEvidenceReferenceV1, isEnvironmentLogicalResourceReferenceV1, parseEnvironmentLogicalResourceReferenceV1, } from './references.js';
 const DOCUMENT_NAMES = new Set(ENVIRONMENT_DOCUMENT_NAMES_V1);
 const ARTIFACT_KINDS = new Set(ENVIRONMENT_ARTIFACT_KINDS_V1);
 const PILLARS = new Set(ENVIRONMENT_PILLARS_V1);
@@ -17,6 +17,10 @@ const MONEY_PROVENANCE = new Set([
     'recommendation',
 ]);
 const SAVINGS_ADDITIVITY = new Set(['additive', 'scenario-non-additive']);
+const SPEND_SOURCES = new Set(['billing', 'estimated', 'blended']);
+const SPEND_SOURCE_CONFIDENCES = new Set(['high', 'medium', 'low', 'unknown']);
+const SAVINGS_PROJECTIONS = new Set(['projected-monthly', 'observed-period', 'unknown']);
+const DATE_WINDOW_PATTERN = /^\d{4}-\d{2}-\d{2}\/\d{4}-\d{2}-\d{2}$/u;
 const CHANGE_DIRECTIONS = new Set(['increase', 'decrease', 'unchanged', 'unknown']);
 const scopesEqual = (left, right) => left.kind === right.kind && left.tenantId === right.tenantId && left.companyId === right.companyId && left.subscriptionId === right.subscriptionId;
 /** Validates a bounded, local Portal route suitable for client-visible evidence. */
@@ -45,6 +49,16 @@ const isAzureResourceTypeArray = (value) => Array.isArray(value) &&
         AZURE_RESOURCE_TYPE_PATTERN.test(item)) &&
     new Set(value).size === value.length &&
     value.every((item, index) => index === 0 || value[index - 1] < item);
+const resourceTypesMatchReferences = (resourceTypes, resourceReferences) => {
+    const derivedTypes = Array.from(new Set(resourceReferences.flatMap(reference => {
+        const parsed = parseEnvironmentLogicalResourceReferenceV1(reference);
+        if (parsed === null)
+            return [];
+        const resourceType = deriveEnvironmentAzureResourceTypeV1(parsed.resourceId);
+        return resourceType === null ? [] : [resourceType];
+    }))).sort();
+    return derivedTypes.length === resourceTypes.length && derivedTypes.every((resourceType, index) => resourceTypes[index] === resourceType);
+};
 const isPercentage = (value) => typeof value === 'string' && DECIMAL_PATTERN.test(value) && Number(value) <= 100;
 /** Validates one admitted environment pillar. */
 export const isEnvironmentPillarV1 = (value) => typeof value === 'string' && PILLARS.has(value);
@@ -105,9 +119,31 @@ export const isEnvironmentRunIdV1 = (value) => typeof value === 'string' &&
     value !== '.' &&
     value !== '..' &&
     ENVIRONMENT_RUN_ID_PATTERN.test(value);
+const isMoneyComposition = (value, currencyCode) => isRecord(value) &&
+    hasExactKeys(value, ['billingBacked', 'estimated', 'minorUnitScale', 'currencyCode']) &&
+    isNonNegativeInteger(value.billingBacked) &&
+    isNonNegativeInteger(value.estimated) &&
+    isNonNegativeInteger(value.minorUnitScale) &&
+    value.minorUnitScale <= 6 &&
+    typeof value.currencyCode === 'string' &&
+    (value.currencyCode === 'unknown' || CURRENCY_PATTERN.test(value.currencyCode)) &&
+    value.currencyCode === currencyCode;
+/** Validates the producer projection rule and window behind a savings amount. */
+export const isEnvironmentSavingsBasisV1 = (value) => isRecord(value) &&
+    hasExactKeys(value, ['projection'], ['observedPeriod', 'stableWindow', 'containsLegacySavings']) &&
+    typeof value.projection === 'string' &&
+    SAVINGS_PROJECTIONS.has(value.projection) &&
+    (value.observedPeriod === undefined || isSafeLabel(value.observedPeriod)) &&
+    (value.stableWindow === undefined || (typeof value.stableWindow === 'string' && DATE_WINDOW_PATTERN.test(value.stableWindow))) &&
+    (value.containsLegacySavings === undefined || typeof value.containsLegacySavings === 'boolean');
 /** Validates canonical decimal money with explicit currency, basis, period, and provenance. */
 export const isEnvironmentMoneyValueV1 = (value) => isRecord(value) &&
-    hasExactKeys(value, ['amount', 'currencyCode', 'basis', 'period', 'provenance'], ['savingsAdditivity']) &&
+    hasExactKeys(value, ['amount', 'currencyCode', 'basis', 'period', 'provenance'], ['savingsAdditivity', 'spendSource', 'spendSourceConfidence', 'composition', 'savingsBasis']) &&
+    (value.spendSource === undefined || (typeof value.spendSource === 'string' && SPEND_SOURCES.has(value.spendSource))) &&
+    (value.spendSourceConfidence === undefined ||
+        (typeof value.spendSourceConfidence === 'string' && SPEND_SOURCE_CONFIDENCES.has(value.spendSourceConfidence))) &&
+    (value.composition === undefined || isMoneyComposition(value.composition, value.currencyCode)) &&
+    (value.savingsBasis === undefined || isEnvironmentSavingsBasisV1(value.savingsBasis)) &&
     typeof value.amount === 'string' &&
     DECIMAL_PATTERN.test(value.amount) &&
     typeof value.currencyCode === 'string' &&
@@ -118,8 +154,11 @@ export const isEnvironmentMoneyValueV1 = (value) => isRecord(value) &&
     typeof value.provenance === 'string' &&
     MONEY_PROVENANCE.has(value.provenance) &&
     (value.savingsAdditivity === undefined || (typeof value.savingsAdditivity === 'string' && SAVINGS_ADDITIVITY.has(value.savingsAdditivity)));
-const isObservedMoney = (value) => isEnvironmentMoneyValueV1(value) && value.savingsAdditivity === undefined;
-const isSavingsMoney = (value) => isEnvironmentMoneyValueV1(value) && value.savingsAdditivity !== undefined;
+const isObservedMoney = (value) => isEnvironmentMoneyValueV1(value) && value.savingsAdditivity === undefined && value.savingsBasis === undefined;
+const isSavingsMoney = (value) => isEnvironmentMoneyValueV1(value) &&
+    value.savingsAdditivity !== undefined &&
+    value.spendSource === undefined &&
+    value.composition === undefined;
 /** Validates the closed coverage-state union and state-specific freshness rules. */
 export const isEnvironmentCoverageStateV1 = (value) => {
     if (!isRecord(value) || typeof value.status !== 'string')
@@ -244,6 +283,7 @@ const isRecommendation = (value) => isRecord(value) &&
     (value.affectedResources === undefined || isEnvironmentCardinalityV1(value.affectedResources)) &&
     (value.potentialSavings === undefined || isSavingsMoney(value.potentialSavings)) &&
     isResourceReferenceArray(value.resourceReferences) &&
+    resourceTypesMatchReferences(value.affectedResourceTypes, value.resourceReferences) &&
     isReferenceArray(value.sourceReferences);
 const isChange = (value) => isRecord(value) &&
     hasExactKeys(value, ['key', 'pillars', 'safeLabel', 'description', 'direction', 'sourceReferences'], ['amount']) &&
@@ -287,6 +327,127 @@ const isCostSummary = (value) => isRecord(value) &&
     (value.observedCost === undefined || isObservedMoney(value.observedCost)) &&
     (value.potentialSavings === undefined || isSavingsMoney(value.potentialSavings)) &&
     (value.costRecommendationCount === undefined || isNonNegativeInteger(value.costRecommendationCount));
+const SECTION_ITEMS = ENVIRONMENT_CONTRACT_LIMITS_V1.sectionListItems;
+const isSectionList = (value, itemValidator) => isBoundedList(value, itemValidator) && value.items.length <= SECTION_ITEMS;
+const isSectionCount = (value) => value === undefined || isNonNegativeInteger(value);
+const isLabeledCount = (value) => isRecord(value) &&
+    hasExactKeys(value, ['key', 'safeLabel', 'count']) &&
+    isGeneralKey(value.key) &&
+    isSafeLabel(value.safeLabel) &&
+    isNonNegativeInteger(value.count);
+const isSubjectReference = (value) => isRecord(value) &&
+    hasExactKeys(value, ['key', 'safeLabel'], ['detail', 'resourceReference']) &&
+    isGeneralKey(value.key) &&
+    isSafeLabel(value.safeLabel) &&
+    (value.detail === undefined || isCustomerString(value.detail)) &&
+    (value.resourceReference === undefined || isEnvironmentLogicalResourceReferenceV1(value.resourceReference));
+const isCommitmentPurchaseOption = (value) => isRecord(value) &&
+    hasExactKeys(value, ['key', 'safeLabel'], ['termMonths', 'estimatedMonthlySavings']) &&
+    isGeneralKey(value.key) &&
+    isSafeLabel(value.safeLabel) &&
+    isSectionCount(value.termMonths) &&
+    (value.estimatedMonthlySavings === undefined || isSavingsMoney(value.estimatedMonthlySavings));
+const isCommitmentCoverageRow = (value) => isRecord(value) &&
+    hasExactKeys(value, ['key', 'safeLabel', 'benefitLabels'], ['detail', 'resourceReference']) &&
+    isGeneralKey(value.key) &&
+    isSafeLabel(value.safeLabel) &&
+    Array.isArray(value.benefitLabels) &&
+    value.benefitLabels.length <= SECTION_ITEMS &&
+    value.benefitLabels.every(isSafeLabel) &&
+    (value.detail === undefined || isCustomerString(value.detail)) &&
+    (value.resourceReference === undefined || isEnvironmentLogicalResourceReferenceV1(value.resourceReference));
+const isCommitmentsSection = (value) => isRecord(value) &&
+    hasExactKeys(value, ['coverage', 'purchaseOptions', 'benefitCoverage', 'sourceReferences'], ['benefitCount', 'utilizationPercent30Day', 'utilizationPercent7Day', 'expiredCount', 'expiring90DayCount', 'expiring180DayCount']) &&
+    isEnvironmentCoverageStateV1(value.coverage) &&
+    isSectionCount(value.benefitCount) &&
+    (value.utilizationPercent30Day === undefined || isPercentage(value.utilizationPercent30Day)) &&
+    (value.utilizationPercent7Day === undefined || isPercentage(value.utilizationPercent7Day)) &&
+    isSectionCount(value.expiredCount) &&
+    isSectionCount(value.expiring90DayCount) &&
+    isSectionCount(value.expiring180DayCount) &&
+    isSectionList(value.purchaseOptions, isCommitmentPurchaseOption) &&
+    isSectionList(value.benefitCoverage, isCommitmentCoverageRow) &&
+    isReferenceArray(value.sourceReferences);
+const isBudget = (value) => isRecord(value) &&
+    hasExactKeys(value, ['key', 'safeLabel'], ['period', 'amount', 'currentSpend', 'forecastSpend', 'consumedPercent']) &&
+    isGeneralKey(value.key) &&
+    isSafeLabel(value.safeLabel) &&
+    (value.period === undefined || isSafeLabel(value.period)) &&
+    (value.amount === undefined || isObservedMoney(value.amount)) &&
+    (value.currentSpend === undefined || isObservedMoney(value.currentSpend)) &&
+    (value.forecastSpend === undefined || isObservedMoney(value.forecastSpend)) &&
+    (value.consumedPercent === undefined || (typeof value.consumedPercent === 'string' && DECIMAL_PATTERN.test(value.consumedPercent)));
+const isBudgetSection = (value) => isRecord(value) &&
+    hasExactKeys(value, ['coverage', 'budgets', 'sourceReferences']) &&
+    isEnvironmentCoverageStateV1(value.coverage) &&
+    isSectionList(value.budgets, isBudget) &&
+    isReferenceArray(value.sourceReferences);
+const isIdleResourceSection = (value) => isRecord(value) &&
+    hasExactKeys(value, ['coverage', 'recommendationCount', 'resourceCount', 'subjects', 'sourceReferences'], ['monthlyWaste']) &&
+    isEnvironmentCoverageStateV1(value.coverage) &&
+    isNonNegativeInteger(value.recommendationCount) &&
+    isNonNegativeInteger(value.resourceCount) &&
+    (value.monthlyWaste === undefined || isSavingsMoney(value.monthlyWaste)) &&
+    isSectionList(value.subjects, isSubjectReference) &&
+    isReferenceArray(value.sourceReferences);
+const isPublicIpExposureSection = (value) => isRecord(value) &&
+    hasExactKeys(value, ['coverage', 'totalCount', 'exposedSubjects', 'remediationOptions', 'sourceReferences'], ['assignedCount', 'unassignedCount', 'basicSkuCount', 'httpsExposedCount', 'rdpExposedCount', 'sshExposedCount']) &&
+    isEnvironmentCoverageStateV1(value.coverage) &&
+    isNonNegativeInteger(value.totalCount) &&
+    [value.assignedCount, value.unassignedCount, value.basicSkuCount, value.httpsExposedCount, value.rdpExposedCount, value.sshExposedCount].every(isSectionCount) &&
+    isSectionList(value.exposedSubjects, isSubjectReference) &&
+    isSectionList(value.remediationOptions, isLabeledCount) &&
+    isReferenceArray(value.sourceReferences);
+const isSecretStoreCoverageSection = (value) => isRecord(value) &&
+    hasExactKeys(value, ['coverage', 'vaultCount', 'inspectedVaultCount', 'reasons', 'sourceReferences']) &&
+    isEnvironmentCoverageStateV1(value.coverage) &&
+    isNonNegativeInteger(value.vaultCount) &&
+    isNonNegativeInteger(value.inspectedVaultCount) &&
+    isSectionList(value.reasons, isLabeledCount) &&
+    isReferenceArray(value.sourceReferences);
+const isTagCoverageSection = (value) => isRecord(value) &&
+    hasExactKeys(value, [
+        'coverage',
+        'resourceCount',
+        'taggedResourceCount',
+        'untaggedResourceCount',
+        'distinctTagKeyCount',
+        'topTagKeys',
+        'sourceReferences',
+    ]) &&
+    isEnvironmentCoverageStateV1(value.coverage) &&
+    isNonNegativeInteger(value.resourceCount) &&
+    isNonNegativeInteger(value.taggedResourceCount) &&
+    isNonNegativeInteger(value.untaggedResourceCount) &&
+    isNonNegativeInteger(value.distinctTagKeyCount) &&
+    value.taggedResourceCount + value.untaggedResourceCount === value.resourceCount &&
+    isSectionList(value.topTagKeys, isLabeledCount) &&
+    isReferenceArray(value.sourceReferences);
+const isChangeSignalSection = (value) => isRecord(value) &&
+    hasExactKeys(value, ['coverage', 'windowDays', 'changeCount', 'topOperations', 'sourceReferences'], ['materialChangeCount', 'securityRelevantCount']) &&
+    isEnvironmentCoverageStateV1(value.coverage) &&
+    isNonNegativeInteger(value.windowDays) &&
+    isNonNegativeInteger(value.changeCount) &&
+    isSectionCount(value.materialChangeCount) &&
+    isSectionCount(value.securityRelevantCount) &&
+    isSectionList(value.topOperations, isLabeledCount) &&
+    isReferenceArray(value.sourceReferences);
+const isHealthEvent = (value) => isRecord(value) &&
+    hasExactKeys(value, ['key', 'safeLabel', 'severity'], ['eventType', 'startedAt']) &&
+    isGeneralKey(value.key) &&
+    isSafeLabel(value.safeLabel) &&
+    typeof value.severity === 'string' &&
+    SEVERITIES.has(value.severity) &&
+    (value.eventType === undefined || isSafeLabel(value.eventType)) &&
+    (value.startedAt === undefined || isCanonicalUtcTimestamp(value.startedAt));
+const isHealthEventSection = (value) => isRecord(value) &&
+    hasExactKeys(value, ['coverage', 'totalCount', 'activeCount', 'resolvedCount', 'activeEvents', 'sourceReferences']) &&
+    isEnvironmentCoverageStateV1(value.coverage) &&
+    isNonNegativeInteger(value.totalCount) &&
+    isNonNegativeInteger(value.activeCount) &&
+    isNonNegativeInteger(value.resolvedCount) &&
+    isSectionList(value.activeEvents, isHealthEvent) &&
+    isReferenceArray(value.sourceReferences);
 /** Validates the strict, bounded multi-pillar subscription environment projection. */
 export const isEnvironmentSubscriptionProjectionV1 = (value) => {
     if (!hasSafeContainerShape(value) || !isRecord(value))
@@ -309,7 +470,7 @@ export const isEnvironmentSubscriptionProjectionV1 = (value) => {
         'changes',
         'warnings',
         'sourceReferences',
-    ]) ||
+    ], ['commitments', 'budgets', 'idleResources', 'publicIpExposure', 'secretStoreCoverage', 'tagCoverage', 'changeSignals', 'healthEvents']) ||
         value.schemaVersion !== 1 ||
         !isEnvironmentScopeV1(value.scope) ||
         !isEnvironmentSourceBindingV1(value.sourceBinding) ||
@@ -331,6 +492,14 @@ export const isEnvironmentSubscriptionProjectionV1 = (value) => {
         !isBoundedList(value.recommendations, isRecommendation) ||
         !isBoundedList(value.changes, isChange) ||
         !isBoundedList(value.warnings, isWarning) ||
+        (value.commitments !== undefined && !isCommitmentsSection(value.commitments)) ||
+        (value.budgets !== undefined && !isBudgetSection(value.budgets)) ||
+        (value.idleResources !== undefined && !isIdleResourceSection(value.idleResources)) ||
+        (value.publicIpExposure !== undefined && !isPublicIpExposureSection(value.publicIpExposure)) ||
+        (value.secretStoreCoverage !== undefined && !isSecretStoreCoverageSection(value.secretStoreCoverage)) ||
+        (value.tagCoverage !== undefined && !isTagCoverageSection(value.tagCoverage)) ||
+        (value.changeSignals !== undefined && !isChangeSignalSection(value.changeSignals)) ||
+        (value.healthEvents !== undefined && !isHealthEventSection(value.healthEvents)) ||
         !isReferenceArray(value.sourceReferences)) {
         return false;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spottoai/types-package",
-  "version": "1.0.2-beta.395",
+  "version": "1.0.2-beta.397",
   "description": "Shared TypeScript interfaces for SpottoAI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",