helper/schema: Export tfprotov5 schema and identity schema for consumption by other Go modules

[austinvalle]

Related Issue

N/A

Description

This PR introduces new methods on schema.Resource that return the protocol v5 schema and identity schema. This can be useful for other Go modules that need the schema to decode/encode data for a managed resource. The logic is the same as what is returned from GetProviderSchema and GetResourceIdentitySchemas RPCs:

• terraform-plugin-sdk/helper/schema/grpc_provider.go

  Lines 241 to 244 in 8984e1e

  	resp.ResourceSchemas[typ] = &tfprotov5.Schema{
  	Version: int64(res.SchemaVersion),
  	Block: convert.ConfigSchemaToProto(ctx, res.CoreConfigSchema()),
  	}

• terraform-plugin-sdk/helper/schema/grpc_provider.go

  Lines 92 to 104 in 8984e1e

  	if res.Identity != nil {
  	idschema, err := res.CoreIdentitySchema()
  	if err != nil {
  	resp.Diagnostics = convert.AppendProtoDiag(ctx, resp.Diagnostics, fmt.Errorf("getting identity schema failed for resource '%s': %w", typ, err))
  	return resp, nil
  	}
  	resp.IdentitySchemas[typ] = &tfprotov5.ResourceIdentitySchema{
  	Version: res.Identity.Version,
  	IdentityAttributes: convert.ConfigIdentitySchemaToProto(ctx, idschema),
  	}
  	}

Both methods return a function, which allows consuming Go modules to defer retrieving the schema until needed.

Rollback Plan

• If a change needs to be reverted, we will roll out an update to the code within 7 days.

Changes to Security Controls

No

[austinvalle]

This is technically reducing the coverage of this test, but it's so specific that I don't think we're losing too much 😆

[stephybun]

This all looks reasonable to me, LGTM 🦒

[SBGoods]

LGTM! Great job documenting some of the SDK schema edge cases in the tests.