add initial files to swagger parser

Author: arojunior

src/index.js

@@ -2,3 +2,4 @@ export Api from './Api';
 export Resource from './Resource';
 export Field from './Field';
 export * from './hydra';
+export * from './swagger';

src/swagger/index.js

@@ -0,0 +1 @@
+export parseSwaggerDocumentation from './parseSwaggerDocumentation';

src/swagger/parseSwaggerDocumentation.js

@@ -0,0 +1,160 @@
+import Api from '../Api'
+import Field from '../Field'
+import Resource from '../Resource'
+
+/**
+ * Extracts the short name of a resource.
+ *
+ * @param {string} url
+ * @param {string} entrypointUrl
+ * @return {string}
+ */
+function guessNameFromUrl(url, entrypointUrl) {
+  return url.substr(entrypointUrl.length + 1);
+}
+
+/**
+ * Finds the description of the class with the given id.
+ *
+ * @param {object[]} docs
+ * @param {string} supportedClass
+ * @return {object}
+ */
+function findSupportedClass(docs, supportedClass) {
+  const supportedClasses = docs[0]['http://www.w3.org/ns/hydra/core#supportedClass'];
+
+  for (let i = 0; i < supportedClasses.length; i++) {
+    if (supportedClasses[i]['@id'] === supportedClass) {
+      return supportedClasses[i];
+    }
+  }
+
+  throw new Error(`The class ${supportedClass} doesn't exist.`);
+}
+
+
+/**
+ * Retrieves Hydra's entrypoint and API docs.
+ *
+ * @param {string} entrypointUrl
+ * @param {object} options
+ * @return {Promise}
+ */
+function fetchEntrypointAndDocs(entrypointUrl) {
+  return fetch(entrypointUrl).then(d => {
+    return {
+      entrypointUrl,
+      docsUrl: null,
+      entrypoint: d.body,
+      response: Promise.resolve(d.json().then(body => ({ d, body, document: body })))
+    }
+  })
+}
+
+function removeTrailingSlash(url) {
+  if (/\/$/.test(url)) {
+    url = url.slice(0, -1)
+  }
+
+  return url
+}
+
+/**
+ * Parses a Hydra documentation and converts it to an intermediate representation.
+ *
+ * @param {string} entrypointUrl
+ * @param {object} options
+ * @return {Promise.<Api>}
+ */
+export default function parseSwaggerDocumentation(entrypointUrl) {
+  entrypointUrl = removeTrailingSlash(entrypointUrl)
+  return fetchEntrypointAndDocs(entrypointUrl).then(
+    ({ entrypoint, docs, response }) => {
+          
+      // const title = 'undefined' === typeof docs[0]['http://www.w3.org/ns/hydra/core#title'] ? 'API Platform' : docs[0]['http://www.w3.org/ns/hydra/core#title'][0]['@value'];
+      // const entrypointSupportedClass = findSupportedClass(docs, entrypoint[0]['@type'][0]);
+
+      // let resources = [];
+      // let fields = [];
+
+      // // Add resources
+      // for (let properties of entrypointSupportedClass['http://www.w3.org/ns/hydra/core#supportedProperty']) {
+      //   const property = properties['http://www.w3.org/ns/hydra/core#property'][0];
+      //   const entrypointSupportedOperations = property['http://www.w3.org/ns/hydra/core#supportedOperation'];
+
+      //   let readableFields = [];
+      //   let resourceFields = [];
+      //   let writableFields = [];
+
+      //   // Add fields
+      //   for (let j = 0; j < entrypointSupportedOperations.length; j++) {
+      //     let className = entrypointSupportedOperations[j]['http://www.w3.org/ns/hydra/core#returns'];
+
+      //     // Skip operations not having a return type
+      //     if (!className) {
+      //       continue;
+      //     }
+
+      //     className = className[0]['@id'];
+
+      //     if (0 === className.indexOf('http://www.w3.org/ns/hydra/core')) {
+      //       continue;
+      //     }
+
+      //     const supportedClass = findSupportedClass(docs, className);
+      //     for (let supportedProperties of supportedClass['http://www.w3.org/ns/hydra/core#supportedProperty']) {
+      //       const supportedProperty = supportedProperties['http://www.w3.org/ns/hydra/core#property'][0];
+      //       const range = supportedProperty['http://www.w3.org/2000/01/rdf-schema#range'] ? supportedProperty['http://www.w3.org/2000/01/rdf-schema#range'][0]['@id'] : null;
+
+      //       const field = new Field(
+      //         supportedProperty['http://www.w3.org/2000/01/rdf-schema#label'][0]['@value'],
+      //         {
+      //           id: supportedProperty['@id'],
+      //           range,
+      //           reference: 'http://www.w3.org/ns/hydra/core#Link' === property['@type'][0] ? range : null, // Will be updated in a subsequent pass
+      //           required: supportedProperties['http://www.w3.org/ns/hydra/core#required'] ? supportedProperties['http://www.w3.org/ns/hydra/core#required'][0]['@value'] : false,
+      //           description: supportedProperties['http://www.w3.org/ns/hydra/core#description'] ? supportedProperties['http://www.w3.org/ns/hydra/core#description'][0]['@value'] : ''
+      //         },
+      //       );
+
+      //       fields.push(field);
+      //       resourceFields.push(field);
+
+      //       if (supportedProperties['http://www.w3.org/ns/hydra/core#readable'][0]['@value']) {
+      //         readableFields.push(field);
+      //       }
+
+      //       if (supportedProperties['http://www.w3.org/ns/hydra/core#writable'][0]['@value']) {
+      //         writableFields.push(field);
+      //       }
+      //     }
+
+      //     resources.push(new Resource(
+      //       guessNameFromUrl(entrypoint[0][property['@id']][0]['@id'], entrypointUrl),
+      //       entrypoint[0][property['@id']][0]['@id'],
+      //       {
+      //         id: supportedClass['@id'],
+      //         title: supportedClass['http://www.w3.org/ns/hydra/core#title'][0]['@value'],
+      //         fields: resourceFields,
+      //         readableFields,
+      //         writableFields
+      //       }
+      //     ));
+
+      //     break;
+      //   }
+      // }
+
+      // // Resolve references
+      // for (let field of fields) {
+      //   if (null !== field.reference) {
+      //     field.reference = resources.find(resource => resource.id === field.reference) || null;
+      //   }
+      // }
+
+      // return Promise.resolve({ api: new Api(entrypointUrl, {title, resources}), response , status: response.status });
+      return Promise.resolve({ api: {} }, response)
+    },
+    ({ response }) => Promise.reject({ api: new Api(entrypointUrl, {resources: []}), response, status: response.status })
+  );
+}