@spottoai/types-package 1.0.2-beta.43 → 1.0.2-beta.430

package/dist/esm/aws/organizationCommitmentsApiValidation.js

@@ -0,0 +1,220 @@
+import { AWS_ORGANIZATION_COMMITMENTS_ISSUE_CODES, AWS_ORGANIZATION_COMMITMENTS_REFRESH_STAGES, AWS_ORGANIZATION_COMMITMENTS_REFRESH_STAGE_STATUSES, AWS_ORGANIZATION_COMMITMENTS_REFRESH_STATES, AWS_ORGANIZATION_COMMITMENTS_SCHEMA_VERSION, AWS_ORGANIZATION_COMMITMENTS_SCOPE_UNAVAILABLE_REASONS, } from './organizationCommitments.js';
+import { asRecord, assertExactKeys, assertPublicJson, assertValue, isoTimestamp, nonNegativeInteger, requiredBoolean, requiredEnum, requiredString, validateGeneration, } from './portalPublicArtifactValidationCommon.js';
+import { assertAccount } from './pluginPublicArtifactValidationHelpers.js';
+const ORGANIZATION_ID = /^o-[a-z0-9]{10,32}$/u;
+/** Validates one API-authored organization commitments refresh receipt. */
+export function validateAwsOrganizationCommitmentsRefreshAcceptedResponse(value, expected) {
+    const response = asRecord(value, 'organizationCommitmentsAdmission');
+    const disposition = requiredEnum(response.disposition, ['accepted', 'already-running', 'cooldown'], 'organizationCommitmentsAdmission.disposition');
+    assertExactKeys(response, [
+        'schemaVersion',
+        'provider',
+        'scopeType',
+        'companyId',
+        'estateId',
+        'organizationId',
+        'managementAccountId',
+        'requestId',
+        'correlationId',
+        'manifestRevision',
+        'disposition',
+        'acceptedAt',
+        ...(disposition === 'cooldown' ? ['nextEligibleAt'] : []),
+    ], 'organizationCommitmentsAdmission');
+    validateOrganizationApiIdentity(response, expected, 'organizationCommitmentsAdmission');
+    assertValue(response.manifestRevision, expected.manifestRevision, 'organizationCommitmentsAdmission.manifestRevision');
+    requiredString(response.requestId, 'organizationCommitmentsAdmission.requestId');
+    requiredString(response.correlationId, 'organizationCommitmentsAdmission.correlationId');
+    const acceptedAt = isoTimestamp(response.acceptedAt, 'organizationCommitmentsAdmission.acceptedAt');
+    if (disposition === 'cooldown') {
+        const nextEligibleAt = isoTimestamp(response.nextEligibleAt, 'organizationCommitmentsAdmission.nextEligibleAt');
+        if (Date.parse(nextEligibleAt) <= Date.parse(acceptedAt)) {
+            throw new Error('organizationCommitmentsAdmission.nextEligibleAt must be later than acceptedAt.');
+        }
+    }
+    assertPublicJson(response, 'organizationCommitmentsAdmission');
+    return value;
+}
+/** Validates the safe organization scope selector response for one company. */
+export function validateAwsOrganizationCommitmentsScopeListResponse(value, expectedCompanyId) {
+    const response = asRecord(value, 'organizationCommitmentsScopes');
+    assertExactKeys(response, ['schemaVersion', 'provider', 'companyId', 'organizations'], 'organizationCommitmentsScopes');
+    assertValue(response.schemaVersion, AWS_ORGANIZATION_COMMITMENTS_SCHEMA_VERSION, 'organizationCommitmentsScopes.schemaVersion');
+    assertValue(response.provider, 'AWS', 'organizationCommitmentsScopes.provider');
+    assertValue(response.companyId, requiredString(expectedCompanyId, 'expectedCompanyId'), 'organizationCommitmentsScopes.companyId');
+    if (!Array.isArray(response.organizations))
+        throw new Error('organizationCommitmentsScopes.organizations must be an array.');
+    const estateIds = [];
+    const organizationIds = [];
+    response.organizations.forEach((entry, index) => {
+        const field = `organizationCommitmentsScopes.organizations[${index}]`;
+        const scope = asRecord(entry, field);
+        assertExactKeys(scope, ['scopeType', 'estateId', 'name', 'organizationId', 'managementAccountId', 'accountCount', 'availability', 'canView', 'canRefresh', 'reason'], field);
+        assertValue(scope.scopeType, 'organization', `${field}.scopeType`);
+        estateIds.push(requiredString(scope.estateId, `${field}.estateId`));
+        requiredString(scope.name, `${field}.name`);
+        organizationIds.push(requiredOrganizationId(scope.organizationId, `${field}.organizationId`));
+        requiredAccountId(scope.managementAccountId, `${field}.managementAccountId`);
+        const accountCount = nonNegativeInteger(scope.accountCount, `${field}.accountCount`);
+        if (accountCount < 1)
+            throw new Error(`${field}.accountCount must include the management account.`);
+        const availability = requiredEnum(scope.availability, ['available', 'unavailable'], `${field}.availability`);
+        requiredBoolean(scope.canView, `${field}.canView`);
+        const canRefresh = requiredBoolean(scope.canRefresh, `${field}.canRefresh`);
+        if (availability === 'available') {
+            if (scope.reason !== undefined)
+                throw new Error(`${field}.reason is not allowed when the scope is available.`);
+        }
+        else {
+            requiredEnum(scope.reason, AWS_ORGANIZATION_COMMITMENTS_SCOPE_UNAVAILABLE_REASONS, `${field}.reason`);
+            if (canRefresh)
+                throw new Error(`${field}.canRefresh must be false when the scope is unavailable.`);
+        }
+    });
+    assertUniqueSorted(estateIds, 'organizationCommitmentsScopes.organizations estateId');
+    assertUnique(organizationIds, 'organizationCommitmentsScopes.organizations organizationId');
+    assertPublicJson(response, 'organizationCommitmentsScopes');
+    return value;
+}
+/** Validates one sanitized Blob-backed organization commitments status projection. */
+export function validateAwsOrganizationCommitmentsRefreshStatusResponse(value, expected) {
+    const response = asRecord(value, 'organizationCommitmentsStatus');
+    assertExactKeys(response, [
+        'schemaVersion',
+        'provider',
+        'scopeType',
+        'companyId',
+        'estateId',
+        'organizationId',
+        'managementAccountId',
+        'targetManifestRevision',
+        'state',
+        'requestId',
+        'correlationId',
+        'requestedAt',
+        'updatedAt',
+        'stages',
+        'failureCode',
+        'retryable',
+        'nextEligibleAt',
+        'latestArtifact',
+    ], 'organizationCommitmentsStatus');
+    validateOrganizationApiIdentity(response, expected, 'organizationCommitmentsStatus');
+    assertValue(response.targetManifestRevision, requiredString(expected.targetManifestRevision, 'expected.targetManifestRevision'), 'organizationCommitmentsStatus.targetManifestRevision');
+    const state = requiredEnum(response.state, AWS_ORGANIZATION_COMMITMENTS_REFRESH_STATES, 'organizationCommitmentsStatus.state');
+    isoTimestamp(response.updatedAt, 'organizationCommitmentsStatus.updatedAt');
+    if (state === 'not-started') {
+        for (const key of ['requestId', 'correlationId', 'requestedAt', 'failureCode', 'retryable']) {
+            if (response[key] !== undefined)
+                throw new Error(`organizationCommitmentsStatus.${key} is not allowed before a refresh starts.`);
+        }
+    }
+    else {
+        const requestId = requiredString(response.requestId, 'organizationCommitmentsStatus.requestId');
+        if (expected.requestId !== undefined)
+            assertValue(requestId, expected.requestId, 'organizationCommitmentsStatus.requestId');
+        requiredString(response.correlationId, 'organizationCommitmentsStatus.correlationId');
+        isoTimestamp(response.requestedAt, 'organizationCommitmentsStatus.requestedAt');
+    }
+    if (response.failureCode !== undefined) {
+        requiredEnum(response.failureCode, AWS_ORGANIZATION_COMMITMENTS_ISSUE_CODES, 'organizationCommitmentsStatus.failureCode');
+    }
+    if (state === 'failed' && response.failureCode === undefined) {
+        throw new Error('organizationCommitmentsStatus.failureCode is required when the refresh failed.');
+    }
+    if (response.retryable !== undefined)
+        requiredBoolean(response.retryable, 'organizationCommitmentsStatus.retryable');
+    if (response.nextEligibleAt !== undefined)
+        isoTimestamp(response.nextEligibleAt, 'organizationCommitmentsStatus.nextEligibleAt');
+    validateStages(response.stages);
+    if (response.latestArtifact !== undefined)
+        validateLatestArtifact(response.latestArtifact, state);
+    if (state === 'fresh' && response.latestArtifact === undefined) {
+        throw new Error('organizationCommitmentsStatus.latestArtifact is required when the refresh is fresh.');
+    }
+    assertPublicJson(response, 'organizationCommitmentsStatus');
+    return value;
+}
+function validateStages(value) {
+    if (!Array.isArray(value) || value.length !== AWS_ORGANIZATION_COMMITMENTS_REFRESH_STAGES.length) {
+        throw new Error('organizationCommitmentsStatus.stages must contain every canonical stage exactly once.');
+    }
+    value.forEach((entry, index) => {
+        const field = `organizationCommitmentsStatus.stages[${index}]`;
+        const stage = asRecord(entry, field);
+        assertExactKeys(stage, ['id', 'status', 'completedCount', 'totalCount', 'failureCode', 'retryable', 'updatedAt'], field);
+        assertValue(stage.id, AWS_ORGANIZATION_COMMITMENTS_REFRESH_STAGES[index], `${field}.id`);
+        const status = requiredEnum(stage.status, AWS_ORGANIZATION_COMMITMENTS_REFRESH_STAGE_STATUSES, `${field}.status`);
+        if ((stage.completedCount === undefined) !== (stage.totalCount === undefined)) {
+            throw new Error(`${field}.completedCount and totalCount must be supplied together.`);
+        }
+        if (stage.completedCount !== undefined) {
+            const completed = nonNegativeInteger(stage.completedCount, `${field}.completedCount`);
+            const total = nonNegativeInteger(stage.totalCount, `${field}.totalCount`);
+            if (completed > total)
+                throw new Error(`${field}.completedCount must not exceed totalCount.`);
+        }
+        if (stage.failureCode !== undefined)
+            requiredEnum(stage.failureCode, AWS_ORGANIZATION_COMMITMENTS_ISSUE_CODES, `${field}.failureCode`);
+        if (status === 'failed' && stage.failureCode === undefined)
+            throw new Error(`${field}.failureCode is required when the stage failed.`);
+        if (stage.retryable !== undefined)
+            requiredBoolean(stage.retryable, `${field}.retryable`);
+        isoTimestamp(stage.updatedAt, `${field}.updatedAt`);
+    });
+}
+function validateLatestArtifact(value, refreshState) {
+    const artifact = asRecord(value, 'organizationCommitmentsStatus.latestArtifact');
+    assertExactKeys(artifact, ['state', 'generatedAt', 'artifactGeneration'], 'organizationCommitmentsStatus.latestArtifact');
+    const state = requiredEnum(artifact.state, ['available', 'stale', 'unavailable'], 'organizationCommitmentsStatus.latestArtifact.state');
+    if (state === 'unavailable') {
+        if (artifact.generatedAt !== undefined || artifact.artifactGeneration !== undefined) {
+            throw new Error('organizationCommitmentsStatus.latestArtifact unavailable state cannot claim generation evidence.');
+        }
+    }
+    else {
+        const generatedAt = isoTimestamp(artifact.generatedAt, 'organizationCommitmentsStatus.latestArtifact.generatedAt');
+        const generation = validateGeneration(artifact.artifactGeneration, 'organizationCommitmentsStatus.latestArtifact.artifactGeneration');
+        if (Date.parse(generatedAt) > Date.parse(generation.generatedAt)) {
+            throw new Error('organizationCommitmentsStatus.latestArtifact.generatedAt must not exceed its generation time.');
+        }
+    }
+    if (refreshState === 'fresh' && state !== 'available') {
+        throw new Error('organizationCommitmentsStatus fresh state requires an available latest artifact.');
+    }
+}
+function validateOrganizationApiIdentity(value, expected, field) {
+    assertValue(value.schemaVersion, AWS_ORGANIZATION_COMMITMENTS_SCHEMA_VERSION, `${field}.schemaVersion`);
+    assertValue(value.provider, 'AWS', `${field}.provider`);
+    assertValue(value.scopeType, 'organization', `${field}.scopeType`);
+    assertValue(value.companyId, requiredString(expected.companyId, 'expected.companyId'), `${field}.companyId`);
+    assertValue(value.estateId, requiredString(expected.estateId, 'expected.estateId'), `${field}.estateId`);
+    const organizationId = requiredOrganizationId(value.organizationId, `${field}.organizationId`);
+    const managementAccountId = requiredAccountId(value.managementAccountId, `${field}.managementAccountId`);
+    if (expected.organizationId !== undefined)
+        assertValue(organizationId, expected.organizationId, `${field}.organizationId`);
+    if (expected.managementAccountId !== undefined) {
+        assertValue(managementAccountId, expected.managementAccountId, `${field}.managementAccountId`);
+    }
+}
+function requiredAccountId(value, field) {
+    const accountId = requiredString(value, field);
+    assertAccount(value, accountId, field);
+    return accountId;
+}
+function requiredOrganizationId(value, field) {
+    const organizationId = requiredString(value, field);
+    if (!ORGANIZATION_ID.test(organizationId))
+        throw new Error(`${field} must be a canonical AWS organization id.`);
+    return organizationId;
+}
+function assertUniqueSorted(values, field) {
+    assertUnique(values, field);
+    const sorted = [...values].sort((left, right) => left.localeCompare(right));
+    if (JSON.stringify(values) !== JSON.stringify(sorted))
+        throw new Error(`${field} must be sorted.`);
+}
+function assertUnique(values, field) {
+    if (new Set(values).size !== values.length)
+        throw new Error(`${field} must not contain duplicates.`);
+}

