feat: Adding variable collection support (#88)

* Bump github.com/hashicorp/terraform-plugin-docs from 0.18.0 to 0.19.4

Bumps [github.com/hashicorp/terraform-plugin-docs](https://github.com/hashicorp/terraform-plugin-docs) from 0.18.0 to 0.19.4.
- [Release notes](https://github.com/hashicorp/terraform-plugin-docs/releases)
- [Changelog](https://github.com/hashicorp/terraform-plugin-docs/blob/main/CHANGELOG.md)
- [Commits](hashicorp/terraform-plugin-docs@v0.18.0...v0.19.4)

---
updated-dependencies:
- dependency-name: github.com/hashicorp/terraform-plugin-docs
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>

* Update version

* feat: Adding collection support

* fix

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

docs/resources/collection.md

@@ -0,0 +1,27 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "terrakube_collection Resource - terrakube"
+subcategory: ""
+description: |-
+  Create a collection and bind it to an organization.
+---
+
+# terrakube_collection (Resource)
+
+Create a collection and bind it to an organization.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `description` (String) Collection description
+- `name` (String) Collection name
+- `organization_id` (String) Terrakube organization id
+- `priority` (Number) Collection priority
+
+### Read-Only
+
+- `id` (String) Collection Id

docs/resources/collection_item.md

@@ -0,0 +1,64 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "terrakube_collection_item Resource - terrakube"
+subcategory: ""
+description: |-
+  Create collection item that will be used by this workspace only.
+---
+
+# terrakube_collection_item (Resource)
+
+Create collection item that will be used by this workspace only.
+
+## Example Usage
+
+```terraform
+resource "terrakube_collection_item" "sample1" {
+  organization_id = data.terrakube_organization.org.id
+  collection_id   = terrakube_collection.sample1.id
+  key             = "sample-env-var"
+  value           = "sample-value2222"
+  description     = "sample env var"
+  category        = "ENV"
+  sensitive       = false
+  hcl             = false
+}
+
+resource "terrakube_collection_item" "sample2" {
+  organization_id = data.terrakube_organization.org.id
+  collection_id   = terrakube_collection.sample1.id
+  key             = "sample-terra-var"
+  value           = "sample-TERRAFORM"
+  description     = "sample env var"
+  category        = "TERRAFORM"
+  sensitive       = false
+  hcl             = false
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `category` (String) Variable category (ENV or TERRAFORM). ENV variables are injected in workspace environment at runtime.
+- `collection_id` (String) Terrakube collection id
+- `description` (String) Variable description
+- `hcl` (Boolean) Parse this field as HashiCorp Configuration Language (HCL). This allows you to interpolate values at runtime.
+- `key` (String) Variable key
+- `organization_id` (String) Terrakube organization id
+- `sensitive` (Boolean) Sensitive variables are never shown in the UI or API. They may appear in Terraform logs if your configuration is designed to output them.
+- `value` (String) Variable value
+
+### Read-Only
+
+- `id` (String) Collection Id
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+# Organization Workspace Variable can be import with organization_id,collection_id,id
+terraform import terrakube_workspace_variable.example 00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000
+```

docs/resources/collection_reference.md

@@ -0,0 +1,45 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "terrakube_collection_reference Resource - terrakube"
+subcategory: ""
+description: |-
+  Create collection reference that will be used by this workspace only.
+---
+
+# terrakube_collection_reference (Resource)
+
+Create collection reference that will be used by this workspace only.
+
+## Example Usage
+
+```terraform
+resource "terrakube_workspace_reference" "sample1" {
+  organization_id = data.terrakube_organization.org.id
+  collection_id   = terrakube_collection.sample1.id
+  workspace_id    = terrakube_workspace_cli.sample1.id
+  description     = "sample description"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `collection_id` (String) Terrakube collection id
+- `description` (String) Variable description
+- `organization_id` (String) Terrakube organization id
+- `workspace_id` (String) Terrakube workspace id
+
+### Read-Only
+
+- `id` (String) Reference Id
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+# Organization Workspace Variable can be import with organization_id,collection_id,workspace_id,id
+terraform import terrakube_workspace_variable.example 00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000,,00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000
+```

docs/resources/workspace_vcs.md

@@ -37,7 +37,6 @@ resource "terrakube_workspace_vcs" "sample1" {
 - `organization_id` (String) Terrakube organization id
 - `repository` (String) Workspace VCS repository
 - `template_id` (String) Default template ID for the workspace
-- `vcs_id` (String) VCS connection ID for private workspaces
 
 ### Optional
 
@@ -46,6 +45,7 @@ resource "terrakube_workspace_vcs" "sample1" {
 - `execution_mode` (String) Workspace VCS execution mode (remote or local)
 - `folder` (String) Workspace VCS folder
 - `iac_type` (String) Workspace VCS IaC type (Supported values terraform or tofu)
+- `vcs_id` (String) VCS connection ID for private workspaces
 
 ### Read-Only
 

examples/resources/terrakube_collection_item/import.sh

@@ -0,0 +1,2 @@
+# Organization Workspace Variable can be import with organization_id,collection_id,id
+terraform import terrakube_workspace_variable.example 00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000

examples/resources/terrakube_collection_item/resource.tf

@@ -0,0 +1,21 @@
+resource "terrakube_collection_item" "sample1" {
+  organization_id = data.terrakube_organization.org.id
+  collection_id   = terrakube_collection.sample1.id
+  key             = "sample-env-var"
+  value           = "sample-value2222"
+  description     = "sample env var"
+  category        = "ENV"
+  sensitive       = false
+  hcl             = false
+}
+
+resource "terrakube_collection_item" "sample2" {
+  organization_id = data.terrakube_organization.org.id
+  collection_id   = terrakube_collection.sample1.id
+  key             = "sample-terra-var"
+  value           = "sample-TERRAFORM"
+  description     = "sample env var"
+  category        = "TERRAFORM"
+  sensitive       = false
+  hcl             = false
+}

examples/resources/terrakube_collection_reference/import.sh

@@ -0,0 +1,2 @@
+# Organization Workspace Variable can be import with organization_id,collection_id,workspace_id,id
+terraform import terrakube_workspace_variable.example 00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000,,00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000

examples/resources/terrakube_collection_reference/resource.tf

@@ -0,0 +1,6 @@
+resource "terrakube_workspace_reference" "sample1" {
+  organization_id = data.terrakube_organization.org.id
+  collection_id   = terrakube_collection.sample1.id
+  workspace_id    = terrakube_workspace_cli.sample1.id
+  description     = "sample description"
+}

examples/resources/terrakube_organization_collection/import.sh

@@ -0,0 +1,2 @@
+# Collection can be import with organization_id,id
+terraform import terrakube_collection.example 00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000000

examples/resources/terrakube_organization_collection/resource.tf

@@ -0,0 +1,6 @@
+resource "terrakube_collection" "collection" {
+  name            = "TERRAKUBE_SUPER_COLLECTION"
+  organization_id = data.terrakube_organization.org.id
+  description     = "Hello World!"
+  priority        = 10
+}

internal/client/client.go

@@ -114,8 +114,32 @@ type ModuleEntity struct {
 	Source      string     `jsonapi:"attr,source"`
 	Vcs         *VcsEntity `jsonapi:"relation,vcs,omitempty"`
 	Ssh         *SshEntity `jsonapi:"relation,ssh,omitempty"`
-	Folder      string     `jsonapi:"attr,folder"`
-	TagPrefix   string     `jsonapi:"attr,tagPrefix"`
+	Folder      *string    `jsonapi:"attr,folder"`
+	TagPrefix   *string    `jsonapi:"attr,tagPrefix"`
+}
+
+type CollectionEntity struct {
+	ID          string `jsonapi:"primary,collection"`
+	Name        string `jsonapi:"attr,name"`
+	Description string `jsonapi:"attr,description"`
+	Priority    int32  `jsonapi:"attr,priority"`
+}
+
+type CollectionItemEntity struct {
+	ID          string `jsonapi:"primary,item"`
+	Key         string `jsonapi:"attr,key"`
+	Value       string `jsonapi:"attr,value"`
+	Description string `jsonapi:"attr,description"`
+	Category    string `jsonapi:"attr,category"`
+	Sensitive   bool   `jsonapi:"attr,sensitive"`
+	Hcl         bool   `jsonapi:"attr,hcl"`
+}
+
+type CollectionReferenceEntity struct {
+	ID          string            `jsonapi:"primary,reference"`
+	Description string            `jsonapi:"attr,description"`
+	Workspace   *WorkspaceEntity  `jsonapi:"relation,workspace,omitempty"`
+	Collection  *CollectionEntity `jsonapi:"relation,collection,omitempty"`
 }
 
 type WorkspaceWebhookEntity struct {