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

package/dist/esm/ai/workspaceArtifacts.js

@@ -0,0 +1,158 @@
+export const AI_CHAT_WORKSPACE_CAPABILITIES = [
+    {
+        viewId: 'azure.security.secureScoreTrend',
+        version: 1,
+        artifactKind: 'chart',
+        presentations: ['line'],
+        dataModes: ['snapshot', 'snapshotWithLiveRefresh'],
+    },
+    {
+        viewId: 'azure.cost.subscriptionSpendTrend',
+        version: 1,
+        artifactKind: 'chart',
+        presentations: ['area', 'line'],
+        dataModes: ['snapshot', 'snapshotWithLiveRefresh'],
+    },
+    {
+        viewId: 'azure.serviceRetirement.upcoming',
+        version: 1,
+        artifactKind: 'table',
+        presentations: ['table'],
+        dataModes: ['snapshot', 'snapshotWithLiveRefresh'],
+    },
+    {
+        viewId: 'azure.governance.complianceSummary',
+        version: 1,
+        artifactKind: 'metricGroup',
+        presentations: ['metricGroup'],
+        dataModes: ['snapshot', 'snapshotWithLiveRefresh'],
+    },
+    {
+        viewId: 'azure.resource.metrics',
+        version: 1,
+        artifactKind: 'chart',
+        presentations: ['line', 'area', 'bar'],
+        dataModes: ['liveView', 'snapshotWithLiveRefresh'],
+    },
+    /**
+     * Report strategies are fixed, reviewed Portal renderers over existing report-domain loaders and
+     * pure models. The model selects only the strategy, an authorized subject reference and a title;
+     * it never supplies report data, markup, endpoint names or URLs.
+     */
+    {
+        viewId: 'security.landscape',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'cost.changeWaterfall',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'changes.recent',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'cost.analysis',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'cost.tree',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'commitments.planning',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'licensing.hybridBenefit',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'governance.posture',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'backups.posture',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    {
+        viewId: 'retirement.tracker',
+        version: 1,
+        artifactKind: 'document',
+        presentations: ['report'],
+        dataModes: ['liveView'],
+    },
+    /**
+     * Generic views are server-produced snapshots over an authorized tool result already held by the
+     * turn. They have no live recipe and no endpoint binding: the API builds the payload from the same
+     * shaped tool output that grounded the answer, so the model never selects data, endpoint or shape.
+     */
+    {
+        viewId: 'genericTable',
+        version: 1,
+        artifactKind: 'table',
+        presentations: ['table'],
+        dataModes: ['snapshot'],
+    },
+    {
+        viewId: 'genericBarChart',
+        version: 1,
+        artifactKind: 'chart',
+        presentations: ['bar'],
+        dataModes: ['snapshot'],
+    },
+    {
+        viewId: 'genericLineChart',
+        version: 1,
+        artifactKind: 'chart',
+        presentations: ['line'],
+        dataModes: ['snapshot'],
+    },
+    {
+        viewId: 'genericKpi',
+        version: 1,
+        artifactKind: 'kpi',
+        presentations: ['kpi'],
+        dataModes: ['snapshot'],
+    },
+];
+export const AI_CHAT_WORKSPACE_GENERIC_VIEW_IDS = ['genericTable', 'genericBarChart', 'genericLineChart', 'genericKpi'];
+export const AI_CHAT_REPORT_STRATEGY_IDS = [
+    'security.landscape@1',
+    'cost.changeWaterfall@1',
+    'changes.recent@1',
+    'cost.analysis@1',
+    'cost.tree@1',
+    'commitments.planning@1',
+    'licensing.hybridBenefit@1',
+    'governance.posture@1',
+    'backups.posture@1',
+    'retirement.tracker@1',
+];

package/dist/esm/aws/commitments-planning.js

@@ -1 +1,7 @@
+export * from './commitmentsPlanningView.js';
 export { validateAwsCommitmentsPlanningViewIdentity } from './commitmentsPlanningValidation.js';
+export * from './organizationCommitments.js';
+export * from './organizationCommitmentsApiValidation.js';
+export * from './organizationCommitmentsValidation.js';
+export * from './portalOrganizationCommitmentsPlanningPublicArtifacts.js';
+export * from './portalOrganizationCommitmentsPlanningPublicArtifactValidation.js';

package/dist/esm/aws/commitmentsPlanningValidation.js

@@ -1,5 +1,6 @@
 import { ProviderName } from '../common/provider.js';
-import { asRecord, assertAccount, assertExactKeys, assertValue } from './pluginPublicArtifactValidationHelpers.js';
+import { asRecord, assertExactKeys, assertValue } from '../common/validationHelpers.js';
+import { assertAccount } from './validationHelpers.js';
 const FORBIDDEN_AWS_COMMITMENTS_KEYS = new Set([
     'billingScopeId',
     'breakCostEstimate',

package/dist/esm/aws/estates.js

@@ -6,7 +6,13 @@ export const AWS_ESTATES_MANIFEST_PROVIDER = 'AWS';
 export const AWS_ESTATE_KINDS = ['standalone', 'organization'];
 export const AWS_ESTATE_ACCOUNT_SOURCES = ['manual'];
 export const AWS_ESTATE_ROLE_DEPLOYMENT_MODES = ['customer-managed'];
-export const AWS_ESTATE_ACCOUNT_PURPOSES = ['resource-discovery', 'organization-discovery', 'billing-definition', 'billing-storage'];
+export const AWS_ESTATE_ACCOUNT_PURPOSES = [
+    'resource-discovery',
+    'organization-discovery',
+    'commitments-planning',
+    'billing-definition',
+    'billing-storage',
+];
 /**
  * Credential-shaped fields that manifest API boundaries must reject
  * recursively before persisting untyped JSON.

package/dist/esm/aws/index.js

@@ -1,18 +1,12 @@
 export * from './estates.js';
+export * from './commitmentsPlanningView.js';
 export * from './commitmentsPlanningValidation.js';
+export * from './organizationCommitments.js';
+export * from './organizationCommitmentsApiValidation.js';
+export * from './organizationCommitmentsValidation.js';
 export * from './onboarding.js';
-export * from './pluginPublicArtifacts.js';
-export * from './pluginPublicArtifactEvidence.js';
-export * from './pluginPublicArtifactValidation.js';
-export * from './portalPublicArtifacts.js';
-export * from './portalCommitmentsPlanningPublicArtifacts.js';
-export * from './portalCommitmentsPlanningPublicArtifactValidation.js';
-export * from './portalRelationshipPublicArtifacts.js';
-export * from './portalRelationshipResourceNodeTypes.js';
-export * from './portalRelationshipPublicArtifactValidation.js';
-export * from './portalPublicArtifactHistoryTypes.js';
-export * from './portalPublicArtifactNestedEvidence.js';
-export * from './portalPublicArtifactNestedEvidenceValidation.js';
-export * from './portalPublicArtifactValidation.js';
+export * from './portalOrganizationCommitmentsPlanningPublicArtifacts.js';
+export * from './portalOrganizationCommitmentsPlanningPublicArtifactValidation.js';
 export * from './publicArtifacts.js';
 export * from './requests.js';
+export * from './resourceGraph.js';

package/dist/esm/aws/organizationCommitments.js

@@ -0,0 +1,48 @@
+import { sha256Hex } from '../common/sha256.js';
+export const AWS_ORGANIZATION_COMMITMENTS_SCHEMA_VERSION = 1;
+export const AWS_ORGANIZATION_COMMITMENTS_REFRESH_STAGES = [
+    'account-inventory',
+    'payer-analytics',
+    'payer-recommendations',
+    'materialization',
+    'publication',
+];
+export const AWS_ORGANIZATION_COMMITMENTS_REFRESH_STATES = ['not-started', 'pending', 'processing', 'fresh', 'partial', 'failed'];
+export const AWS_ORGANIZATION_COMMITMENTS_REFRESH_STAGE_STATUSES = ['pending', 'processing', 'fresh', 'partial', 'failed', 'skipped'];
+export const AWS_ORGANIZATION_COMMITMENTS_SCOPE_UNAVAILABLE_REASONS = [
+    'estate-disabled',
+    'estate-not-ready',
+    'management-account-missing',
+    'commitments-permission-missing',
+    'not-authorized',
+    'unknown',
+];
+export const AWS_ORGANIZATION_COMMITMENTS_ATTRIBUTION_UNAVAILABLE_REASONS = ['not-collected', 'not-proved', 'source-unavailable'];
+export const AWS_ORGANIZATION_COMMITMENTS_ISSUE_CODES = [
+    'estate-disabled',
+    'manifest-revision-mismatch',
+    'organization-identity-invalid',
+    'management-account-unavailable',
+    'commitments-permission-missing',
+    'account-inventory-partial',
+    'payer-analytics-unavailable',
+    'payer-recommendations-unavailable',
+    'source-refresh-failed',
+    'materialization-failed',
+    'publication-failed',
+    'refresh-cooldown',
+    'unknown',
+];
+export const AWS_ORGANIZATION_COMMITMENTS_SESSION_ID_PREFIX = 'aws-org-commitments:';
+/** Builds the bounded Service Bus session identity shared by API and engine. */
+export function buildAwsOrganizationCommitmentsSessionId(companyId, estateId) {
+    const company = requiredSessionIdentity(companyId, 'companyId');
+    const estate = requiredSessionIdentity(estateId, 'estateId');
+    return `${AWS_ORGANIZATION_COMMITMENTS_SESSION_ID_PREFIX}${sha256Hex(JSON.stringify(['aws-organization-commitments', company, estate]))}`;
+}
+function requiredSessionIdentity(value, field) {
+    if (typeof value !== 'string' || value.trim() !== value || value.length === 0) {
+        throw new Error(`${field} must be a non-empty trimmed string.`);
+    }
+    return value;
+}

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, assertValue, isoTimestamp, nonNegativeInteger, requiredBoolean, requiredEnum, requiredString, validateGeneration, } from '../common/validationHelpers.js';
+import { assertAccount, assertAwsPublicJson } from './validationHelpers.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.');
+        }
+    }
+    assertAwsPublicJson(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');
+    assertAwsPublicJson(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.');
+    }
+    assertAwsPublicJson(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.`);
+}