Add sparql escape helpers

Author: erikap

README.md

@@ -51,6 +51,13 @@ The following importable variables are available:
   - `update(query) => Promise`: Function for sending updates to the triplestore
   - `uuid()` => string: Generates a random UUID
   - `sparql`: [Template tag](https://www.npmjs.com/package/sparql-client-2#using-the-sparql-template-tag) to create queries with interpolated values
+  - `sparqlEscapeString(value) => string`: Function to escape a string in SPARQL
+  - `sparqlEscapeUri(value) => string`: Function to escape a URI in SPARQL
+  - `sparqlEscapeInt(value) => string`: Function to escape an integer in SPARQL
+  - `sparqlEscapeFloat(value) => string`: Function to escape a float in SPARQL
+  - `sparqlEscapeDate(value) => string`: Function to escape a date in SPARQL
+  - `sparqlEscapeDateTime(value) => string`: Function to escape a datetime in SPARQL
+  - `sparqlEscapeBool(value) => string`: Function to escape a boolean in SPARQL
 
 You can either import specific attributes from the mu library, or import the whole mu object.
 

helpers/mu/index.js

@@ -11,10 +11,41 @@ const mu = {
   SPARQL: sparql.sparql,
   query: sparql.query,
   update: sparql.update,
+  sparqlEscapeString: sparql.sparqlEscapeString,
+  sparqlEscapeUri: sparql.sparqlEscapeUri,
+  sparqlEscapeInt: sparql.sparqlEscapeInt,
+  sparqlEscapeFloat: sparql.sparqlEscapeFloat,
+  sparqlEscapeDate: sparql.sparqlEscapeDate,
+  sparqlEscapeDateTime: sparql.sparqlEscapeDateTime,
+  sparqlEscapeBool: sparql.sparqlEscapeBool,
   uuid: uuid
 }
 
-const SPARQL = mu.SPARQL, query = mu.query, update = mu.update;
+const SPARQL = mu.SPARQL,
+      query = mu.query,
+      update = mu.update,
+      sparqlEscapeString = mu.sparqlEscapeString,
+      sparqlEscapeUri = mu.sparqlEscapeUri,
+      sparqlEscapeInt = mu.sparqlEscapeInt,
+      sparqlEscapeFloat = mu.sparqlEscapeFloat,
+      sparqlEscapeDate = mu.sparqlEscapeDate,
+      sparqlEscapeDateTime = mu.sparqlEscapeDateTime,
+      sparqlEscapeBool = mu.sparqlEscapeBool
+
+export {
+  app,
+  sparql,
+  SPARQL,
+  query,
+  update,
+  sparqlEscapeString,
+  sparqlEscapeUri,
+  sparqlEscapeInt,
+  sparqlEscapeFloat,
+  sparqlEscapeDate,
+  sparqlEscapeDateTime,
+  sparqlEscapeBool,
+  uuid
+};
 
-export { app , sparql, SPARQL, query, update, uuid };
 export default mu;

helpers/mu/sparql.js

@@ -20,16 +20,63 @@ function query( queryString ){
 // executes an update query
 const update = query;
 
+function sparqlEscapeString( value ){
+  return '"' + value.replace(/[\\"']/, function(match) { return '\\' + match }) + '"';
+};
+
+function sparqlEscapeUri( value ){
+  return '<' + value.replace(/[\\"']/, function(match) { return '\\' + match }) + '>';
+};
+
+function sparqlEscapeInt( value ){
+  return '"' + Number.parseInt(value) + '"^^xsd:integer';
+};
+
+function sparqlEscapeFloat( value ){
+  return '"' + Number.parseFloat(value) + '"^^xsd:float';
+};
+
+function sparqlEscapeDate( value ){
+  return '"' + new Date(value).toISOString() + '"^^xsd:date';
+};
+
+function sparqlEscapeDateTime( value ){
+  return '"' + new Date(value).toISOString() + '"^^xsd:dateTime';
+};
+
+function sparqlEscapeBool( value ){
+  return value ? '"true"^^xsd:boolean' : '"false"^^xsd:boolean';
+};
 
 //==-- exports --==//
 const exports = {
   newSparqlClient: newSparqlClient,
   SPARQL: SPARQL,
   sparql: SPARQL,
   query: query,
-  update: update
+  update: update,
+  sparqlEscapeString: sparqlEscapeString,
+  sparqlEscapeUri: sparqlEscapeUri,
+  sparqlEscapeInt: sparqlEscapeInt,
+  sparqlEscapeFloat: sparqlEscapeFloat,
+  sparqlEscapeDate: sparqlEscapeDate,
+  sparqlEscapeDateTime: sparqlEscapeDateTime,
+  sparqlEscapeBool: sparqlEscapeBool
 }
 export default exports;
 
-export { query, update, SPARQL as SPARQL, SPARQL as sparql, newSparqlClient };
+export {
+  newSparqlClient,
+  SPARQL as SPARQL,
+  SPARQL as sparql,
+  query,
+  update,
+  sparqlEscapeString,
+  sparqlEscapeUri,
+  sparqlEscapeInt,
+  sparqlEscapeFloat,
+  sparqlEscapeDate,
+  sparqlEscapeDateTime,
+  sparqlEscapeBool
+};