Merge pull request #95 from netlify/new-js-strategey

New js strategey

Author: bcomnes

.gitignore

@@ -1,3 +1,5 @@
 *.iml
 vendor
 *node_modules
+ui
+js

Makefile

@@ -17,13 +17,9 @@ deps: ## Download dependencies.
 
 generate: validate ## Generate the API Go client and the JSON document for the UI.
 	swagger generate client -A netlify -f swagger.yml -t go -c plumbing
-	swagger generate spec -i swagger.yml -o ui/swagger.json
 
 test: ## Test the go code.
 	cd ./go && go test -v $(CHECK_FILES)
 
 validate: ## Check that the swagger spec is valid.
 	swagger validate swagger.yml
-
-node: ## Generate the node module.
-	swagger-codegen generate -i ./swagger.yml -l javascript -o ./node/

README.md

@@ -28,32 +28,34 @@ You can use this command to generate the Go client:
 
 You may first want to edit swagger.yml to add your field or endpoint definitions.
 
-## Node Client
+## JS Client
 
-In order to generate the Node client, you must install Java 8 and the swagger-codegen tool.
+Swagger's JS client can dynamically create a client from a spec either from a URL or spec object.
 
-1. You will need java8 (or 7) to run the code-gen
+See [swagger-js](https://github.com/swagger-api/swagger-js)
 
-    ```bash
-    # install java 8 via homebrew
-    brew cask install homebrew/cask-versions/java8
-    ```
 
+### Usage
+```js
+<script src='browser/swagger-client.js' type='text/javascript'></script>
+<script>
+var swaggerClient = new SwaggerClient('https://open-api.netlify.com/swagger.json');
+</script>
+```
 
-2. Then install swagger codegen
+You can also consume the swagger spec as an npm module:
 
-    ```bash
-    # install code-gen via homebrew
-    brew install swagger-codegen
-    ```
+```console
+$ npm install @netlify/open-api
+# or
+$ yarn add @netlify/open-api
+```
 
-3. Generate the library
+```js
+import spec from '@netlify/open-api' // import the spec object into your project
+```
 
-	```console
-	$ make node
-	```
-
-The `swagger-codegen` generates an entire module in the `node` folder.  You can publish new versions of the client from that folder with `npm publish`.
+The module also ships a copy of the original `yml` spec file at `@netlify/open-api/swagger.yml`.
 
 ## Explore API
 

netlify.toml

@@ -1,2 +1,3 @@
 [build]
 publish = "ui"
+command = "npm run build"