Blewis/stack spec scoped variable (#226)

* add stack spec scoped variable

* update stack spec scoped variable source

components/schemas/stacks/spec/StackSpecScopedVariableRawSource.yml

@@ -0,0 +1,35 @@
+title: StackSpecScopedVariableRawSource
+type: object
+description: A stack spec resource.
+required:
+  - type
+  - details
+properties:
+  type:
+    type: string
+    enum:
+      - raw
+  details:
+    type: object
+    required:
+      - value
+      - blob
+      - secret
+    properties:
+      value:
+        type: string
+        description: The value of the variable.
+      blob:
+        type: boolean
+        description: A boolean where true represents the text the user is entering will be multi line.
+      secret:
+        nullable: true
+        type: object
+        required:
+        properties:
+          iv:
+            type: string
+            description: A string describing the IV Hex associated with the encryption of the variable
+          hint:
+            type: string
+            description: A user specified hint that will suggest what the encryption key might be

components/schemas/stacks/spec/StackSpecScopedVariableUrlSource.yml

@@ -0,0 +1,30 @@
+title: StackSpecScopedVaribaleUrlSource
+type: object
+description: The `URL` type of scoped variable `value`, referred to as a source. This means the value of this variable is the result of calling the given URL. It is dynamic, in that Cycle will refetch the contents on every start.
+required:
+  - type
+  - details
+properties:
+  type:
+    type: string
+    description: The type of source value, can be either `raw` or `url`.
+    enum:
+      - url
+  details:
+    type: object
+    required:
+      - url
+      - headers
+      - auth_token_url
+    properties:
+      url:
+        type: string
+        description: The URL to call to produce the value.
+      headers:
+        type: object
+        description: Additional headers that can be attached to the URL request. Useful for adding metadata to third-party services.
+        additionalProperties: {}
+      auth_token_url:
+        nullable: true
+        type: string
+        description: A URL that can be provided to authenticate with a third party secret service. Cycle will make a request to this URL before fetching the secret URL, and use the response as the value of an Authorization header when requesting the secret.