package/dist/esm/aws/organizationCommitmentsValidation.js

@@ -0,0 +1,224 @@
+import { ProviderName } from '../common/provider.js';
+import { asRecord, assertAccount, assertExactKeys, assertValue, requiredEnum, requiredString } from './pluginPublicArtifactValidationHelpers.js';
+const ORGANIZATION_ID = /^o-[a-z0-9]{10,32}$/u;
+const FORBIDDEN_ORGANIZATION_COMMITMENTS_KEYS = new Set([
+    'billingScopeId',
+    'blobPath',
+    'checkpoint',
+    'cloudAccountId',
+    'connectionString',
+    'credentialHealth',
+    'credentialId',
+    'credentialReference',
+    'externalId',
+    'managementGroupId',
+    'pricingQuote',
+    'quotePolicy',
+    'resourceGroupId',
+    'roleArn',
+    'saga',
+    'sasToken',
+    'secretArn',
+    'secretReference',
+    'storageCapacity',
+    'storagePath',
+    'subscription',
+    'subscriptionId',
+    'tenantId',
+    'unlockFinancialLedger',
+]);
+/** Validates the multi-account identity boundary of an AWS organization commitments view. */
+export function validateAwsOrganizationCommitmentsPlanningViewIdentity(value, expected) {
+    const view = asRecord(value, 'organizationCommitmentsPlanning');
+    const providerScope = asRecord(view.providerScope, 'organizationCommitmentsPlanning.providerScope');
+    assertExactKeys(providerScope, ['providerName', 'providerScopeId', 'scopeType', 'companyId', 'estateId', 'organizationId', 'managementAccountId'], 'organizationCommitmentsPlanning.providerScope');
+    assertValue(providerScope.providerName, ProviderName.Aws, 'organizationCommitmentsPlanning.providerScope.providerName');
+    assertValue(providerScope.scopeType, 'organization', 'organizationCommitmentsPlanning.providerScope.scopeType');
+    const companyId = requiredString(providerScope.companyId, 'organizationCommitmentsPlanning.providerScope.companyId');
+    const estateId = requiredString(providerScope.estateId, 'organizationCommitmentsPlanning.providerScope.estateId');
+    const organizationId = requiredOrganizationId(providerScope.organizationId, 'organizationCommitmentsPlanning.providerScope.organizationId');
+    assertValue(providerScope.providerScopeId, organizationId, 'organizationCommitmentsPlanning.providerScope.providerScopeId');
+    const managementAccountId = requiredAccountId(providerScope.managementAccountId, 'organizationCommitmentsPlanning.providerScope.managementAccountId');
+    assertValue(expected.companyId, companyId, 'expected.companyId');
+    assertValue(expected.estateId, estateId, 'expected.estateId');
+    assertValue(expected.organizationId, organizationId, 'expected.organizationId');
+    assertValue(expected.managementAccountId, managementAccountId, 'expected.managementAccountId');
+    assertValue(expected.manifestRevision, requiredString(view.manifestRevision, 'organizationCommitmentsPlanning.manifestRevision'), 'expected.manifestRevision');
+    const accountMembership = validateAccounts(view.accounts, managementAccountId);
+    validateExpectedMembers(expected.memberAccountIds, accountMembership.accountIds);
+    validateInventory(view.inventory, accountMembership.members);
+    validatePayerAggregates(view.payerAggregates, accountMembership.members, managementAccountId);
+    validatePurchaseRecommendations(view.purchaseRecommendations, accountMembership.members, managementAccountId);
+    validateAttribution(view.allocation, accountMembership.members, false, 'organizationCommitmentsPlanning.allocation');
+    validateAttribution(view.resourceAttribution, accountMembership.members, true, 'organizationCommitmentsPlanning.resourceAttribution');
+    validateBoundIdentities(view, accountMembership.members, organizationId, companyId, estateId, managementAccountId, 'organizationCommitmentsPlanning');
+}
+function validateAccounts(value, managementAccountId) {
+    if (!Array.isArray(value) || value.length === 0)
+        throw new Error('organizationCommitmentsPlanning.accounts must be a non-empty array.');
+    const accountIds = value.map((entry, index) => {
+        const field = `organizationCommitmentsPlanning.accounts[${index}]`;
+        const account = asRecord(entry, field);
+        assertExactKeys(account, ['accountId', 'displayName', 'role', 'inventoryStatus', 'lastSuccessfulRefreshAt'], field);
+        const accountId = requiredAccountId(account.accountId, `${field}.accountId`);
+        const role = requiredEnum(account.role, ['management', 'member'], `${field}.role`);
+        if ((accountId === managementAccountId) !== (role === 'management')) {
+            throw new Error(`${field}.role must identify the exact management account.`);
+        }
+        return accountId;
+    });
+    if (new Set(accountIds).size !== accountIds.length)
+        throw new Error('organizationCommitmentsPlanning.accounts must not contain duplicates.');
+    const sorted = [...accountIds].sort((left, right) => left.localeCompare(right));
+    if (JSON.stringify(sorted) !== JSON.stringify(accountIds))
+        throw new Error('organizationCommitmentsPlanning.accounts must be sorted by accountId.');
+    if (!accountIds.includes(managementAccountId))
+        throw new Error('organizationCommitmentsPlanning.accounts must contain the management account.');
+    return { accountIds, members: new Set(accountIds) };
+}
+function validateInventory(value, members) {
+    if (!Array.isArray(value))
+        throw new Error('organizationCommitmentsPlanning.inventory must be an array.');
+    value.forEach((entry, index) => {
+        const field = `organizationCommitmentsPlanning.inventory[${index}]`;
+        const item = asRecord(entry, field);
+        assertValue(item.sourceKind, 'aws-native', `${field}.sourceKind`);
+        assertValue(item.provider, ProviderName.Aws, `${field}.provider`);
+        requiredMember(item.ownerAccountId, members, `${field}.ownerAccountId`);
+        if (item.shape !== undefined)
+            validateAwsShape(item.shape, `${field}.shape`);
+    });
+}
+function validatePayerAggregates(value, members, managementAccountId) {
+    if (!Array.isArray(value))
+        throw new Error('organizationCommitmentsPlanning.payerAggregates must be an array.');
+    value.forEach((entry, index) => {
+        const field = `organizationCommitmentsPlanning.payerAggregates[${index}]`;
+        const aggregate = asRecord(entry, field);
+        const payerAccountId = requiredMember(aggregate.payerAccountId, members, `${field}.payerAccountId`);
+        assertValue(payerAccountId, managementAccountId, `${field}.payerAccountId`);
+        validateAwsSource(aggregate.source, `${field}.source`);
+    });
+}
+function validatePurchaseRecommendations(value, members, managementAccountId) {
+    if (value === undefined)
+        return;
+    if (!Array.isArray(value))
+        throw new Error('organizationCommitmentsPlanning.purchaseRecommendations must be an array.');
+    value.forEach((entry, index) => {
+        const field = `organizationCommitmentsPlanning.purchaseRecommendations[${index}]`;
+        const recommendation = asRecord(entry, field);
+        assertValue(recommendation.purchaseScope, 'payer', `${field}.purchaseScope`);
+        const payerAccountId = requiredMember(recommendation.payerAccountId, members, `${field}.payerAccountId`);
+        assertValue(payerAccountId, managementAccountId, `${field}.payerAccountId`);
+        if (recommendation.recommendedAccountId !== undefined) {
+            requiredMember(recommendation.recommendedAccountId, members, `${field}.recommendedAccountId`);
+        }
+        validateAwsSource(recommendation.source, `${field}.source`);
+        validateAwsShape(recommendation.targetShape, `${field}.targetShape`);
+    });
+}
+function validateAttribution(value, members, resource, field) {
+    const evidence = asRecord(value, field);
+    if (evidence.status === 'unavailable') {
+        assertExactKeys(evidence, ['status', 'reason'], field);
+        requiredEnum(evidence.reason, ['not-collected', 'not-proved', 'source-unavailable'], `${field}.reason`);
+        return;
+    }
+    assertValue(evidence.status, 'available', `${field}.status`);
+    assertExactKeys(evidence, ['status', 'source', 'records'], field);
+    validateAwsSource(evidence.source, `${field}.source`, true);
+    if (!Array.isArray(evidence.records) || evidence.records.length === 0) {
+        throw new Error(`${field}.records must be non-empty when attribution is available.`);
+    }
+    evidence.records.forEach((entry, index) => {
+        const record = asRecord(entry, `${field}.records[${index}]`);
+        if (resource) {
+            requiredMember(record.accountId, members, `${field}.records[${index}].accountId`);
+        }
+        else {
+            requiredMember(record.beneficiaryAccountId, members, `${field}.records[${index}].beneficiaryAccountId`);
+            if (record.ownerAccountId !== undefined)
+                requiredMember(record.ownerAccountId, members, `${field}.records[${index}].ownerAccountId`);
+        }
+    });
+}
+function validateAwsSource(value, field, allowDerived = false) {
+    const source = asRecord(value, field);
+    const allowed = allowDerived ? ['aws-native', 'spotto-derived'] : ['aws-native'];
+    requiredEnum(source.sourceKind, allowed, `${field}.sourceKind`);
+}
+function validateAwsShape(value, field) {
+    const shape = asRecord(value, field);
+    assertValue(shape.provider, 'aws', `${field}.provider`);
+}
+function validateBoundIdentities(value, members, organizationId, companyId, estateId, managementAccountId, field) {
+    if (Array.isArray(value)) {
+        value.forEach((entry, index) => validateBoundIdentities(entry, members, organizationId, companyId, estateId, managementAccountId, `${field}[${index}]`));
+        return;
+    }
+    if (!value || typeof value !== 'object') {
+        if (typeof value === 'string')
+            validateArnAccount(value, members, field);
+        return;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        if (FORBIDDEN_ORGANIZATION_COMMITMENTS_KEYS.has(key)) {
+            throw new Error(`${field}.${key} is not allowed in an AWS organization commitments artifact.`);
+        }
+        if (key === 'accountId' || key === 'ownerAccountId' || key === 'beneficiaryAccountId' || key === 'payerAccountId') {
+            requiredMember(child, members, `${field}.${key}`);
+        }
+        if (key === 'organizationId')
+            assertValue(child, organizationId, `${field}.${key}`);
+        if (key === 'companyId')
+            assertValue(child, companyId, `${field}.${key}`);
+        if (key === 'estateId')
+            assertValue(child, estateId, `${field}.${key}`);
+        if (key === 'managementAccountId')
+            assertAccount(child, managementAccountId, `${field}.${key}`);
+        if (key === 'providerName')
+            assertValue(child, ProviderName.Aws, `${field}.${key}`);
+        if (key === 'provider')
+            assertValue(child, 'aws', `${field}.${key}`);
+        if (key === 'sourceKind' && child === 'azure-native') {
+            throw new Error(`${field}.${key} cannot contain Azure-native evidence.`);
+        }
+        validateBoundIdentities(child, members, organizationId, companyId, estateId, managementAccountId, `${field}.${key}`);
+    }
+}
+function validateArnAccount(value, members, field) {
+    if (!value.startsWith('arn:'))
+        return;
+    const arnAccountId = value.split(':', 6)[4];
+    if (arnAccountId && !members.has(arnAccountId))
+        throw new Error(`${field} contains an ARN outside the declared organization membership.`);
+}
+function requiredMember(value, members, field) {
+    const accountId = requiredAccountId(value, field);
+    if (!members.has(accountId))
+        throw new Error(`${field} must belong to the declared organization membership.`);
+    return accountId;
+}
+function requiredAccountId(value, field) {
+    const accountId = requiredString(value, field);
+    assertAccount(value, accountId, field);
+    return accountId;
+}
+function requiredOrganizationId(value, field) {
+    const organizationId = requiredString(value, field);
+    if (!ORGANIZATION_ID.test(organizationId))
+        throw new Error(`${field} must be a canonical AWS organization id.`);
+    return organizationId;
+}
+function validateExpectedMembers(expected, actual) {
+    const normalized = expected.map((accountId, index) => requiredAccountId(accountId, `expected.memberAccountIds[${index}]`));
+    if (new Set(normalized).size !== normalized.length)
+        throw new Error('expected.memberAccountIds must not contain duplicates.');
+    const sorted = [...normalized].sort((left, right) => left.localeCompare(right));
+    if (JSON.stringify(sorted) !== JSON.stringify(normalized))
+        throw new Error('expected.memberAccountIds must be sorted.');
+    if (JSON.stringify(normalized) !== JSON.stringify(actual)) {
+        throw new Error('expected.memberAccountIds must match the artifact membership exactly.');
+    }
+}

