feat: add webhook provider

.github/workflows/speakeasy_sdk_generation.yml

@@ -16,7 +16,7 @@ jobs:
     with:
       speakeasy_version: latest
       openapi_docs: |
-        - https://docs.api.epilot.io/file.yaml
+        - https://docs.api.epilot.io/webhooks.yaml
       overlay_docs: |
         - ./overlay.yaml
       languages: |

Makefile

@@ -2,8 +2,8 @@
 all: speakeasy docs
 
 original.yaml:
-# curl https://docs.api.epilot.io/file.yaml > original.yaml
-	cp openapi.yml original.yaml
+	curl https://docs.api.epilot.io/webhooks.yaml > original.yaml
+
 
 original_modified.yaml: original.yaml overlay.yaml
 	speakeasy overlay apply -s original.yaml -o overlay.yaml > original_modified.yaml
@@ -13,7 +13,7 @@ overlay.yaml:
 
 speakeasy:
 	$(eval TMP := $(shell mktemp -d))
-# curl https://docs.api.epilot.io/file.yaml > $(TMP)/openapi.yaml
+# curl https://docs.api.epilot.io/webhooks.yaml > $(TMP)/openapi.yaml
 	cp openapi.yml $(TMP)/openapi.yaml
 	speakeasy overlay apply -s $(TMP)/openapi.yaml -o overlay.yaml > $(TMP)/final.yaml
 	speakeasy generate sdk --lang terraform -o . -s $(TMP)/final.yaml

README.md

@@ -49,8 +49,8 @@ TF_REATTACH_PROVIDERS=... terraform apply
 
 <!-- End SDK <no value> -->
 
-<!-- Start SDK Installation [installation] -->
-## SDK Installation
+<!-- Start Installation [installation] -->
+## Installation
 
 To install this provider, copy and paste this code into your Terraform configuration. Then, run `terraform init`.
 
@@ -59,7 +59,7 @@ terraform {
   required_providers {
     epilot-webhook = {
       source  = "epilot-dev/epilot-webhook"
-      version = "0.4.0"
+      version = "0.5.1"
     }
   }
 }
@@ -68,19 +68,17 @@ provider "epilot-webhook" {
   # Configuration options
 }
 ```
-<!-- End SDK Installation [installation] -->
+<!-- End Installation [installation] -->
 
-<!-- Start SDK Example Usage [usage] -->
-## SDK Example Usage
+<!-- Start Testing the provider locally [usage] -->
+## Testing the provider locally
 
-### Testing the provider locally
+#### Local Provider
 
 Should you want to validate a change locally, the `--debug` flag allows you to execute the provider against a terraform instance locally.
 
 This also allows for debuggers (e.g. delve) to be attached to the provider.
 
-### Example
-
 ```sh
 go run main.go --debug
 # Copy the TF_REATTACH_PROVIDERS env var
@@ -89,13 +87,55 @@ cd examples/your-example
 TF_REATTACH_PROVIDERS=... terraform init
 TF_REATTACH_PROVIDERS=... terraform apply
 ```
-<!-- End SDK Example Usage [usage] -->
 
-<!-- Start Available Resources and Operations [operations] -->
-## Available Resources and Operations
+#### Compiled Provider
+
+Terraform allows you to use local provider builds by setting a `dev_overrides` block in a configuration file called `.terraformrc`. This block overrides all other configured installation methods.
+
+1. Execute `go build` to construct a binary called `terraform-provider-epilot-webhook`
+2. Ensure that the `.terraformrc` file is configured with a `dev_overrides` section such that your local copy of terraform can see the provider binary
+
+Terraform searches for the `.terraformrc` file in your home directory and applies any configuration settings you set.
+
+```
+provider_installation {
+
+  dev_overrides {
+      "registry.terraform.io/epilot-dev/epilot-webhook" = "<PATH>"
+  }
+
+  # For all other providers, install them directly from their origin provider
+  # registries as normal. If you omit this, Terraform will _only_ use
+  # the dev_overrides block, and so no other providers will be available.
+  direct {}
+}
+```
+<!-- End Testing the provider locally [usage] -->
+
+<!-- Start Available Resources and Data Sources [operations] -->
+## Available Resources and Data Sources
+
+### Resources
+
+* [epilot-webhook_webhook](docs/resources/webhook.md)
+### Data Sources
+
+* [epilot-webhook_webhook](docs/data-sources/webhook.md)
+<!-- End Available Resources and Data Sources [operations] -->
+
+<!-- Start Summary [summary] -->
+## Summary
+
+Webhooks: Service for configuring webhooks on different events
+<!-- End Summary [summary] -->
 
+<!-- Start Table of Contents [toc] -->
+## Table of Contents
 
-<!-- End Available Resources and Operations [operations] -->
+* [Installation](#installation)
+* [Available Resources and Data Sources](#available-resources-and-data-sources)
+* [Testing the provider locally](#testing-the-provider-locally)
+<!-- End Table of Contents [toc] -->
 
 <!-- Placeholder for Future Speakeasy SDK Sections -->
 

examples/data-sources/epilot-webhook_webhook/data-source.tf

@@ -0,0 +1,2 @@
+data "epilot-webhook_webhook" "my_webhook" {
+}

examples/provider/provider.tf

@@ -2,11 +2,11 @@ terraform {
   required_providers {
     epilot-webhook = {
       source  = "epilot-dev/epilot-webhook"
-      version = "0.4.0"
+      version = "0.5.1"
     }
   }
 }
 
 provider "epilot-webhook" {
   # Configuration options
-}
+}

examples/resources/epilot-webhook_webhook/import.sh

@@ -0,0 +1 @@
+terraform import epilot-webhook_webhook.my_epilot-webhook_webhook ""

examples/resources/epilot-file_file/provider.tf → examples/resources/epilot-webhook_webhook/provider.tf

@@ -2,7 +2,7 @@ terraform {
   required_providers {
     epilot-webhook = {
       source  = "epilot-dev/epilot-webhook"
-      version = "2.1.1"
+      version = "0.5.0"
     }
   }
 }
@@ -12,9 +12,7 @@ variable "epilot_auth" {
   description = "epilot_auth"
 }
 
-
 provider "epilot-webhook" {
   # Configuration options
   epilot_auth = var.epilot_auth
-  server_url  = "https://file.dev.sls.epilot.io"
-}
+}

examples/resources/epilot-webhook_webhook/resource.tf

@@ -0,0 +1,4 @@
+resource "epilot-webhook_webhook" "my_webhook" {
+  event_name       = "automation_flow_target"
+  name        = "Generated by Terraform"
+}

gen.yaml

@@ -27,7 +27,7 @@ go:
   outputModelSuffix: output
   packageName: openapi
 terraform:
-  version: 0.4.0
+  version: 0.5.1
   additionalDataSources: []
   additionalDependencies: {}
   additionalResources: []