Adding language binding for golang

CHANGELOG.md

@@ -7,6 +7,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ## [Unreleased]
 
 ### Added
+* Added Go language binding. ([#1483](https://github.com/finos/FDC3/pull/1483))
 
 ### Changed
 

website/docs/api/ref/Channel.md

@@ -60,6 +60,36 @@ interface IChannel: IIntentResult
 }
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+@experimental
+type IChannel interface {
+    Broadcast(context Context) <-chan Result[any]
+    GetCurrentContext(contextType string) <-chan Result[IContext]
+    AddContextListener(contextType string, handler ContextHandler) <-chan Result[Listener]
+}
+
+@experimental
+type Channel struct {
+	Id              string        `json:"id"`
+	Type            ChannelType      `json:"type"`
+	DisplayMetadata *DisplayMetadata `json:"displayMetadata"`
+}
+
+@experimental
+type ChannelType string
+
+@experimental
+const (
+	App     ChannelType = "app"
+	Private ChannelType = "private"
+	User    ChannelType = "user"
+	System  ChannelType = "system"
+)
+```
+
 </TabItem>
 </Tabs>
 
@@ -89,6 +119,13 @@ public readonly id: string;
 string Id { get; }
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+Id string
+```
+
 </TabItem>
 </Tabs>
 
@@ -117,6 +154,18 @@ public enum ChannelType
 }
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+type ChannelType string
+
+const (
+	App     ChannelType = "app"
+	System  ChannelType = "system"
+	Private ChannelType = "private"
+)
+```
 </TabItem>
 </Tabs>
 
@@ -138,6 +187,12 @@ public readonly displayMetadata?: DisplayMetadata;
 IDisplayMetadata? DisplayMetadata { get; }
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+DisplayMetadata *DisplayMetadata
+```
 </TabItem>
 </Tabs>
 
@@ -165,6 +220,15 @@ public addContextListener(contextType: string | null, handler: ContextHandler):
 Task<IListener> AddContextListener<T>(string? contextType, ContextHandler<T> handler) where T : IContext;
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+func (ch *Channel) AddContextListener(contextType string, handler ContextHandler) <-chan Result[Listener]  { 
+  // Implementation here
+}
+```
+
 </TabItem>
 </Tabs>
 
@@ -213,6 +277,26 @@ var listener = await channel.AddContextListener<IContext>(null, (context, metada
 listener.Unsubscribe();
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+listenerResult := <-channel.AddContextListener("", func(contextInt IContext, contextMetadata *ContextMetadata) {
+        if context, ok := contextInt.(Context); ok {
+			if context.Type == "fdc3.contact" {
+				// handle the contact 
+			} else if context.Type == "fdc3.instrument" {
+				// handle the instrument 
+			}
+        } 
+	})
+
+// later 
+if listenerResult.Value != nil {
+	listenerResult.Value.Unsubscribe()
+}
+```
+
 </TabItem>
 </Tabs>
 
@@ -252,6 +336,26 @@ contactListener.unsubscribe();
 instrumentListener.unsubscribe();
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+listenerResultContact := <-channel.AddContextListener("fdc3.contact", func(context IContext, contextMetadata *ContextMetadata) {
+    // handle the contact
+})
+listenerResultInstrument := <-channel.AddContextListener("fdc3.instrument", func(context IContext, contextMetadata *ContextMetadata) {
+    // handle the instrument
+})
+
+// later 
+if listenerResultContact.Value != nil {
+	listenerResultContact.Value.Unsubscribe()
+}
+if listenerResultInstrument.Value != nil {
+	listenerResultInstrument.Value.Unsubscribe()
+}
+```
+
 </TabItem>
 </Tabs>
 
@@ -278,6 +382,15 @@ public broadcast(context: Context): Promise<void>;
 Task Broadcast(IContext context);
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+func (channel *Channel) Broadcast(context IContext) <-chan Result[any]  { 
+  // Implementation here
+}
+```
+
 </TabItem>
 </Tabs>
 
@@ -327,6 +440,21 @@ catch (Exception ex)
 }
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+result := <-myChannel.Broadcast(types.Context{
+			Type: "fdc3.instrument",
+			Id: map[string]string{
+				"ticker": "AAPL",
+		},
+})
+if result.Err != null {
+    // handle error 
+}
+```
+
 </TabItem>
 </Tabs>
 
@@ -352,6 +480,15 @@ public getCurrentContext(contextType?: string): Promise<Context|null>;
 Task<IContext?> GetCurrentContext(string? contextType);
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+func (channel *Channel) GetCurrentContext(contextType string) <-chan Result[Context]  { 
+  // Implementation here
+}
+```
+
 </TabItem>
 </Tabs>
 
@@ -392,6 +529,16 @@ catch (Exception ex)
 }
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+result := <-myChannel.GetCurrentContext("")
+if result.Err != null {
+    // handle error 
+}
+```
+
 </TabItem>
 </Tabs>
 
@@ -422,6 +569,16 @@ catch (Exception ex)
 }
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```go
+result := <-myChannel.GetCurrentContext("fdc3.contact")
+if result.Err != null {
+    // handle error 
+}
+```
+
 </TabItem>
 </Tabs>
 
@@ -452,6 +609,13 @@ public addContextListener(handler: ContextHandler): Promise<Listener>;
 Not implemented
 ```
 
+</TabItem>
+<TabItem value="golang" label="Go">
+
+```
+Not implemented
+```
+
 </TabItem>
 
 </Tabs>