package/dist/esm/aws/pluginPublicArtifactBodyValidation.js

@@ -0,0 +1,217 @@
+import { AWS_PLUGIN_PUBLIC_ARTIFACT_SCHEMA_VERSION, buildAwsPluginResourceLogicalName, buildAwsPluginSubscriptionLogicalName, sha256AwsPluginIdentity, } from './pluginPublicArtifacts.js';
+import { AWS_PUBLIC_ARTIFACT_SCHEMA_VERSION } from './publicArtifacts.js';
+import { asRecord, assertAccount, assertExactKeys, assertJsonEqual, assertPublicJson, assertValue, isoTimestamp, optionalEnum, requiredEnum, requiredString, sha256, stringArray, validateBilling, validateMetricWindow, validateSelector, validateTagRuleScope, } from './pluginPublicArtifactValidationHelpers.js';
+import { validateResourceSections, validateSubscriptionSections } from './pluginPublicArtifactSectionValidation.js';
+export { validateSourceBinding } from './pluginPublicArtifactSectionValidation.js';
+/** Validates and returns one lossless AWS plugin subscription-detail body. */
+export function validateAwsPluginSubscriptionDetailArtifact(value) {
+    const artifact = asRecord(value, 'artifact');
+    assertExactKeys(artifact, [
+        'schemaVersion',
+        'pluginSchemaVersion',
+        'provider',
+        'accountId',
+        'artifactType',
+        'artifactGeneration',
+        'generatedAt',
+        'logicalName',
+        'target',
+        'sections',
+    ], 'artifact');
+    validateArtifactEnvelope(artifact, 'plugin-subscription');
+    const target = validateTarget(artifact.target, 'subscription-detail');
+    const accountId = requiredString(artifact.accountId, 'artifact.accountId');
+    assertAccount(target.accountId, accountId, 'artifact.target.accountId');
+    assertValue(artifact.logicalName, buildAwsPluginSubscriptionLogicalName(target.targetKeySha256), 'artifact.logicalName');
+    validateSubscriptionSections(artifact.sections, target, requiredString(artifact.generatedAt, 'artifact.generatedAt'));
+    assertPublicJson(artifact, 'artifact');
+    return value;
+}
+/** Validates and returns one lossless AWS plugin resource-detail body. */
+export function validateAwsPluginResourceDetailArtifact(value) {
+    const artifact = asRecord(value, 'artifact');
+    assertExactKeys(artifact, [
+        'schemaVersion',
+        'pluginSchemaVersion',
+        'provider',
+        'accountId',
+        'artifactType',
+        'artifactGeneration',
+        'generatedAt',
+        'logicalName',
+        'target',
+        'selector',
+        'stableKey',
+        'sections',
+    ], 'artifact');
+    validateArtifactEnvelope(artifact, 'plugin-resource');
+    const target = validateTarget(artifact.target, 'resource-detail');
+    const accountId = requiredString(artifact.accountId, 'artifact.accountId');
+    assertAccount(target.accountId, accountId, 'artifact.target.accountId');
+    assertValue(artifact.logicalName, buildAwsPluginResourceLogicalName(target.stableKeySha256, target.targetKeySha256), 'artifact.logicalName');
+    assertJsonEqual(artifact.selector, target.selector, 'artifact.selector');
+    assertValue(artifact.stableKey, target.stableKey, 'artifact.stableKey');
+    validateResourceSections(artifact.sections, target, requiredString(artifact.generatedAt, 'artifact.generatedAt'));
+    assertPublicJson(artifact, 'artifact');
+    return value;
+}
+function validateArtifactEnvelope(artifact, artifactType) {
+    assertValue(artifact.schemaVersion, AWS_PUBLIC_ARTIFACT_SCHEMA_VERSION, 'artifact.schemaVersion');
+    assertValue(artifact.pluginSchemaVersion, AWS_PLUGIN_PUBLIC_ARTIFACT_SCHEMA_VERSION, 'artifact.pluginSchemaVersion');
+    assertValue(artifact.provider, 'aws', 'artifact.provider');
+    requiredString(artifact.accountId, 'artifact.accountId');
+    assertValue(artifact.artifactType, artifactType, 'artifact.artifactType');
+    const generation = validateGeneration(artifact.artifactGeneration, 'artifact.artifactGeneration');
+    assertValue(isoTimestamp(artifact.generatedAt, 'artifact.generatedAt'), generation.generatedAt, 'artifact.generatedAt');
+}
+function validateGeneration(value, field) {
+    const generation = asRecord(value, field);
+    assertExactKeys(generation, ['runId', 'generatedAt'], field);
+    return {
+        runId: requiredString(generation.runId, `${field}.runId`),
+        generatedAt: isoTimestamp(generation.generatedAt, `${field}.generatedAt`),
+    };
+}
+export function validateTarget(value, kind) {
+    const target = asRecord(value, 'target');
+    assertValue(target.kind, kind, 'target.kind');
+    assertValue(target.provider, 'aws', 'target.provider');
+    requiredString(target.accountId, 'target.accountId');
+    requiredString(target.targetKey, 'target.targetKey');
+    sha256(target.targetKeySha256, 'target.targetKeySha256');
+    assertValue(target.targetKeySha256, sha256AwsPluginIdentity(requiredString(target.targetKey, 'target.targetKey')), 'target.targetKeySha256');
+    validateBilling(target.billing);
+    stringArray(target.resourceRegions, 'target.resourceRegions');
+    validateMetricWindow(target.metricTimeWindow, 'target.metricTimeWindow');
+    validateRecommendationScopes(target.recommendationScopes, requiredString(target.accountId, 'target.accountId'));
+    if (kind === 'subscription-detail') {
+        assertExactKeys(target, [
+            'kind',
+            'provider',
+            'accountId',
+            'targetKey',
+            'targetKeySha256',
+            'accountSummaryTargetKey',
+            'resourceCollectionTargetKey',
+            'recommendationsTargetKey',
+            'aiCostSummaryTargetKey',
+            'serviceRetirementTargetKey',
+            'commitmentAnalysisTargetKey',
+            'reliabilityTargetKey',
+            'accountGovernanceTargetKey',
+            'billing',
+            'resourceRegions',
+            'metricTimeWindow',
+            'aiCostSummaryAudience',
+            'serviceRetirementRegions',
+            'recommendationScopes',
+            'commitmentAnalysis',
+            'reliability',
+            'accountGovernance',
+        ], 'target');
+        optionalEnum(target.aiCostSummaryAudience, ['portal', 'plugin'], 'target.aiCostSummaryAudience');
+        requiredString(target.accountSummaryTargetKey, 'target.accountSummaryTargetKey');
+        requiredString(target.resourceCollectionTargetKey, 'target.resourceCollectionTargetKey');
+        requiredString(target.recommendationsTargetKey, 'target.recommendationsTargetKey');
+        requiredString(target.serviceRetirementTargetKey, 'target.serviceRetirementTargetKey');
+        validateOptionalTargetKey(target.aiCostSummaryTargetKey, target.aiCostSummaryAudience !== undefined, 'target.aiCostSummaryTargetKey');
+        validateOptionalTargetKey(target.commitmentAnalysisTargetKey, target.commitmentAnalysis !== undefined, 'target.commitmentAnalysisTargetKey');
+        validateOptionalTargetKey(target.reliabilityTargetKey, target.reliability !== undefined, 'target.reliabilityTargetKey');
+        validateOptionalTargetKey(target.accountGovernanceTargetKey, target.accountGovernance !== undefined, 'target.accountGovernanceTargetKey');
+        stringArray(target.serviceRetirementRegions, 'target.serviceRetirementRegions');
+        validateCommitmentAnalysisTarget(target.commitmentAnalysis);
+        validateReliabilityTarget(target.reliability);
+        validateAccountGovernanceTarget(target.accountGovernance);
+    }
+    else {
+        assertExactKeys(target, [
+            'kind',
+            'provider',
+            'accountId',
+            'targetKey',
+            'targetKeySha256',
+            'resourceCollectionTargetKey',
+            'recommendationsTargetKey',
+            'billing',
+            'resourceRegions',
+            'metricTimeWindow',
+            'tagRuleScope',
+            'selector',
+            'stableKey',
+            'stableKeySha256',
+            'relationshipTargetKey',
+            'serviceRetirementTargetKey',
+            'recommendationScopes',
+        ], 'target');
+        validateTagRuleScope(target.tagRuleScope);
+        requiredString(target.resourceCollectionTargetKey, 'target.resourceCollectionTargetKey');
+        requiredString(target.recommendationsTargetKey, 'target.recommendationsTargetKey');
+        validateSelector(target.selector, 'target.selector');
+        const stableKey = requiredString(target.stableKey, 'target.stableKey');
+        if (asRecord(target.selector, 'target.selector').kind === 'stable-key') {
+            assertValue(asRecord(target.selector, 'target.selector').stableKey, stableKey, 'target.selector.stableKey');
+        }
+        sha256(target.stableKeySha256, 'target.stableKeySha256');
+        assertValue(target.stableKeySha256, sha256AwsPluginIdentity(stableKey), 'target.stableKeySha256');
+        requiredString(target.relationshipTargetKey, 'target.relationshipTargetKey');
+        requiredString(target.serviceRetirementTargetKey, 'target.serviceRetirementTargetKey');
+    }
+    return value;
+}
+function validateOptionalTargetKey(value, required, field) {
+    if (required)
+        requiredString(value, field);
+    else if (value !== undefined)
+        throw new Error(`${field} requires its corresponding optional target.`);
+}
+function validateCommitmentAnalysisTarget(value) {
+    if (value === undefined)
+        return;
+    const target = asRecord(value, 'target.commitmentAnalysis');
+    assertExactKeys(target, ['resourceRegions', 'maxBenefitEntries'], 'target.commitmentAnalysis');
+    stringArray(target.resourceRegions, 'target.commitmentAnalysis.resourceRegions');
+    if (!Number.isSafeInteger(target.maxBenefitEntries) || Number(target.maxBenefitEntries) <= 0) {
+        throw new Error('target.commitmentAnalysis.maxBenefitEntries must be a positive safe integer.');
+    }
+}
+function validateReliabilityTarget(value) {
+    if (value === undefined)
+        return;
+    const target = asRecord(value, 'target.reliability');
+    assertExactKeys(target, ['includeTemplateContent', 'includeScoring', 'maxResultsPerSection', 'sectionScopeKeys'], 'target.reliability');
+    if (target.includeTemplateContent !== undefined)
+        assertValue(target.includeTemplateContent, true, 'target.reliability.includeTemplateContent');
+    if (target.includeScoring !== undefined)
+        assertValue(target.includeScoring, true, 'target.reliability.includeScoring');
+    if (!Number.isSafeInteger(target.maxResultsPerSection) || Number(target.maxResultsPerSection) <= 0) {
+        throw new Error('target.reliability.maxResultsPerSection must be a positive safe integer.');
+    }
+    stringArray(target.sectionScopeKeys, 'target.reliability.sectionScopeKeys');
+}
+function validateAccountGovernanceTarget(value) {
+    if (value === undefined)
+        return;
+    const target = asRecord(value, 'target.accountGovernance');
+    assertExactKeys(target, ['apiRegion'], 'target.accountGovernance');
+    requiredString(target.apiRegion, 'target.accountGovernance.apiRegion');
+}
+function validateRecommendationScopes(value, accountId) {
+    if (!Array.isArray(value))
+        throw new Error('target.recommendationScopes must be an array.');
+    const scopes = value;
+    scopes.forEach((value, index) => {
+        const field = `target.recommendationScopes[${index}]`;
+        const scope = asRecord(value, field);
+        assertExactKeys(scope, ['source', 'scope', 'accountId', 'scopeDiscriminator', 'computeOptimizerFamily', 'resourceRegions', 'targetKey', 'actionabilityTargetKey'], field);
+        requiredEnum(scope.source, ['custom', 'compute-optimizer', 'cost-optimization-hub', 'resilience-hub', 'security-hub', 'trusted-advisor', 'well-architected'], `${field}.source`);
+        assertValue(scope.scope, 'account', `${field}.scope`);
+        assertAccount(scope.accountId, accountId, `${field}.accountId`);
+        if (scope.scopeDiscriminator !== undefined)
+            requiredString(scope.scopeDiscriminator, `${field}.scopeDiscriminator`);
+        if (scope.computeOptimizerFamily !== undefined)
+            requiredString(scope.computeOptimizerFamily, `${field}.computeOptimizerFamily`);
+        stringArray(scope.resourceRegions, `${field}.resourceRegions`);
+        requiredString(scope.targetKey, `${field}.targetKey`);
+        requiredString(scope.actionabilityTargetKey, `${field}.actionabilityTargetKey`);
+    });
+}