Compare nested Relationship endpoint model shape

[alexchro93]

Summary

This draft PR is an alternate implementation of #4892 for comparison. It keeps the same experimental ARM Relationship base type feature, but models relationship endpoints as nested objects instead of flat properties.

The resulting relationship properties shape is:

source: RelationshipSource;
target: RelationshipTarget;
metadata?: RelationshipMetadata;

Where endpoint-specific details live under the endpoint objects:

{
  "source": { "id": "...", "type": "..." },
  "target": { "id": "...", "type": "...", "tenant": "..." },
  "metadata": {}
}

Notable differences from #4892

• Replaces top-level sourceId, targetId, and targetTenant with source and target object properties.
• Moves source/target type metadata from RelationshipMetadata into source.type and target.type.
• Leaves RelationshipMetadata for RP-defined relationship metadata.
• Updates the required-properties linter to validate nested endpoint models.
• Regenerates the relationship sample OpenAPI output and ARM reference docs.

Validation

• pnpm -r --filter "@azure-tools/typespec-azure-resource-manager..." build
• pnpm --filter @azure-tools/typespec-azure-resource-manager test -- arm-relationship-base-type-required-properties
• pnpm --filter @azure-tools/typespec-samples test:regen -- -t relationship
• pnpm --filter @azure-tools/typespec-samples test -- -t relationship
• git diff --check

[azure-sdk-automation]

❌ There is undocummented changes. Run chronus add to add a changeset or click here.

The following packages have changes but are not documented.

• ❌@azure-tools/typespec-azure-rulesets

The following packages have already been documented:

• ✅ @azure-tools/typespec-azure-resource-manager

Show changes

@azure-tools/typespec-azure-resource-manager - feature ✏️

Add the experimental Relationship base type for Azure Resource Manager extension resources, including nested source and target endpoint properties and lint validation for Relationship base type conformance.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@azure-tools/typespec-azure-resource-manager@4893

npm i https://pkg.pr.new/@azure-tools/typespec-azure-rulesets@4893

commit: 77ece5c

[azure-sdk-automation]

You can try these changes here

🛝 Playground	🌐 Website