chore(release): 0.5.1 [skip ci]

## [0.5.1](https://git.debyl.io/debyltech/go-snipcart/compare/v0.5.0...v0.5.1) (2026-01-03)

### Bug Fixes

* migrate semantic-release from GitHub to Gitea ([3b19919](3b1991970b))
* remove persist-credentials to allow semantic-release push ([a8646a6](a8646a6d52))

.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 'lts/*'
+
+      - name: Install semantic-release
+        run: |
+          npm install -g semantic-release \
+            @semantic-release/commit-analyzer \
+            @semantic-release/release-notes-generator \
+            @semantic-release/changelog \
+            @saithodev/semantic-release-gitea \
+            @semantic-release/git
+
+      - name: Release
+        env:
+          # Use Gitea's automatic token (requires contents: write permission above)
+          GITEA_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GIT_AUTHOR_NAME: gitea-actions[bot]
+          GIT_AUTHOR_EMAIL: gitea-actions[bot]@users.noreply.git.debyl.io
+          GIT_COMMITTER_NAME: gitea-actions[bot]
+          GIT_COMMITTER_EMAIL: gitea-actions[bot]@users.noreply.git.debyl.io
+        run: npx semantic-release

.gitignore

@@ -1,3 +1,4 @@
 *.json
+!.releaserc.json
 *.sum
 config/*

.releaserc.json

@@ -0,0 +1,44 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    [
+      "@semantic-release/commit-analyzer",
+      {
+        "preset": "angular",
+        "releaseRules": [
+          {"message": "*#patch*", "release": "patch"},
+          {"message": "*#minor*", "release": "minor"},
+          {"message": "*#major*", "release": "major"},
+          {"type": "fix", "release": "patch"},
+          {"type": "feat", "release": "minor"},
+          {"type": "perf", "release": "patch"}
+        ]
+      }
+    ],
+    [
+      "@semantic-release/release-notes-generator",
+      {
+        "preset": "angular"
+      }
+    ],
+    [
+      "@semantic-release/changelog",
+      {
+        "changelogFile": "CHANGELOG.md"
+      }
+    ],
+    [
+      "@saithodev/semantic-release-gitea",
+      {
+        "giteaUrl": "https://git.debyl.io"
+      }
+    ],
+    [
+      "@semantic-release/git",
+      {
+        "assets": ["CHANGELOG.md"],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ]
+  ]
+}

CHANGELOG.md

@@ -0,0 +1,14 @@
+## [0.5.1](https://git.debyl.io/debyltech/go-snipcart/compare/v0.5.0...v0.5.1) (2026-01-03)
+
+
+### Bug Fixes
+
+* migrate semantic-release from GitHub to Gitea ([3b19919](https://git.debyl.io/debyltech/go-snipcart/commit/3b1991970b64ac8c983006d4cf18bc6e080d6511))
+* remove persist-credentials to allow semantic-release push ([a8646a6](https://git.debyl.io/debyltech/go-snipcart/commit/a8646a6d5258435b26a052ad57136032bb949ec7))
+
+# [0.5.0](https://git.debyl.io/debyltech/go-snipcart/compare/v0.4.1...v0.5.0) (2026-01-02)
+
+
+### Features
+
+* add discount and savings fields to Order struct ([043da74](https://git.debyl.io/debyltech/go-snipcart/commit/043da741fafd24e3fb0bddbe06880c81c1b64b1f))

example_get_orders_by.go

@@ -0,0 +1,31 @@
+package main
+
+import (
+	"flag"
+	"log"
+
+	"github.com/debyltech/go-snipcart/snipcart"
+)
+
+func main() {
+	snipcartApiKey := flag.String("key", "", "Snipcart API Key")
+	flag.Parse()
+
+	if *snipcartApiKey == "" {
+		log.Fatal("missing -key flag")
+	}
+
+	Client := snipcart.NewClient(*snipcartApiKey)
+
+	response, err := Client.GetOrders(map[string]string{
+		"placedBy": "bastian@bdebyl.net",
+	})
+	if err != nil {
+		log.Fatal(err)
+	}
+	log.Println("no errors continuing")
+
+	for k, v := range response.Items {
+		log.Printf("%v: %v\n", k, v)
+	}
+}

example_update_order.go

@@ -0,0 +1,32 @@
+package main
+
+import (
+	"flag"
+	"log"
+
+	"github.com/debyltech/go-snipcart/snipcart"
+)
+
+func main() {
+	snipcartApiKey := flag.String("key", "", "Snipcart API Key")
+	flag.Parse()
+
+	if *snipcartApiKey == "" {
+		log.Fatal("missing -key flag")
+	}
+
+	Client := snipcart.NewClient(*snipcartApiKey)
+
+	updateOrder := snipcart.SnipcartOrderUpdate{
+		ShippingRateId: "b1f5a5bca34d4e9ea7a55c011b22644f;5677a809435d46cbbb5dda2485295326",
+	}
+
+	response, err := Client.UpdateOrder("e6e72c95-31df-4594-b9a3-8603ce3914c8", &updateOrder)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	for k, v := range response.Items {
+		log.Printf("%v: %v\n", k, v)
+	}
+}

go.mod

@@ -3,7 +3,7 @@ module github.com/debyltech/go-snipcart
 go 1.19
 
 require (
-	github.com/debyltech/go-helpers v1.1.0
+	github.com/debyltech/go-helpers v1.1.1
 	github.com/debyltech/go-shippr v0.1.0
 	github.com/skip2/go-qrcode v0.0.0-20200617195104-da1b6568686e
 )

snipcart/common.go

@@ -12,6 +12,8 @@ var (
 	orderUri      = apiUri + ordersPath
 	productsUri   = apiUri + productsPath
 	validationUri = apiUri + validationPath
+
+	orderNotificationPath = "notifications"
 )
 
 type Address struct {
@@ -37,6 +39,9 @@ type Client struct {
 }
 
 type CustomField struct {
-	Name  string `json:"name"`
+	Name     string `json:"name"`
-	Value string `json:"value"`
+	Value    string `json:"value"`
+	Type     string `json:"type,omitempty"`
+	Options  string `json:"options,omitempty"`
+	Required bool   `json:"required"`
 }

snipcart/enums.go

@@ -5,16 +5,16 @@ type NotificationType string
 
 const (
 	Processed  OrderStatus = "Processed"
-	Disputed               = "Disputed"
+	Disputed   OrderStatus = "Disputed"
-	Shipped                = "Shipped"
+	Shipped    OrderStatus = "Shipped"
-	Delivered              = "Delivered"
+	Delivered  OrderStatus = "Delivered"
-	Pending                = "Pending"
+	Pending    OrderStatus = "Pending"
-	Cancelled              = "Cancelled"
+	Cancelled  OrderStatus = "Cancelled"
-	Dispatched             = "Dispatched"
+	Dispatched OrderStatus = "Dispatched"
 
 	Comment            NotificationType = "Comment"
-	OrderStatusChanged                  = "OrderStatusChanged"
+	OrderStatusChanged NotificationType = "OrderStatusChanged"
-	OrderShipped                        = "OrderShipped"
+	OrderShipped       NotificationType = "OrderShipped"
-	TrackingNumber                      = "TrackingNumber"
+	TrackingNumber     NotificationType = "TrackingNumber"
-	Invoice                             = "Invice"
+	Invoice            NotificationType = "Invice"
 )

snipcart/snipcart.go

@@ -26,35 +26,90 @@ type Item struct {
 	Shippable    bool          `json:"shippable,omitempty"`
 }
 
+type Discount struct {
+	ID                       string   `json:"id"`
+	DiscountID               string   `json:"discountId"`
+	Name                     string   `json:"name"`
+	Code                     string   `json:"code,omitempty"`
+	Trigger                  string   `json:"trigger,omitempty"`
+	Type                     string   `json:"type,omitempty"`
+	Rate                     float64  `json:"rate,omitempty"`
+	Amount                   float64  `json:"amount,omitempty"`
+	AmountSaved              float64  `json:"amountSaved,omitempty"`
+	NormalizedRate           float64  `json:"normalizedRate,omitempty"`
+	Combinable               bool     `json:"combinable"`
+	HasSavedAmount           bool     `json:"hasSavedAmount"`
+	MaxDiscountsPerItem      *int     `json:"maxDiscountsPerItem,omitempty"`
+	TotalToReach             *float64 `json:"totalToReach,omitempty"`
+	ProductIds               string   `json:"productIds,omitempty"`
+	Categories               string   `json:"categories,omitempty"`
+	NumberOfUsages           int      `json:"numberOfUsages,omitempty"`
+	AppliesOnAllRecurring    bool     `json:"appliesOnAllRecurringOrders"`
+	CreationDate             string   `json:"creationDate,omitempty"`
+	ModificationDate         string   `json:"modificationDate,omitempty"`
+}
+
+type OrderTax struct {
+	Name             string  `json:"taxName"`
+	Rate             float64 `json:"taxRate"`
+	Amount           float64 `json:"amount"`
+	NumberForInvoice string  `json:"numberForInvoice"`
+}
+
+type OrderNotification struct {
+	Id             string           `json:"id"`
+	Created        time.Time        `json:"creationDate"`
+	Type           NotificationType `json:"type"`
+	DeliveryMethod string           `json:"deliveryMethod"`
+	Message        string           `json:"message,omitempty"`
+	SendDate       time.Time        `json:"sentOn,omitempty"`
+	Subject        string           `json:"subject,omitempty"`
+}
+
+type OrderNotifications struct {
+	TotalNotifications int                 `json:"totalItems"`
+	Offset             int                 `json:"offset"`
+	Limit              int                 `json:"limit"`
+	Notifications      []OrderNotification `json:"items"`
+}
+
 type Order struct {
-	Token            string    `json:"token"`
+	Token                        string     `json:"token"`
-	Created          time.Time `json:"creationDate"`
+	Created                      time.Time  `json:"creationDate"`
-	Modified         time.Time `json:"modificationDate"`
+	Modified                     time.Time  `json:"modificationDate"`
-	Invoice          string    `json:"invoiceNumber"`
+	Completed                    time.Time  `json:"completionDate"`
-	Subtotal         float64   `json:"subtotal,omitempty"`
+	Invoice                      string     `json:"invoiceNumber"`
-	Currency         string    `json:"currency,omitempty"`
+	Subtotal                     float64    `json:"subtotal,omitempty"`
-	Total            float64   `json:"grandTotal,omitempty"`
+	Currency                     string     `json:"currency,omitempty"`
-	Status           string    `json:"status"`
+	Total                        float64    `json:"grandTotal,omitempty"`
-	TotalWeight      float64   `json:"totalWeight"`
+	TotalTaxable                 float64    `json:"taxableTotal,omitempty"`
-	ShippingAddress  Address   `json:"shippingAddress,omitempty"`
+	TotalTaxes                   float64    `json:"taxesTotal,omitempty"`
-	Name             string    `json:"shippingAddressName,omitempty"`
+	Status                       string     `json:"status"`
-	Company          string    `json:"shippingAddressCompanyName,omitempty"`
+	TotalWeight                  float64    `json:"totalWeight"`
-	Address1         string    `json:"shippingAddressAddress1,omitempty"`
+	ShippingAddressSameAsBilling bool       `json:"shippingAddressSameAsBilling,omitempty"`
-	Address2         string    `json:"shippingAddressAddress2,omitempty"`
+	ShippingAddress              Address    `json:"shippingAddress,omitempty"`
-	City             string    `json:"shippingAddressCity,omitempty"`
+	Name                         string     `json:"shippingAddressName,omitempty"`
-	Province         string    `json:"shippingAddressProvince,omitempty"`
+	Company                      string     `json:"shippingAddressCompanyName,omitempty"`
-	Country          string    `json:"shippingAddressCountry,omitempty"`
+	Address1                     string     `json:"shippingAddressAddress1,omitempty"`
-	PostalCode       string    `json:"shippingAddressPostalCode,omitempty"`
+	Address2                     string     `json:"shippingAddressAddress2,omitempty"`
-	Phone            string    `json:"shippingAddressPhone,omitempty"`
+	City                         string     `json:"shippingAddressCity,omitempty"`
-	Email            string    `json:"email,omitempty"`
+	Province                     string     `json:"shippingAddressProvince,omitempty"`
-	TrackingNumber   string    `json:"trackingNumber"`
+	Country                      string     `json:"shippingAddressCountry,omitempty"`
-	TrackingUrl      string    `json:"trackingUrl"`
+	PostalCode                   string     `json:"shippingAddressPostalCode,omitempty"`
-	ShippingCost     float64   `json:"shippingFees"`
+	Phone                        string     `json:"shippingAddressPhone,omitempty"`
-	ShippingProvider string    `json:"shippingProvider,omitempty"`
+	Email                        string     `json:"email,omitempty"`
-	ShippingMethod   string    `json:"shippingMethod,omitempty"`
+	TrackingNumber               string     `json:"trackingNumber"`
-	ShippingRateId   string    `json:"shippingRateUserDefinedId,omitempty"`
+	TrackingUrl                  string     `json:"trackingUrl"`
-	Items            []Item    `json:"items"`
+	ShippingCost                 float64    `json:"shippingFees"`
-	Metadata         any       `json:"metadata"`
+	ShippingProvider             string     `json:"shippingProvider,omitempty"`
+	ShippingMethod               string     `json:"shippingMethod,omitempty"`
+	ShippingRateId               string     `json:"shippingRateUserDefinedId,omitempty"`
+	Discounts                    []Discount `json:"discounts,omitempty"`
+	SavedAmount                  float64    `json:"savedAmount,omitempty"`
+	TotalRebateRate              float64    `json:"totalRebateRate,omitempty"`
+	Items                        []Item     `json:"items"`
+	Taxes                        []OrderTax `json:"taxes,omitempty"`
+	Metadata                     any        `json:"metadata"`
 }
 
 type OrderUpdate struct {
@@ -68,6 +123,8 @@ type OrderUpdate struct {
 
 type Orders struct {
 	TotalItems int
+	Offest     int
+	Limit      int
 	Items      []Order
 }
 
@@ -159,6 +216,26 @@ func (s *Client) GetOrder(token string) (*Order, error) {
 	return &order, nil
 }
 
+func (s *Client) GetOrderNotifications(token string) (*OrderNotifications, error) {
+	response, err := helper.Get(orderUri+"/"+token+"/"+orderNotificationPath, "Basic", s.AuthBase64, nil)
+	if err != nil {
+		return nil, err
+	}
+	if response.StatusCode < 200 && response.StatusCode >= 300 {
+		return nil, fmt.Errorf("unexpected response received: %s", response.Status)
+	}
+
+	defer response.Body.Close()
+
+	var notifications OrderNotifications
+	err = json.NewDecoder(response.Body).Decode(&notifications)
+	if err != nil {
+		return nil, err
+	}
+
+	return &notifications, nil
+}
+
 func (s *Client) GetOrders(queries map[string]string) (*Orders, error) {
 	response, err := helper.Get(orderUri, "Basic", s.AuthBase64, queries)
 	if err != nil {

snipcart/webhook.go

@@ -4,17 +4,25 @@ import (
 	"encoding/base64"
 	"fmt"
 	"net/http"
-	"time"
 )
 
+type ShippingError struct {
+	Key     string `json:"key"`
+	Message string `json:"message"`
+}
+
+type ShippingErrors struct {
+	Errors []ShippingError `json:"errors"`
+}
+
 type TaxShippingInfo struct {
 	Fees   float64 `json:"fees"`
 	Method string  `json:"method"`
 }
 
 type TaxContent struct {
-	Created              time.Time       `json:"creationDate"`
+	Created              int             `json:"creationDate"`
-	Modified             time.Time       `json:"modificationDate"`
+	Modified             int             `json:"modificationDate"`
 	Token                string          `json:"token"`
 	Email                string          `json:"email"`
 	ShipToBillingAddress bool            `json:"shipToBillingAddress"`
@@ -38,6 +46,10 @@ type TaxContent struct {
 	Metadata             any             `json:"metadata"`
 }
 
+type TaxWebhook struct {
+	Content TaxContent `json:"content"`
+}
+
 type Tax struct {
 	Name             string  `json:"name"`
 	Amount           float64 `json:"amount"`