Merge branch 'main' into main

.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: 'gomod'
+    directory: '/'
+    schedule:
+      interval: 'monthly'
+      day: 'monday'
+    pull-request-branch-name:
+      separator: '-'
+    commit-message:
+      prefix: fix(deps)
+      prefix-development: fix(deps)
+    groups:
+      dependencies:
+        applies-to: version-updates
+        update-types:
+        - "minor"
+        - "patch"

README.md

@@ -12,6 +12,17 @@ A REST API wrapper for interacting with Salesforce using the Go programming lang
 - Read the [Salesforce REST API documentation](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_list.htm)
 - Read the [Golang documentation](https://go.dev/doc/)
 
+## Table of Contents
+- [Installation](#installation)
+- [Authentication](#authentication)
+- [SOQL](#soql)
+- [SObject Single Record Operations](#sobject-single-record-operations)
+- [SObject Collections](#sobject-collections)
+- [Composite Requests](#composite-requests)
+- [Bulk v2](#bulk-v2)
+- [Other](#other)
+- [Contributing](#contributing)
+
 ## Installation
 
 ```
@@ -93,6 +104,16 @@ if err != nil {
 }
 ```
 
+### GetAccessToken()
+
+`func (sf *Salesforce) GetAccessToken() string`
+
+Returns the current session's Access Token as a string.
+
+```go
+fmt.Println(sf.GetAccessToken())
+```
+
 ## SOQL
 
 Query Salesforce records
@@ -165,6 +186,29 @@ if err != nil {
 }
 ```
 
+### Handling Relationship Queries
+
+When querying Salesforce objects, it's common to access fields that are related through parent-child or lookup relationships. For instance, querying `Account.Name` with related `Contact` might look like this:
+
+##### Example SOQL Query
+```sql
+SELECT Id, Account.Name FROM Contact
+```
+
+#### Corresponding Go Structs
+To effectively handle the data returned by this query, define your Go structs as follows:
+
+```go
+type ContentDocumentLink struct {
+    Id       string
+    Account Account
+}
+
+type Account struct {
+    Name string
+}
+```
+
 ## SObject Single Record Operations
 
 Insert, Update, Upsert, or Delete one record at a time

go.mod

@@ -8,12 +8,12 @@ require github.com/forcedotcom/go-soql v0.0.0-20220705175410-00f698360bee
 
 require (
 	github.com/spf13/afero v1.11.0
-	k8s.io/apimachinery v0.29.4
+	k8s.io/apimachinery v0.30.2
 )
 
 require (
-	github.com/go-logr/logr v1.3.0 // indirect
+	github.com/go-logr/logr v1.4.1 // indirect
 	golang.org/x/text v0.14.0 // indirect
-	k8s.io/klog/v2 v2.110.1 // indirect
+	k8s.io/klog/v2 v2.120.1 // indirect
 	k8s.io/utils v0.0.0-20230726121419-3b25d923346b // indirect
 )

go.sum

@@ -1,8 +1,8 @@
 github.com/forcedotcom/go-soql v0.0.0-20220705175410-00f698360bee h1:UViGyUS6N3GdlALmKBczIi/mXrKkpQcZRyk0Hd5IqvU=
 github.com/forcedotcom/go-soql v0.0.0-20220705175410-00f698360bee/go.mod h1:bON16NgZr710tAa9hHPeSNoNihIEXDEbVWy6rKP6rL8=
 github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo=
-github.com/go-logr/logr v1.3.0 h1:2y3SDp0ZXuc6/cjLSZ+Q3ir+QB9T/iG5yYRXqsagWSY=
-github.com/go-logr/logr v1.3.0/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
+github.com/go-logr/logr v1.4.1 h1:pKouT5E8xu9zeFC39JXRDukb6JFQPXM5p5I91188VAQ=
+github.com/go-logr/logr v1.4.1/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
 github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
 github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
 github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
@@ -14,8 +14,8 @@ github.com/onsi/ginkgo v1.6.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+W
 github.com/onsi/ginkgo v1.10.3 h1:OoxbjfXVZyod1fmWYhI7SEyaD8B00ynP3T+D5GiyHOY=
 github.com/onsi/ginkgo v1.10.3/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE=
 github.com/onsi/gomega v1.7.1/go.mod h1:XdKZgCCFLUoM/7CFJVPcG8C1xQ1AJ0vpAezJrB7JYyY=
-github.com/onsi/gomega v1.29.0 h1:KIA/t2t5UBzoirT4H9tsML45GEbo3ouUnBHsCfD2tVg=
-github.com/onsi/gomega v1.29.0/go.mod h1:9sxs+SwGrKI0+PWe4Fxa9tFQQBG5xSsSbMXOI8PPpoQ=
+github.com/onsi/gomega v1.31.0 h1:54UJxxj6cPInHS3a35wm6BK/F9nHYueZ1NVujHDrnXE=
+github.com/onsi/gomega v1.31.0/go.mod h1:DW9aCi7U6Yi40wNVAvT6kzFnEVEI5n3DloYBiKiT6zk=
 github.com/spf13/afero v1.11.0 h1:WJQKhtpdm3v2IzqG8VMqrr6Rf3UYpEF239Jy9wNepM8=
 github.com/spf13/afero v1.11.0/go.mod h1:GH9Y3pIexgf1MTIWtNGyogA5MwRIDXGUr+hbWNoBjkY=
 golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
@@ -44,9 +44,9 @@ gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.2.7/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
-k8s.io/apimachinery v0.29.4 h1:RaFdJiDmuKs/8cm1M6Dh1Kvyh59YQFDcFuFTSmXes6Q=
-k8s.io/apimachinery v0.29.4/go.mod h1:i3FJVwhvSp/6n8Fl4K97PJEP8C+MM+aoDq4+ZJBf70Y=
-k8s.io/klog/v2 v2.110.1 h1:U/Af64HJf7FcwMcXyKm2RPM22WZzyR7OSpYj5tg3cL0=
-k8s.io/klog/v2 v2.110.1/go.mod h1:YGtd1984u+GgbuZ7e08/yBuAfKLSO0+uR1Fhi6ExXjo=
+k8s.io/apimachinery v0.30.2 h1:fEMcnBj6qkzzPGSVsAZtQThU62SmQ4ZymlXRC5yFSCg=
+k8s.io/apimachinery v0.30.2/go.mod h1:iexa2somDaxdnj7bha06bhb43Zpa6eWH8N8dbqVjTUc=
+k8s.io/klog/v2 v2.120.1 h1:QXU6cPEOIslTGvZaXvFWiP9VKyeet3sawzTOvdXb4Vw=
+k8s.io/klog/v2 v2.120.1/go.mod h1:3Jpz1GvMt720eyJH1ckRHK1EDfpxISzJ7I9OYgaDtPE=
 k8s.io/utils v0.0.0-20230726121419-3b25d923346b h1:sgn3ZU783SCgtaSJjpcVVlRqd6GSnlTLKgpAAttJvpI=
 k8s.io/utils v0.0.0-20230726121419-3b25d923346b/go.mod h1:OLgZIPagt7ERELqWJFomSt595RzquPNLL48iOWgYOg0=

salesforce.go

@@ -578,5 +578,8 @@ func (sf *Salesforce) GetJobResults(bulkJobId string) (BulkJobResults, error) {
 }
 
 func (sf *Salesforce) GetAccessToken() string {
+	if sf.auth == nil {
+		return ""
+	}
 	return sf.auth.AccessToken
 }

salesforce_test.go

@@ -2706,6 +2706,11 @@ func TestGetAccessToken(t *testing.T) {
 			sf:   sf,
 			want: "1234",
 		},
+		{
+			name: "no_access_token",
+			sf:   &Salesforce{},
+			want: "",
+		},
 	}
 
 	for _, tt := range tests {