@spottoai/types-package 1.0.2-beta.428 → 1.0.2-beta.429

package/dist/common/validationHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationHelpers.d.ts","sourceRoot":"","sources":["../../src/common/validationHelpers.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,UAAkF,CAAC;AACtI,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAA8D,CAAC;AAClH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,OAAiD,CAAC;AACpG,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAA6D,CAAC;AACvH,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,OAAuD,CAAC;AAChH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,OAA4D,CAAC;AAChH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAwE,CAAC;AAC3H,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAA+D,CAAC;AACrH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,EAAmD,CAAC;AAClH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAA2D,CAAC;AACzI,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MAAyE,CAAC;AACrI,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,EAAE,MAAM,SAAS,MAAM,EAAE,KAAG,OAA0D,CAAC;AAC3I,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,EAAE,MAAM,SAAS,MAAM,EAAE,KAAG,OAAgE,CAAC;AAEjJ,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,OAAO,EAAE,OAAO,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,CAAC,KAAG,KAAK,IAAI,iBAAiB,CAAC,CAAC,CAG/H,CAAC"}

package/dist/common/validationHelpers.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBoundedRows = exports.hasOptionalNumbers = exports.hasOptionalStrings = exports.countTotal = exports.isCountRecord = exports.isStringArray = exports.isDateTime = exports.isCount = exports.isOptionalBoolean = exports.isOptionalFiniteNumber = exports.isFiniteNumber = exports.isOptionalString = exports.isString = exports.isRecord = void 0;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+exports.isRecord = isRecord;
+const isString = (value) => typeof value === 'string' && value.trim().length > 0;
+exports.isString = isString;
+const isOptionalString = (value) => value === undefined || (0, exports.isString)(value);
+exports.isOptionalString = isOptionalString;
+const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+exports.isFiniteNumber = isFiniteNumber;
+const isOptionalFiniteNumber = (value) => value === undefined || (0, exports.isFiniteNumber)(value);
+exports.isOptionalFiniteNumber = isOptionalFiniteNumber;
+const isOptionalBoolean = (value) => value === undefined || typeof value === 'boolean';
+exports.isOptionalBoolean = isOptionalBoolean;
+const isCount = (value) => (0, exports.isFiniteNumber)(value) && Number.isInteger(value) && value >= 0;
+exports.isCount = isCount;
+const isDateTime = (value) => (0, exports.isString)(value) && Number.isFinite(Date.parse(value));
+exports.isDateTime = isDateTime;
+const isStringArray = (value) => Array.isArray(value) && value.every(exports.isString);
+exports.isStringArray = isStringArray;
+const isCountRecord = (value) => (0, exports.isRecord)(value) && Object.values(value).every(exports.isCount);
+exports.isCountRecord = isCountRecord;
+const countTotal = (value) => Object.values(value).reduce((total, count) => total + count, 0);
+exports.countTotal = countTotal;
+const hasOptionalStrings = (value, keys) => keys.every(key => (0, exports.isOptionalString)(value[key]));
+exports.hasOptionalStrings = hasOptionalStrings;
+const hasOptionalNumbers = (value, keys) => keys.every(key => (0, exports.isOptionalFiniteNumber)(value[key]));
+exports.hasOptionalNumbers = hasOptionalNumbers;
+const isBoundedRows = (value, limit, isRow) => {
+    if (!(0, exports.isRecord)(value) || !(0, exports.isCount)(value.totalCount) || !(0, exports.isCount)(value.omittedCount) || !Array.isArray(value.rows))
+        return false;
+    return value.rows.length <= limit && value.rows.every(isRow) && value.totalCount === value.rows.length + value.omittedCount;
+};
+exports.isBoundedRows = isBoundedRows;
+//# sourceMappingURL=validationHelpers.js.map

package/dist/common/validationHelpers.js.map

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

package/dist/esm/azure/reportEvidenceValidation.js

@@ -3,6 +3,7 @@ import { isReportDailySpend } from './reportDailySpendValidation.js';
 import { isReportSavingsBasis, isReportSpendProjection } from './reportSpendValidation.js';
 import { REPORT_EVIDENCE_LIMITS, } from './reportEvidence.js';
 import { countTotal, hasOptionalNumbers, hasOptionalStrings, hasRequiredRecords, isBoundedRows, isCommitmentExpirySummary, isCostSummary, isCount, isCountRecord, isDateTime, isEvidenceReference, isFiniteNumber, isOptionalBoolean, isOptionalFiniteNumber, isOptionalString, isProjectionRows, isRecommendationSummary, isRecord, isResourceSummary, isRetirementSummary, isSourceFileStatus, isString, isStringArray, isTagCoverage, } from './reportEvidenceValidationHelpers.js';
