docs(pulsar): add CloudEvents schema wrapping and rawSchema option for Avro and JSON schemas

[javier-aliaga]

Summary

• Document CloudEvents envelope wrapping behavior for both Avro and JSON schemas registered with the Pulsar Schema Registry
• Add the <topic-name>.rawschema metadata field, which applies to both schema types, for topics that need to skip CE wrapping and register the inner schema directly
• Include a behavior matrix table, configuration examples (Avro + JSON), and misconfiguration warnings

Details

When CloudEvents wrapping is enabled (the default), Dapr wraps user-provided schemas inside a CloudEvents envelope before registering them with Pulsar. The new .rawschema metadata flag lets operators opt out of
this wrapping on a per-topic basis for both .avroschema and .jsonschema topics.

Ref: dapr/components-contrib#4302
Ref: dapr/components-contrib#4305

Thank you for helping make the Dapr documentation better!

Please follow this checklist before submitting:

• Commits are signed with Developer Certificate of Origin (DCO - learn more)
• Read the contribution guide
• Commands include options for Linux, MacOS, and Windows within tabpane
• New file and folder names are globally unique
• Page references use shortcodes instead of markdown or URL links
• Images use HTML style and have alternative text
• Places where multiple code/command options are given have tabpane

In addition, please fill out the following to help reviewers understand this pull request:

Description

Issue reference

[Copilot]

Pull request overview

Updates the Pulsar pub/sub component documentation to explain Avro schema registration behavior when publishing CloudEvents, and introduces a component-level option to register the “inner” Avro schema for raw-payload-only topics.

Changes:

• Document that <topic-name>.avroschema is wrapped in a CloudEvents Avro envelope schema when CloudEvents wrapping is enabled (default).
• Add <topic-name>.rawSchema metadata to register the inner Avro schema directly (for raw-payload-only topics).
• Add a behavior matrix and example configuration for splitting CE-wrapped vs raw-payload topics.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The spec metadata table has 4 columns (Field/Required/Details/Example), but the new <topic-name>.jsonschema and <topic-name>.avroschema rows only provide 3 cells (missing the Example column). This breaks the Markdown table rendering/alignment; add an Example value (and trailing |) for both rows to match the header.