helper/schema: Export tfprotov5 schema and identity schema for consumption by other Go modules (#1504)

* quick helper

* add identity func

* add changelogs

* copyright

* remove weird global modification

* sort identity schema

Author: austinvalle

.changes/unreleased/ENHANCEMENTS-20250807-180902.yaml

@@ -0,0 +1,5 @@
+kind: ENHANCEMENTS
+body: 'helper/schema: Added new helper methods for converting Resource and Identity schemas to protocol representations.'
+time: 2025-08-07T18:09:02.117077-04:00
+custom:
+    Issue: "1504"

helper/schema/core_schema.go

@@ -4,11 +4,14 @@
 package schema
 
 import (
+	"context"
 	"fmt"
 
 	"github.com/hashicorp/go-cty/cty"
+	"github.com/hashicorp/terraform-plugin-go/tfprotov5"
 
 	"github.com/hashicorp/terraform-plugin-sdk/v2/internal/configs/configschema"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/internal/plugin/convert"
 )
 
 // StringKind represents the format a string is in.
@@ -397,3 +400,37 @@ func (r *Resource) coreIdentitySchema() (*configschema.Block, error) {
 	// to convert our schema
 	return schemaMap(r.Identity.SchemaMap()).CoreConfigSchema(), nil
 }
+
+// ProtoSchema will return a function that returns the *tfprotov5.Schema
+func (r *Resource) ProtoSchema(ctx context.Context) func() *tfprotov5.Schema {
+	return func() *tfprotov5.Schema {
+		return &tfprotov5.Schema{
+			Version: int64(r.SchemaVersion),
+			Block:   convert.ConfigSchemaToProto(ctx, r.CoreConfigSchema()),
+		}
+	}
+}
+
+// ProtoIdentitySchema will return a function that returns the *tfprotov5.ResourceIdentitySchema if the resource supports identity,
+// otherwise it will return nil.
+func (r *Resource) ProtoIdentitySchema(ctx context.Context) func() *tfprotov5.ResourceIdentitySchema {
+	// Resource doesn't support identity, return nil
+	if r.Identity == nil {
+		return nil
+	}
+
+	return func() *tfprotov5.ResourceIdentitySchema {
+		idschema, err := r.CoreIdentitySchema()
+
+		if err != nil {
+			// This shouldn't be reachable unless there is an implementation error in the provider, which should raise
+			// a diagnostic prior to reaching this point.
+			panic(fmt.Sprintf("unexpected error retrieving identity schema: %s", err))
+		}
+
+		return &tfprotov5.ResourceIdentitySchema{
+			Version:            r.Identity.Version,
+			IdentityAttributes: convert.ConfigIdentitySchemaToProto(ctx, idschema),
+		}
+	}
+}