update api docs

Author: fergiemcdowall

README.md

@@ -48,7 +48,7 @@ const myNorch = new Norch(ops) // same options as terminal
 # API
 
 Checkout the OpenAPI documentation
-[online](http://fergiemcdowall.github.io/norch/www_root/api.html), or
+[online](http://fergiemcdowall.github.io/norch/www_root/api/api.html), or
 at [`/api.html`](http://localhost:3030) on your own norch server.
 
 

build/mirrorUnpkg.js

@@ -10,6 +10,6 @@ Promise.all(
   files.map(f =>
     fetch('https://unpkg.com/[email protected]/' + f)
       .then(res => res.text())
-      .then(text => writeFile('www_root/' + f, text))
+      .then(text => writeFile('www_root/api/' + f, text))
   )
 )

build/openAPIDoc.js

@@ -63,6 +63,7 @@ const swaggerDefinition = {
         },
         description: 'Describes one or many BUCKETs'
       },
+
       Documents: {
         in: 'query',
         name: 'DOCUMENTS',
@@ -283,7 +284,7 @@ const swaggerDefinition = {
 }
 
 writeFileSync(
-  'www_root/openapi-norch-' + version + '.json',
+  'www_root/api/openapi-norch-' + version + '.json',
   JSON.stringify(
     swaggerJsdoc({
       swaggerDefinition,

package.json

@@ -41,7 +41,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "build-openapi-docs": "node build/mirrorUnpkg.js && node build/openAPIDoc.js && npm run lint",
+    "build-openapi-docs": "rm -rf www_root/api && mkdir www_root/api && node build/mirrorUnpkg.js && node build/openAPIDoc.js && npm run lint",
     "lint": "standard --fix src build test",
     "test": "export SANDBOX=test/sandbox && rm -rf $SANDBOX && mkdir $SANDBOX && date && tape test/*-test.js && npm run lint",
     "test-cli": "./bin/norch -p 9090 -i test/sandbox/norch-cli & sleep 5s && bats test/test.bats && kill $!",