[SM-1214] Add secrets syncing support to Go (#742)

## Type of change

<!-- (mark with an `X`) -->

```
- [ ] Bug fix
- [X] New feature development
- [ ] Tech debt (refactoring, code cleanup, dependency upgrades, etc)
- [ ] Build/deploy pipeline (DevOps)
- [ ] Other
```

## Objective

<!--Describe what the purpose of this PR is. For example: what bug
you're fixing or what new feature you're adding-->
Expose secret syncing to the Go language wrapper.

## Code changes

<!--Explain the changes you've made to each file or major component.
This should help the reviewer understand your changes-->
<!--Also refer to any related changes or PRs in other repositories-->

- **crates/bitwarden-json/src/client.rs:** 
**crates/bitwarden-json/src/command.rs:** 
**crates/sdk-schemas/src/main.rs:** 
Expose secrets sync in schemas


- **languages/go/README.md:**
**languages/go/secrets.go:**
Add secrets sync in Go language wrapper.

## Before you submit

- Please add **unit tests** where it makes sense to do so

crates/bitwarden-json/src/client.rs

@@ -73,6 +73,7 @@ impl Client {
                 SecretsCommand::List(req) => client.secrets().list(&req).await.into_string(),
                 SecretsCommand::Update(req) => client.secrets().update(&req).await.into_string(),
                 SecretsCommand::Delete(req) => client.secrets().delete(req).await.into_string(),
+                SecretsCommand::Sync(req) => client.secrets().sync(&req).await.into_string(),
             },
 
             #[cfg(feature = "secrets")]

crates/bitwarden-json/src/command.rs

@@ -8,7 +8,7 @@ use bitwarden::{
         },
         secrets::{
             SecretCreateRequest, SecretGetRequest, SecretIdentifiersRequest, SecretPutRequest,
-            SecretsDeleteRequest, SecretsGetRequest,
+            SecretsDeleteRequest, SecretsGetRequest, SecretsSyncRequest,
         },
     },
 };
@@ -123,6 +123,16 @@ pub enum SecretsCommand {
     ///
     /// Returns: [SecretsDeleteResponse](bitwarden::secrets_manager::secrets::SecretsDeleteResponse)
     Delete(SecretsDeleteRequest),
+
+    /// > Requires Authentication
+    /// > Requires using an Access Token for login
+    /// Retrieve the secrets accessible by the authenticated machine account
+    /// Optionally, provide the last synced date to assess whether any changes have occurred
+    /// If changes are detected, retrieves all the secrets accessible by the authenticated machine
+    /// account
+    ///
+    /// Returns: [SecretsSyncResponse](bitwarden::secrets_manager::secrets::SecretsSyncResponse)
+    Sync(SecretsSyncRequest),
 }
 
 #[cfg(feature = "secrets")]

crates/sdk-schemas/src/main.rs

@@ -104,6 +104,7 @@ struct SchemaTypes {
     secret: Response<bitwarden::secrets_manager::secrets::SecretResponse>,
     secrets: Response<bitwarden::secrets_manager::secrets::SecretsResponse>,
     secrets_delete: Response<bitwarden::secrets_manager::secrets::SecretsDeleteResponse>,
+    secrets_sync: Response<bitwarden::secrets_manager::secrets::SecretsSyncResponse>,
     project: Response<bitwarden::secrets_manager::projects::ProjectResponse>,
     projects: Response<bitwarden::secrets_manager::projects::ProjectsResponse>,
     projects_delete: Response<bitwarden::secrets_manager::projects::ProjectsDeleteResponse>,

languages/go/README.md

@@ -100,6 +100,15 @@ secret, err := client.Secrets.Update("secret_id", "new_key", "new_value", "new_n
 secret, err := client.Secrets.Delete([]string{"secret_id_1", "secret_id_2"})
 ```
 
+#### Secrets Sync
+
+```go
+secretsSync, err := client.Secrets.Sync("organization_id", nil)
+
+lastSyncedDate := time.Now()
+secretsSync, err := client.Secrets.Sync("organization_id", lastSyncedDate)
+```
+
 ---
 
 ### Close Client

languages/go/secrets.go

@@ -1,12 +1,15 @@
 package sdk
 
+import "time"
+
 type SecretsInterface interface {
 	Create(key, value, note string, organizationID string, projectIDs []string) (*SecretResponse, error)
 	List(organizationID string) (*SecretIdentifiersResponse, error)
 	Get(secretID string) (*SecretResponse, error)
 	GetByIDS(secretIDs []string) (*SecretsResponse, error)
 	Update(secretID string, key, value, note string, organizationID string, projectIDs []string) (*SecretResponse, error)
 	Delete(secretIDs []string) (*SecretsDeleteResponse, error)
+	Sync(organizationID string, lastSyncedDate *time.Time) (*SecretsSyncResponse, error)
 }
 
 type Secrets struct {
@@ -129,3 +132,26 @@ func (s *Secrets) Delete(ids []string) (*SecretsDeleteResponse, error) {
 	}
 	return &response, nil
 }
+
+func (s *Secrets) Sync(organizationID string, lastSyncedDate *time.Time) (*SecretsSyncResponse, error) {
+	var lastSyncedDateString *string
+	if lastSyncedDate != nil {
+		tempRfc3339 := lastSyncedDate.UTC().Format(time.RFC3339)
+		lastSyncedDateString = &tempRfc3339
+	}
+
+	command := Command{
+		Secrets: &SecretsCommand{
+			Sync: &SecretsSyncRequest{
+				OrganizationID: organizationID,
+				LastSyncedDate: lastSyncedDateString,
+			},
+		},
+	}
+
+	var response SecretsSyncResponse
+	if err := s.executeCommand(command, &response); err != nil {
+		return nil, err
+	}
+	return &response, nil
+}