fix: S3 connector field is computed_optional

- Updated 'recursive' field as computed_optional for S3 connector in provider-code-spec.json and destination resource schema.
- Updated documentation to reflect changes in API key handling and added examples for source, destination, and workflow resources.
- Ensured consistency in example configurations across various documentation files.

Author: aws-gopher

docs/index.md

@@ -13,11 +13,11 @@ description: |-
 
 ```terraform
 provider "unstructured" {
-  # this is not a real key, but shown to demonstrate the length and pattern that Unstructured uses
-  api_key = "TlMPUit8RRpouMypm2vQat1ViC1kvk"
+  # API key should be set via environment variable UNSTRUCTURED_API_KEY
+  # api_key = "your-api-key-here"
 
-  # this is the default base URL, but can be overridden if needed
-  base_url = "https://platform.unstructuredapp.io/api/v1"
+  # Endpoint can be overridden if needed, defaults to https://platform.unstructuredapp.io/api/v1
+  # endpoint = "https://platform.unstructuredapp.io/api/v1"
 }
 ```
 

docs/resources/destination.md

@@ -16,7 +16,7 @@ description: |-
 resource "unstructured_destination" "example" {
   name = "example_s3_destination"
 
-  s3 {
+  s3 = {
     remote_url = "s3://my-destination-bucket/"
     key        = "aws-access-key-id"
     secret     = "aws-secret-access-key"
@@ -364,6 +364,7 @@ Optional:
 - `anonymous` (Boolean)
 - `endpoint_url` (String)
 - `key` (String)
+- `recursive` (Boolean)
 - `secret` (String)
 - `token` (String)
 

docs/resources/source.md

@@ -16,7 +16,7 @@ description: |-
 resource "unstructured_source" "example" {
   name = "example_s3_source"
 
-  s3 {
+  s3 = {
     remote_url = "s3://my-source-bucket/"
     recursive  = true
     anonymous  = true

examples/provider/provider.tf

@@ -1,7 +1,7 @@
 provider "unstructured" {
-  # this is not a real key, but shown to demonstrate the length and pattern that Unstructured uses
-  api_key = "TlMPUit8RRpouMypm2vQat1ViC1kvk"
+  # API key should be set via environment variable UNSTRUCTURED_API_KEY
+  # api_key = "your-api-key-here"
 
-  # this is the default base URL, but can be overridden if needed
-  base_url = "https://platform.unstructuredapp.io/api/v1"
+  # Endpoint can be overridden if needed, defaults to https://platform.unstructuredapp.io/api/v1
+  # endpoint = "https://platform.unstructuredapp.io/api/v1"
 }

examples/resources/unstructured_destination/resource.tf

@@ -1,7 +1,7 @@
 resource "unstructured_destination" "example" {
   name = "example_s3_destination"
 
-  s3 {
+  s3 = {
     remote_url = "s3://my-destination-bucket/"
     key        = "aws-access-key-id"
     secret     = "aws-secret-access-key"

examples/resources/unstructured_source/resource.tf

@@ -1,7 +1,7 @@
 resource "unstructured_source" "example" {
   name = "example_s3_source"
 
-  s3 {
+  s3 = {
     remote_url = "s3://my-source-bucket/"
     recursive  = true
     anonymous  = true

examples/resources/unstructured_workflow/workflow_only.tf

@@ -0,0 +1,65 @@
+# Example workflow resource (assumes source and destination already exist)
+resource "unstructured_workflow" "example" {
+  name          = "example_workflow"
+  workflow_type = "basic"
+
+  # These IDs should reference existing source and destination resources
+  source_id      = "existing-source-id"
+  destination_id = "existing-destination-id"
+
+  workflow_nodes {
+    name    = "Partitioner"
+    type    = "partition"
+    subtype = "vlm"
+    settings = {
+      "provider"           = "anthropic"
+      "provider_api_key"   = null
+      "model"              = "claude-3-5-sonnet-20241022"
+      "output_format"      = "text/html"
+      "prompt"             = null
+      "format_html"        = true
+      "unique_element_ids" = true
+      "is_dynamic"         = true
+      "allow_fast"         = true
+    }
+  }
+
+  workflow_nodes {
+    name    = "Image summarizer"
+    type    = "prompter"
+    subtype = "openai_image_description"
+  }
+
+  workflow_nodes {
+    name    = "Table summarizer"
+    type    = "prompter"
+    subtype = "anthropic_table_description"
+  }
+
+  workflow_nodes {
+    name    = "Chunker"
+    type    = "chunk"
+    subtype = "chunk_by_title"
+    settings = {
+      "unstructured_api_url"         = null
+      "unstructured_api_key"         = null
+      "multipage_sections"           = false
+      "combine_text_under_n_chars"   = 0
+      "include_orig_elements"        = false
+      "new_after_n_chars"            = 1500
+      "max_characters"               = 2048
+      "overlap"                      = 160
+      "overlap_all"                  = false
+      "contextual_chunking_strategy" = "v1"
+    }
+  }
+
+  workflow_nodes {
+    name    = "Embedder"
+    type    = "embed"
+    subtype = "azure_openai"
+    settings = {
+      "model_name" = "text-embedding-3-large"
+    }
+  }
+} 

internal/resource_destination/destination_resource_gen.go

@@ -585,11 +585,12 @@
 					]}},
 					{ "name": "s3", "single_nested": { "computed_optional_required": "optional", "attributes": [
 						{ "name": "remote_url", "string": { "computed_optional_required": "required" } },
-						{ "name": "anonymous", "bool": { "computed_optional_required": "optional" } },
+						{ "name": "anonymous", "bool": { "computed_optional_required": "computed_optional" } },
 						{ "name": "key", "string": { "computed_optional_required": "optional" } },
 						{ "name": "secret", "string": { "computed_optional_required": "optional" } },
 						{ "name": "token", "string": { "computed_optional_required": "optional" } },
-						{ "name": "endpoint_url", "string": { "computed_optional_required": "optional" } }
+						{ "name": "endpoint_url", "string": { "computed_optional_required": "optional" } },
+						{ "name": "recursive", "bool": { "computed_optional_required": "computed_optional" } }
 					]}},
 					{ "name": "snowflake", "single_nested": { "computed_optional_required": "optional", "attributes": [
 						{ "name": "account", "string": { "computed_optional_required": "required" } },