123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111
import { DataFactory, type RDF } from "../rdf.ts";import { xsd } from "../../namespaces/xsd.ts";
import { stringify } from "./stringify.ts";
/** * Any value that can be used in LDkit SPARQL builders */export type SparqlValue =  | RDF.Term  | string  | number  | boolean  | Date  | Iterable<SparqlValue>  | { build: () => string }  | null  | undefined;
/** * A template tag for SPARQL queries or its parts. Automatically converts * values to SPARQL literals and escapes strings as needed. * * @example * ```typescript * import { sparql } from "ldkit/sparql"; * import { DataFactory } from "ldkit/rdf"; * * const df = new DataFactory(); * const quad = df.quad( *   df.namedNode("http://example.org/s"), *   df.namedNode("http://example.org/p"), *   df.literal("o"), * ); * const query = sparql`SELECT * WHERE { ${quad} }`; * console.log(query); // SELECT * WHERE { <http://example.org/s> <http://example.org/p> "o" . } * ``` * * @param strings {TemplateStringsArray} template strings * @param values {SparqlValue[]} * @returns {string} SPARQL query or its part */export const sparql = (  strings: TemplateStringsArray,  ...values: SparqlValue[]): string => {  let counter = 0;  let result = "";
  for (const value of values) {    result += strings[counter++];
    result += valueToString(value);  }
  result += strings[counter];
  return result;};
const isIterable = (obj: unknown): obj is Iterable<unknown> => {  return Symbol.iterator in Object(obj);};
const df = new DataFactory();
const valueToString = (value: SparqlValue): string => {  if (typeof value === "undefined" || value === null) {    return "";  }
  if (typeof value === "string") {    return value;  }
  if (typeof value === "number") {    const numberDataType = Number.isInteger(value) ? xsd.integer : xsd.decimal;    return stringify(      df.literal(value.toString(), df.namedNode(numberDataType)),    );  }  if (typeof value === "boolean") {    return stringify(df.literal(value.toString(), df.namedNode(xsd.boolean)));  }  if (value instanceof Date) {    return stringify(      df.literal(value.toISOString(), df.namedNode(xsd.dateTime)),    );  }
  if (isIterable(value)) {    const [first, ...rest] = value;    let result = valueToString(first);
    for (const part of rest) {      result += `\n${valueToString(part)}`;    }    return result;  }
  if ("build" in value) {    return value.build();  }
  if (value.termType) {    return stringify(value);  }
  throw new Error("Not supported input type detected.");};