cloudevents · duglin · Jul 5, 2023 · Jun 1, 2023 · Jun 23, 2023 · Jun 27, 2023
diff --git a/README.md b/README.md
@@ -36,6 +36,7 @@ incubator project on [Oct 24, 2019](https://github.com/cncf/toc/pull/297).
 | **Optional Specifications:**  |
 | AMQP Protocol Binding         | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/bindings/amqp-protocol-binding.md)  | [WIP](cloudevents/bindings/amqp-protocol-binding.md)       |
 | AVRO Event Format             | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/avro-format.md)             | [WIP](cloudevents/formats/avro-format.md)                  |
+| AVRO Compact Event Format       | | [WIP](cloudevents/formats/avro-compact-format.md)             |
 | HTTP Protocol Binding         | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/bindings/http-protocol-binding.md)  | [WIP](cloudevents/bindings/http-protocol-binding.md)       |
 | JSON Event Format             | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/json-format.md)             | [WIP](cloudevents/formats/json-format.md)                  |
 | Kafka Protocol Binding        | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/bindings/kafka-protocol-binding.md) | [WIP](cloudevents/bindings/kafka-protocol-binding.md)      |

diff --git a/cloudevents/SDK.md b/cloudevents/SDK.md
@@ -13,7 +13,7 @@ following SDKs:
 - [Java SDK](https://github.com/cloudevents/sdk-java)
 - [JavaScript SDK](https://github.com/cloudevents/sdk-javascript)
 - [PHP SDK](https://github.com/cloudevents/sdk-php)
-- [PowerShell](https://github.com/cloudevents/sdk-powershell)
+- [PowerShell SDK](https://github.com/cloudevents/sdk-powershell)
 - [Python SDK](https://github.com/cloudevents/sdk-python)
 - [Ruby SDK](https://github.com/cloudevents/sdk-ruby)
 - [Rust SDK](https://github.com/cloudevents/sdk-rust)
@@ -168,11 +168,12 @@ Undo it when done:
 -->
 
 | Feature                                                                                                                                       | C#  | Go  | Java | JS  | PHP | PS  | Python | Ruby | Rust |
-| :------                                                                                                                                       | :-: | :-: | :--: | :-: | :-: | :-: | :----: | :--: | :--: |
+| :------                                                       | :-: | :-: | :--: | :-: | :-: | :-: | :----: | :--: | :--: |
 | **[v1.0](https://github.com/cloudevents/spec/tree/v1.0)** |
 | [CloudEvents Core](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md)                                                       | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:  | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark:    | :heavy_check_mark:  | :heavy_check_mark:  |
 | Event Formats |
 | [Avro](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/avro-format.md)                                                    | :heavy_check_mark: |     | :x:  | :x: |     |     |        | :x: | :x:  |
+| [Avro Compact](https://github.com/cloudevents/spec/blob/main/cloudevents/formats/avro-compact-format.md)                                      | :heavy_check_mark: |     | :x:  | :x: |     |     |        |     | :x:  |
 | [JSON](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/json-format.md)                                                    | :heavy_check_mark: |     | :heavy_check_mark:  | :heavy_check_mark: |     |     | :heavy_check_mark:    | :heavy_check_mark: | :heavy_check_mark:  |
 | [Protobuf ](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/protobuf-format.md)                                           | :heavy_check_mark: |     | :heavy_check_mark:  | :x: |     |     |        | :x: | :x:  |
 | Bindings / Content Modes |

diff --git a/cloudevents/formats/avro-compact-format.md b/cloudevents/formats/avro-compact-format.md
@@ -0,0 +1,109 @@
+# Avro Compact Event Format for CloudEvents - Version 1.0.3-wip
+
+## Abstract
+
+The Avro Compact Format for CloudEvents defines how events are expressed in
+the [Avro 1.9.0 Specification][avro-spec].
+
+This differs from the [Avro format](avro-format.md) in that:
+
+- It is optimized for performance, preferring a more compact representation.
+- It only supports spec version 1.0 (any changes to spec version requires changes to the Avro schema,
+  which changes the fingerprint, breaking compatibility).
+- It does not natively support JSON (JSON can be straight-forwardly serialized 
+  to bytes and this was therefore not considered necessary).
+
+## Table of Contents
+
+1. [Introduction](#1-introduction)
+2. [Attributes](#2-attributes)
+3. [Transport](#3-transport)
+4. [Examples](#4-examples)
+
+## 1. Introduction
+
+[CloudEvents][ce] is a standardized and protocol-agnostic definition of the
+structure and metadata description of events. This specification defines how the
+CloudEvents are to be represented as [Avro 1.9.0][avro-primitives].
+
+The [Attributes](#2-attributes) section describes the naming conventions and
+data type mappings for CloudEvents attributes for use as Avro message
+properties.
+
+This specification does not define an envelope format. The Avro type system's
+intent is primarily to provide a consistent type system for Avro itself and not
+for message payloads.
+
+The Avro event format does not currently define a batch mode format.
+
+### 1.1. Conformance
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
+"SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be
+interpreted as described in [RFC2119][rfc2119].
+
+## 2. Attributes
+
+This section defines how CloudEvents attributes are mapped to the Avro
+type-system. This specification explicitly maps each attribute.
+
+### 2.1 Type System Mapping
+
+The CloudEvents type system MUST be mapped to Avro types as follows.
+
+| CloudEvents   | Avro                                                                   |
+|---------------|------------------------------------------------------------------------|
+| Boolean       | [boolean][avro-primitives]                                             |
+| Integer       | [int][avro-primitives]                                                 |
+| String        | [string][avro-primitives]                                              |
+| Binary        | [bytes][avro-primitives]                                               |
+| URI           | [string][avro-primitives] following [RFC 3986 §4.3][rfc3986-section43] |
+| URI-reference | [string][avro-primitives] following [RFC 3986 §4.1][rfc3986-section41] |
+| Timestamp     | [long][avro-primitives]  using `timestamp-micros` logical type         |
+
+Extension specifications MAY define secondary mapping rules for the values of
+attributes they define, but MUST also include the previously defined primary
+mapping.
+
+### 2.2 Definition
+
+Users of Avro MUST use a message whose binary encoding is identical to the one
+described by the [CloudEvent Avro Compact Schema](cloudevents-compact.avsc).
+
+## 3 Transport
+
+Transports that support content identification MUST use the following designation:
+
+```text
+application/cloudevents+avro-compact
+```
+
+## 4 Examples
+
+The following table shows exemplary mappings:
+
+| CloudEvents     | Type   | Exemplary Avro Value                      |
+|-----------------|--------|-------------------------------------------|
+| id              | string | `7a0dc520-c870-4193c8`                    |
+| source          | string | `https://github.com/cloudevents`          |
+| specversion     | N/A    | Spec version is always `1.0`.             |
+| type            | string | `com.example.object.deleted.v2`           |
+| datacontenttype | string | `application/octet-stream`                |
+| dataschema      | string | `http://registry.com/schema/v1/much.json` |
+| subject         | string | `mynewfile.jpg`                           |
+| time            | long   | `1685121689691000`                        |
+| data            | bytes  | `[bytes]`                                 |
+
+## References
+
+- [Avro 1.9.0][avro-spec] Apache Avro™ 1.9.0 Specification
+
+[avro-spec]: http://avro.apache.org/docs/1.9.0/spec.html
+[avro-primitives]: http://avro.apache.org/docs/1.9.0/spec.html#schema_primitive
+[avro-logical-types]: http://avro.apache.org/docs/1.9.0/spec.html#Logical+Types
+[avro-unions]: http://avro.apache.org/docs/1.9.0/spec.html#Unions
+[ce]: ../spec.md
+[rfc2119]: https://tools.ietf.org/html/rfc2119
+[rfc3986-section41]: https://tools.ietf.org/html/rfc3986#section-4.1
+[rfc3986-section43]: https://tools.ietf.org/html/rfc3986#section-4.3
+[rfc3339]: https://tools.ietf.org/html/rfc3339
diff --git a/cloudevents/formats/avro-format.md b/cloudevents/formats/avro-format.md
@@ -2,22 +2,22 @@
 
 ## Abstract
 
-The Avro Format for CloudEvents defines how events attributes are expressed in
+The Avro Format for CloudEvents defines how events are expressed in
 the [Avro 1.9.0 Specification][avro-spec].
 
 ## Table of Contents
 
 1. [Introduction](#1-introduction)
 2. [Attributes](#2-attributes)
 3. [Data](#3-data)
-4. [Examples](#4-examples)
+4. [Transport](#4-transport)
+4. [Examples](#5-examples)
 
 ## 1. Introduction
 
 [CloudEvents][ce] is a standardized and protocol-agnostic definition of the
 structure and metadata description of events. This specification defines how the
-elements defined in the CloudEvents specification are to be represented in the
-[Avro 1.9.0][avro-primitives].
+CloudEvents are to be represented as [Avro 1.9.0][avro-primitives].
 
 The [Attributes](#2-attributes) section describes the naming conventions and
 data type mappings for CloudEvents attributes for use as Avro message
@@ -45,7 +45,7 @@ type-system. This specification explicitly maps each attribute.
 The CloudEvents type system MUST be mapped to Avro types as follows.
 
 | CloudEvents   | Avro                                                                   |
-| ------------- | ---------------------------------------------------------------------- |
+|---------------|------------------------------------------------------------------------|
 | Boolean       | [boolean][avro-primitives]                                             |
 | Integer       | [int][avro-primitives]                                                 |
 | String        | [string][avro-primitives]                                              |
@@ -148,24 +148,29 @@ For other types (non-binary data without a `datacontenttype` attribute), the
 implementation MUST translate the data value into a representation of the JSON
 value using the union types described for the `data` record.
 
-## 4 Examples
+## 4 Transport
+
+Transports that support content identification MUST use the following designation:
+
+```text
+application/cloudevents+avro
+```
+
+## 5 Examples
 
 The following table shows exemplary mappings:
 
-| CloudEvents | Type   | Exemplary Avro Value                           |
-| ----------- | ------ | ---------------------------------------------- |
-| type        | string | `"com.example.someevent"`                      |
-| specversion | string | `"1.0"`                                        |
-| source      | string | `"/mycontext"`                                 |
-| id          | string | `"7a0dc520-c870-4193c8"`                       |
-| time        | string | `"2019-06-05T23:45:00Z"`                       |
-| dataschema  | string | `"http://registry.com/schema/v1/much.json"`    |
-| contenttype | string | `"application/json"`                           |
-| data        | bytes  | `"{"much":{"wow":"json"}}"`                    |
-|             |        |                                                |
-| dataschema  | string | `"http://registry.com/subjects/ce/versions/1"` |
-| contenttype | string | `"application/avro"`                           |
-| data        | bytes  | `[avro-serialized-bytes]`                      |
+| CloudEvents     | Type   | Exemplary Avro Value                      |
+|-----------------|--------|-------------------------------------------|
+| id              | string | `7a0dc520-c870-4193c8`                    |
+| source          | string | `https://github.com/cloudevents`          |
+| specversion     | string | `1.0`                                     |
+| type            | string | `com.example.object.deleted.v2`           |
+| datacontenttype | string | `application/octet-stream`                |
+| dataschema      | string | `http://registry.com/schema/v1/much.json` |
+| subject         | string | `mynewfile.jpg`                           |
+| time            | long   | `2019-06-05T23:45:00Z`                    |
+| data            | bytes  | `[bytes]`                                 |
 
 ## References
 

diff --git a/cloudevents/formats/cloudevents-compact.avsc b/cloudevents/formats/cloudevents-compact.avsc
@@ -0,0 +1,82 @@
+{
+  "namespace": "io.cloudevents.v1.avro.compact",
+  "type": "record",
+  "name": "CloudEvent",
+  "version": "1.0",
+  "doc": "Avro Compact Event Format for CloudEvents",
+  "fields": [
+    {
+      "name": "id",
+      "type": "string"
+    },
+    {
+      "name": "source",
+      "type": "string"
+    },
+    {
+      "name": "type",
+      "type": "string"
+    },
+    {
+      "name": "datacontenttype",
+      "type": [
+        "null",
+        "string"
+      ],
+      "default": null
+    },
+    {
+      "name": "dataschema",
+      "type": [
+        "null",
+        "string"
+      ],
+      "default": null
+    },
+    {
+      "name": "subject",
+      "type": [
+        "null",
+        "string"
+      ],
+      "default": null
+    },
+    {
+      "name": "time",
+      "type": [
+        "null",
+        {
+          "type": "long",
+          "logicalType": "timestamp-micros"
+        }
+      ],
+      "default": null
+    },
+    {
+      "name": "attributes",
+      "type": {
+        "type": "map",
+        "values": [
+          "null",
+          "boolean",
+          "int",
+          { 
+            "type": "long",
+            "logicalType" : "timestamp-micros"
+          },
+          "string",
+          "bytes"
+        ]
+      },
+      "default": {}
+    },
+    {
+      "name": "data",
+      "type": [
+        "bytes",
+        "null"
+      ],
+      "default": "null"
+    }
+  ]
+}
diff --git a/cloudevents/languages/he/formats/avro-compact-format.md b/cloudevents/languages/he/formats/avro-compact-format.md
@@ -0,0 +1,2 @@
+# Avro Compact Event Format for CloudEvents - Version 1.0.3-wip
+מסמך זה טרם תורגם. בבקשה תשתמשו [בגרסה האנגלית של המסמך](../../../formats/avro-compact-format.md) לבינתיים.
diff --git a/cloudevents/languages/zh-CN/formats/avro-compact-format.md b/cloudevents/languages/zh-CN/formats/avro-compact-format.md
@@ -0,0 +1,6 @@
+# Avro Compact Event Format for CloudEvents - Version 1.0.3-wip
+
+本文档尚未被翻译，请先阅读英文[原版文档](../../../formats/avro-compact-format.md) 。
+
+如果您迫切地需要此文档的中文翻译，请[提交一个issue](https://github.com/cloudevents/spec/issues) ，
+我们会尽快安排专人进行翻译。
diff --git a/cloudevents/languages/zh-CN/primer.md b/cloudevents/languages/zh-CN/primer.md
@@ -781,4 +781,4 @@ AWS 上的很大一部分事件处理系统都在使用这种格式。
 }
 ```
 
-[Documentation](https://www.adobe.io/apis/cloudplatform/events/documentation.html)
+[Documentation](https://developer.adobe.com/events/docs/)
diff --git a/cloudevents/primer.md b/cloudevents/primer.md
@@ -1033,4 +1033,4 @@ of this format.
 }
 ```
 
-[Documentation](https://www.adobe.io/apis/cloudplatform/events/documentation.html)
+[Documentation](https://developer.adobe.com/events/docs/)