+import { isReportingStories, isStoryFingerprintRows } from '../common/utilizationStoriesValidation.js';
 export const isReportSecureScoreEvidence = (value) => {
     if (!isRecord(value) || !['available', 'unavailable', 'stale'].includes(value.status))
         return false;
@@ -260,6 +261,8 @@ const isReportingProjection = (value) => {
         return false;
     if (value.spend !== undefined && !isReportSpendProjection(value.spend))
         return false;
+    if (value.stories !== undefined && !isReportingStories(value.stories))
+        return false;
     if (value.costChangePeriods !== undefined &&
         (!isBoundedRows(value.costChangePeriods, REPORT_EVIDENCE_LIMITS.costChangePeriods, isCostChangePeriod) ||
             new Set(value.costChangePeriods.rows.map(period => period.period)).size !== value.costChangePeriods.rows.length)) {
@@ -448,7 +451,8 @@ export const isSubscriptionReportHistory = (value) => {
             !isDateTime(period.sourceGeneratedAt) ||
             !isHistoryMetrics(period.metrics) ||
             !isBoundedRows(period.recommendations, REPORT_EVIDENCE_LIMITS.historyRecommendations, isRecommendationFingerprint) ||
-            (period.comparisonIdentities !== undefined && !isHistoryComparisonIdentities(period.comparisonIdentities))) {
+            (period.comparisonIdentities !== undefined && !isHistoryComparisonIdentities(period.comparisonIdentities)) ||
+            (period.stories !== undefined && !isStoryFingerprintRows(period.stories))) {
             return false;
         }
         if (period.recommendations.omittedCount === 0 &&

package/dist/esm/azure/reportEvidenceValidationHelpers.js

@@ -1,22 +1,6 @@
 import { REPORT_EVIDENCE_LIMITS } from './reportEvidence.js';
-export const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-export const isString = (value) => typeof value === 'string' && value.trim().length > 0;
-export const isOptionalString = (value) => value === undefined || isString(value);
-export const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
-export const isOptionalFiniteNumber = (value) => value === undefined || isFiniteNumber(value);
-export const isOptionalBoolean = (value) => value === undefined || typeof value === 'boolean';
-export const isCount = (value) => isFiniteNumber(value) && Number.isInteger(value) && value >= 0;
-export const isDateTime = (value) => isString(value) && Number.isFinite(Date.parse(value));
-export const isStringArray = (value) => Array.isArray(value) && value.every(isString);
-export const isCountRecord = (value) => isRecord(value) && Object.values(value).every(isCount);
-export const countTotal = (value) => Object.values(value).reduce((total, count) => total + count, 0);
-export const hasOptionalStrings = (value, keys) => keys.every(key => isOptionalString(value[key]));
-export const hasOptionalNumbers = (value, keys) => keys.every(key => isOptionalFiniteNumber(value[key]));
-export const isBoundedRows = (value, limit, isRow) => {
-    if (!isRecord(value) || !isCount(value.totalCount) || !isCount(value.omittedCount) || !Array.isArray(value.rows))
-        return false;
-    return value.rows.length <= limit && value.rows.every(isRow) && value.totalCount === value.rows.length + value.omittedCount;
-};
+import { isBoundedRows, isCount, isCountRecord, isFiniteNumber, isOptionalFiniteNumber, isOptionalString, isRecord, isString, isStringArray, hasOptionalNumbers, hasOptionalStrings, } from '../common/validationHelpers.js';
+export { isRecord, isString, isOptionalString, isFiniteNumber, isOptionalFiniteNumber, isOptionalBoolean, isCount, isDateTime, isStringArray, isCountRecord, countTotal, hasOptionalStrings, hasOptionalNumbers, isBoundedRows, } from '../common/validationHelpers.js';
 export const isProjectionRows = (value, limit = REPORT_EVIDENCE_LIMITS.detailRows) => isBoundedRows(value, limit, isRecord);
 export const hasRequiredRecords = (value, keys) => keys.every(key => isRecord(value[key]));
 export const isSourceFileStatus = (value) => isRecord(value) &&

package/dist/esm/azure/resilienceFacts.js

@@ -0,0 +1,16 @@
+/**
+ * Resilience facts: the small per-resource property reads the resilience story needs that no other collection
+ * carries — storage blob-service data-protection settings and lifecycle management, Azure SQL database backup
+ * retention and failover groups. Collected in the reliability component beside the data-protection posture and
+ * published as `azure-portal/subscriptions/{id}/resilience-facts.json`. Consumed by the cloud-engine
+ * `ProtectionProfileBuilder` (`data-protection:<selector>` capability sources) and available to the resilience story page.
+ *
+ * Spec: `Specs/reporting/utilization-stories-types-package.md` (parent: core `specs/reporting/utilization-stories.md`).
+ * Additive: consumers tolerate unknown fields. Field semantics: `undefined` = not read (the request failed, was not
+ * applicable or was skipped) and resolves to an `unknown` capability; `null` = read and absent/disabled. A failed
+ * read must never be presented as "disabled".
+ */
+export const RESILIENCE_FACTS_SCHEMA_VERSION = 1;
+export const RESILIENCE_FACTS_SOURCE = 'AzureResilienceFacts';
+export const RESILIENCE_FACTS_PORTAL_FILE = 'resilience-facts.json';
+export const RESILIENCE_FACTS_RAW_FILE = 'data-protection/resilience-facts.json.gz';

package/dist/esm/azure/resilienceFactsValidation.js

@@ -0,0 +1,64 @@
+import { isCount, isDateTime, isFiniteNumber, isRecord, isString, isStringArray } from '../common/validationHelpers.js';
+import { RESILIENCE_FACTS_SCHEMA_VERSION, RESILIENCE_FACTS_SOURCE, } from './resilienceFacts.js';
+const STATUSES = new Set(['collected', 'partial', 'failed', 'not-applicable']);
+const isNullableBoolean = (value) => value === null || typeof value === 'boolean';
+const isNullableNumber = (value) => value === null || isFiniteNumber(value);
+const isOptionalNullableNumber = (value) => value === undefined || isNullableNumber(value);
+const isOptionalNullableString = (value) => value === undefined || value === null || isString(value);
+const isRetention = (value) => value === undefined || value === null || (isRecord(value) && typeof value.enabled === 'boolean' && isOptionalNullableNumber(value.days));
+const isOptionalNullableBoolean = (value) => value === undefined || isNullableBoolean(value);
+const isStorageFacts = (value) => isRecord(value) &&
+    isRetention(value.blobSoftDelete) &&
+    isRetention(value.containerSoftDelete) &&
+    isOptionalNullableBoolean(value.versioning) &&
+    isRetention(value.changeFeed) &&
+    isRetention(value.pointInTimeRestore) &&
+    isOptionalNullableString(value.kind) &&
+    (value.managementPolicy === undefined ||
+        value.managementPolicy === null ||
+        (isRecord(value.managementPolicy) &&
+            typeof value.managementPolicy.present === 'boolean' &&
+            (value.managementPolicy.ruleCount === undefined || isCount(value.managementPolicy.ruleCount))));
+const isSqlFacts = (value) => isRecord(value) &&
+    isOptionalNullableNumber(value.shortTermRetentionDays) &&
+    isOptionalNullableNumber(value.diffBackupIntervalHours) &&
+    (value.longTermRetention === undefined ||
+        value.longTermRetention === null ||
+        (isRecord(value.longTermRetention) &&
+            typeof value.longTermRetention.enabled === 'boolean' &&
+            isOptionalNullableString(value.longTermRetention.weekly) &&
+            isOptionalNullableString(value.longTermRetention.monthly) &&
+            isOptionalNullableString(value.longTermRetention.yearly) &&
+            isOptionalNullableNumber(value.longTermRetention.weekOfYear))) &&
+    (value.failoverGroup === undefined ||
+        value.failoverGroup === null ||
+        (isRecord(value.failoverGroup) &&
+            isString(value.failoverGroup.id) &&
+            isString(value.failoverGroup.name) &&
+            isStringArray(value.failoverGroup.partnerServers) &&
+            isOptionalNullableString(value.failoverGroup.readWriteFailoverPolicy) &&
+            isOptionalNullableString(value.failoverGroup.role))) &&
+    isOptionalNullableString(value.backupStorageRedundancy);
+export const isResilienceFactsItem = (value) => isRecord(value) &&
+    isString(value.resourceId) &&
+    isString(value.resourceType) &&
+    isString(value.status) &&
+    STATUSES.has(value.status) &&
+    isDateTime(value.observedAt) &&
+    isCount(value.requestCount) &&
+    (value.errors === undefined || isStringArray(value.errors)) &&
+    (value.storage === undefined || isStorageFacts(value.storage)) &&
+    (value.sql === undefined || isSqlFacts(value.sql));
+export const isResilienceFactsProjection = (value) => isRecord(value) &&
+    value.schemaVersion === RESILIENCE_FACTS_SCHEMA_VERSION &&
+    value.source === RESILIENCE_FACTS_SOURCE &&
+    isString(value.subscriptionId) &&
+    (value.tenantId === undefined || isString(value.tenantId)) &&
+    isDateTime(value.generatedAt) &&
+    isRecord(value.summary) &&
+    (value.summary.notApplicable === undefined || isCount(value.summary.notApplicable)) &&
+    ['storageAccounts', 'sqlDatabases', 'sqlServers', 'collected', 'partial', 'failed', 'requestCount'].every(key => isCount(value.summary[key])) &&
+    Array.isArray(value.items) &&
+    value.items.every(isResilienceFactsItem) &&
+    Array.isArray(value.issues) &&
+    value.issues.every(issue => isRecord(issue) && (issue.severity === 'warning' || issue.severity === 'error') && isString(issue.code) && isString(issue.message));

package/dist/esm/common/boundedRows.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/common/metricStats.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/common/utilizationStories.js

@@ -0,0 +1,17 @@
+export const STORY_KEYS = [
+    'oversized-resources',
+    'right-sku',
+    'schedule-candidates',
+    'resilience-recovery',
+    'hybrid-benefit',
+    'commitments',
+];
+export const STORY_LIMITS = {
+    sectionRows: 1000,
+    sampleRows: 50,
+    windowDays: 30,
+    weeklyGridDays: 7,
+    weeklyGridHours: 24,
+    /** Story fingerprints retained per monthly history period (all stories together). */
+    historyFingerprints: 2000,
+};