sparnatural/dist/sparnatural-bindings.js

Visual client-side SPARQL query builder and knowledge graph exploration tool

/**
 * Binds Sparnatural with its YasR plugins, by notifying them of
 * the configuration and of the query being executed.
 * 
 * - On sparnatural `init` event : calls notifyConfiguration(specProvider) on each Yasr plugin
 * - On sparnatural `queryUpdated` event : calls notifyQuery(queryJson) on each Yasr plugin
 **/
bindSparnaturalWithYasrPlugins = function(sparnatural, yasr) {

    sparnatural.addEventListener("init", (event) => {
      // notify the specification to yasr plugins
      for (const plugin in yasr.plugins) {
        if (yasr.plugins[plugin].notifyConfiguration) {
          yasr.plugins[plugin].notifyConfiguration(
            event.detail.config
          );
        }
      }
    });

    sparnatural.addEventListener("queryUpdated", (event) => {
      // notify the query to yasr plugins
      for (const plugin in yasr.plugins) {
        if (yasr.plugins[plugin].notifyQuery) {
          yasr.plugins[plugin].notifyQuery(event.detail.queryJson);
        }
      }
    });
}

/**
 * Binds Sparnatural with a Yasqe query editor, by setting the generated SPARQL value
 * in the query editor. Yasqe is responsible for executing the query and passing results to yasr.
 * 
 * - On sparnatural `queryUpdated` event : expands the SPARQL query and calls yasqe.setValue(finalQueryString)
 * - On sparnatural `submit` event : disables Sparnatural play button and calls yasqe.query() that triggers the actual query
 * - On sparnatural `reset` event : calls yasqe.setValue("") with an empty string to clean the SPARQL query
 * - On yasqe `queryResponse` event : calls sparnatural.enablePlayButton() to re-enable the play button, and calls yasr.setResponse()
 * to display the query results
 **/
bindSparnaturalWithYasqe = function(sparnatural, yasqe, yasr) {

    sparnatural.addEventListener("queryUpdated", (event) => {
      queryString = sparnatural.expandSparql(event.detail.queryString);
      yasqe.setValue(queryString);
      if(document.getElementById('query-json') != null) {
        // save query in JSON
        document.getElementById('query-json').value = JSON.stringify(event.detail.queryJson)
      }
    });

    sparnatural.addEventListener("submit", (event) => {
      // enable loader on button
      sparnatural.disablePlayBtn();
      // trigger the query from YasQE
      yasqe.query();
    });

    sparnatural.addEventListener("reset", (event) => {
      yasqe.setValue("");
    });

    // link yasqe and yasr
    yasqe.on("queryResponse", function(_yasqe, response, duration) {
      yasr.setResponse(response, duration);
      sparnatural.enablePlayBtn();
    });
}


/**
 * Binds Sparnatural with the SparnaturalHistoryComponent.
 *
 * - On sparnatural `init` event : injects the config into sparnatural-history
 * - On sparnatural `queryUpdated` event : stores the latest query in a global var
 * - On sparnatural `submit` event : saves the latest query in the history
 * - On sparnatural-history `loadQuery` event : loads the query from the history in Sparnatural
 */
bindSparnaturalWithHistory = function (sparnatural, sparnaturalHistory) {
  let lastquery = null;

  sparnatural.addEventListener("init", (event) => {
    const config = event.detail.config;
    sparnaturalHistory.notifyConfiguration(config);
  });

  // stores the latest query
  sparnatural.addEventListener("queryUpdated", (event) => {
    lastquery = event.detail.queryJson;
  });

  sparnatural.addEventListener("submit", () => {
    // use saveQuery method from history component
    sparnaturalHistory.saveQuery(lastquery);
  });

  // 🔁 Écouteur pour charger une requête depuis l'historique
  sparnaturalHistory.addEventListener("loadQuery", (event) => {
    const query = event.detail.query;
    sparnatural.loadQuery(query);
  });
};


/**
 * Binds Sparnatural with a query executed by Sparnatural itself, using yasqe as a read-only query editor.
 * 
 * 
 * - On sparnatural `queryUpdated` event : expands the SPARQL query and calls yasqe.setValue(finalQueryString)
 * - On sparnatural `submit` event : disables Sparnatural play button and calls sparnatural.executeSparql() with query retrieved from yasqe.
 * The submit uses a callback that will update yasr
 * - On sparnatural `reset` event : calls yasqe.setValue("") with an empty string to clean the SPARQL query
 **/
bindSparnaturalWithItself = function(sparnatural, yasqe, yasr) {

  sparnatural.addEventListener("queryUpdated", (event) => {
    queryString = sparnatural.expandSparql(event.detail.queryString);
    yasqe.setValue(queryString);
    if(document.getElementById('query-json') != null) {
      // save query in JSON
      document.getElementById('query-json').value = JSON.stringify(event.detail.queryJson)
    }
  });

  sparnatural.addEventListener("submit", (event) => {
    // enable loader on button
    sparnatural.disablePlayBtn() ;

    let finalResult = sparnatural.executeSparql(
      yasqe.getValue(),
      (finalResult) => {
        // send final result to YasR
        yasr.setResponse(finalResult);
        // re-enable submit button
        sparnatural.enablePlayBtn();
      },
      (error) => {
        console.error("Got an error when executing SPARQL in Sparnatural");
        console.dir(error);
      }
    );
  });

  sparnatural.addEventListener("reset", (event) => {
    yasqe.setValue("");
  });
}