@rivascva/dt-idl 1.1.44 → 1.1.46

package/README.md

@@ -69,3 +69,20 @@ npm install
 ### Deployments
 
 Any merge to `main` with changes to the `ts/*` and `go/*` directory will trigger an automatic deployment to `npm`
+
+### Go Package
+
+To import the Go packages in other repositories, you must follow the steps below to allow importing from a private repository.
+
+#### 1. Add an ssh override in your `~/.gitconfig`
+
+```bash
+[url "git@github.com:"]
+  insteadOf = https://github.com/
+```
+
+#### 2. Add the following export within your `~/.zshrc`
+
+```bash
+export GOPRIVATE=github.com/RivasCVA/*
+```

package/go/utils/fetch/fetch.go

@@ -6,14 +6,14 @@ import (
 	"net/http"
 )
 
-type response struct {
+type Response struct {
 	StatusCode int
 }
 
 // Makes a GET request to the given url.
 //
 // Parses the JSON-encoded response and stores the result into v.
-func Get(url string, v any) (*response, error) {
+func Get(url string, v any) (*Response, error) {
 	// make the GET request
 	resp, err := http.Get(url)
 	if err != nil {
@@ -33,7 +33,7 @@ func Get(url string, v any) (*response, error) {
 	}
 
 	// build the custom fetch response
-	response := response{
+	response := Response{
 		StatusCode: resp.StatusCode,
 	}
 

package/go/utils/logger/logger.go

@@ -6,7 +6,7 @@ import (
 	"os"
 )
 
-type loggerInterface interface {
+type Logger interface {
 	// Prints an info log message.
 	Info(v ...any)
 	// Prints a warning log message.
@@ -24,16 +24,13 @@ type logger struct {
 	error  *log.Logger
 }
 
-// A shared singleton log.
-var Log = New()
-
 // Creates a new logger.
-func New() loggerInterface {
-	return NewWithPrefix("")
+func NewLogger() Logger {
+	return NewLoggerWithPrefix("")
 }
 
 // Creates a new logger with a custom prefix.
-func NewWithPrefix(prefix string) loggerInterface {
+func NewLoggerWithPrefix(prefix string) Logger {
 	return &logger{
 		prefix: prefix,
 		info:   log.New(os.Stdout, "[INFO] ", log.LstdFlags),

package/go/utils/responder/models.go

@@ -0,0 +1,10 @@
+package responder
+
+// Base error struct.
+//
+// The struct should match the base "Error" schema in all services.
+type Error[T any] struct {
+	Status  int64  `json:"status"`
+	Code    T      `json:"code"`
+	Message string `json:"message"`
+}

package/go/utils/responder/response.go

@@ -0,0 +1,78 @@
+package responder
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+
+	"github.com/RivasCVA/dt-idl/go/utils/logger"
+)
+
+type Response[T any] interface {
+	Write(w http.ResponseWriter, status int, data any)
+	WriteError(w http.ResponseWriter, status int, message string)
+	WriteErrorWithCode(w http.ResponseWriter, status int, code T, message string)
+}
+
+type response[T any] struct {
+	log           logger.Logger
+	baseErrorCode T
+}
+
+func New[T any](log logger.Logger, baseErrorCode T) Response[T] {
+	return &response[T]{
+		log:           log,
+		baseErrorCode: baseErrorCode,
+	}
+}
+
+// Writes a JSON response to the given response writer.
+//
+// The given data is converted to JSON. An error response is written if the marshal fails.
+func (r *response[T]) Write(w http.ResponseWriter, status int, data any) {
+	// encode the given data object
+	out, err := json.Marshal(data)
+	if err != nil {
+		r.log.Error(fmt.Errorf("Write: failed to marshal the data: %w", err))
+		r.WriteError(w, http.StatusInternalServerError, "error encoding the data")
+		return
+	}
+
+	// write the data to the given writer
+	w.WriteHeader(status)
+	_, err = w.Write(out)
+	if err != nil {
+		r.log.Fatal(fmt.Errorf("Write: failed to write a response: %w", err))
+	}
+}
+
+// Writes a JSON error response to the given response writer.
+//
+// The response is based on the generated "api.Error" schema.
+func (r *response[T]) WriteError(w http.ResponseWriter, status int, message string) {
+	r.WriteErrorWithCode(w, status, r.baseErrorCode, message)
+}
+
+// Writes a JSON error response with a specific code to the given response writer.
+//
+// The code is based on the generated "api.ErrorCode" enum.
+//
+// The response is based on the generated "api.Error" schema.
+func (r *response[T]) WriteErrorWithCode(w http.ResponseWriter, status int, code T, message string) {
+	// encode an error object with the given message
+	out, err := json.Marshal(Error[T]{
+		Status:  int64(status),
+		Code:    code,
+		Message: message,
+	})
+	if err != nil {
+		r.log.Fatal(fmt.Errorf("WriteErrorWithCode: failed to marshal the error: %w", err))
+	}
+
+	// write the data to the given writer
+	w.WriteHeader(status)
+	_, err = w.Write(out)
+	if err != nil {
+		r.log.Fatal(fmt.Errorf("WriteErrorWithCode: failed to write a response: %w", err))
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivascva/dt-idl",
-  "version": "1.1.44",
+  "version": "1.1.46",
   "description": "Dream Trade - Interface Definition Language",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",