@comunica/utils-expression-evaluator 3.2.4-alpha.47.0

package/lib/util/Consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Consts.js","sourceRoot":"","sources":["Consts.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as RDF from '@rdfjs/types';\nimport { DataFactory } from 'rdf-data-factory';\n\nexport type KnownLiteralTypes = TypeAlias | TypeURL;\n\nexport enum TypeAlias {\n  // Numeric is everything defined in https://www.w3.org/TR/sparql11-query/#operandDataTypes\n  SPARQL_NUMERIC = 'SPARQL_NUMERIC',\n  /**\n   * Stringly is everything defined in https://www.w3.org/TR/sparql11-query/#func-strings\n   * In other words it is a simple literal, a plain literal with language tag, or a literal with datatype xsd:string\n   * In other words, since utils-expression-evaluator transforms a simple literal to xsd_string.\n   * It is RDF_LANG_STRING or XSD_STRING.\n   * Reasons for this are mentioned here: w3c/sparql-12#112\n   */\n  SPARQL_STRINGLY = 'SPARQL_STRINGLY',\n}\n\nconst DF = new DataFactory();\n\nexport function typedLiteral(value: string, type: TypeURL): RDF.Literal {\n  return DF.literal(value, DF.namedNode(type));\n}\n\nexport enum TypeURL {\n  XSD_ANY_URI = 'http://www.w3.org/2001/XMLSchema#anyURI',\n  XSD_STRING = 'http://www.w3.org/2001/XMLSchema#string',\n  RDF_LANG_STRING = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#langString',\n\n  XSD_BOOLEAN = 'http://www.w3.org/2001/XMLSchema#boolean',\n\n  XSD_DATE_TIME = 'http://www.w3.org/2001/XMLSchema#dateTime',\n  XSD_DATE_TIME_STAMP = 'http://www.w3.org/2001/XMLSchema#dateTimeStamp',\n  XSD_DATE = 'http://www.w3.org/2001/XMLSchema#date',\n\n  XSD_G_MONTH = 'http://www.w3.org/2001/XMLSchema#gMonth',\n  XSD_G_MONTHDAY = 'http://www.w3.org/2001/XMLSchema#gMonthDay',\n  XSD_G_YEAR = 'http://www.w3.org/2001/XMLSchema#gYear',\n  XSD_G_YEAR_MONTH = 'http://www.w3.org/2001/XMLSchema#gYearMonth',\n  XSD_TIME = 'http://www.w3.org/2001/XMLSchema#time',\n  XSD_G_DAY = 'http://www.w3.org/2001/XMLSchema#gDay',\n\n  // Numeric types\n  XSD_DECIMAL = 'http://www.w3.org/2001/XMLSchema#decimal',\n  XSD_FLOAT = 'http://www.w3.org/2001/XMLSchema#float',\n  XSD_DOUBLE = 'http://www.w3.org/2001/XMLSchema#double',\n\n  // Derived numeric types\n  XSD_INTEGER = 'http://www.w3.org/2001/XMLSchema#integer',\n\n  XSD_NON_POSITIVE_INTEGER = 'http://www.w3.org/2001/XMLSchema#nonPositiveInteger',\n  XSD_NEGATIVE_INTEGER = 'http://www.w3.org/2001/XMLSchema#negativeInteger',\n\n  XSD_LONG = 'http://www.w3.org/2001/XMLSchema#long',\n  XSD_INT = 'http://www.w3.org/2001/XMLSchema#int',\n  XSD_SHORT = 'http://www.w3.org/2001/XMLSchema#short',\n  XSD_BYTE = 'http://www.w3.org/2001/XMLSchema#byte',\n\n  XSD_NON_NEGATIVE_INTEGER = 'http://www.w3.org/2001/XMLSchema#nonNegativeInteger',\n  XSD_POSITIVE_INTEGER = 'http://www.w3.org/2001/XMLSchema#positiveInteger',\n  XSD_UNSIGNED_LONG = 'http://www.w3.org/2001/XMLSchema#unsignedLong',\n  XSD_UNSIGNED_INT = 'http://www.w3.org/2001/XMLSchema#unsignedInt',\n  XSD_UNSIGNED_SHORT = 'http://www.w3.org/2001/XMLSchema#unsignedShort',\n  XSD_UNSIGNED_BYTE = 'http://www.w3.org/2001/XMLSchema#unsignedByte',\n\n  // Derived String Type\n  XSD_NORMALIZED_STRING = 'http://www.w3.org/2001/XMLSchema#normalizedString',\n  XSD_TOKEN = 'http://www.w3.org/2001/XMLSchema#token',\n  XSD_LANGUAGE = 'http://www.w3.org/2001/XMLSchema#language',\n  XSD_NM_TOKEN = 'http://www.w3.org/2001/XMLSchema#NMTOKEN',\n\n  XSD_NAME = 'http://www.w3.org/2001/XMLSchema#name',\n  XSD_NC_NAME = 'http://www.w3.org/2001/XMLSchema#NCName',\n  XSD_ENTITY = 'http://www.w3.org/2001/XMLSchema#ENTITY',\n  XSD_ID = 'http://www.w3.org/2001/XMLSchema#ID',\n  XSD_ID_REF = 'http://www.w3.org/2001/XMLSchema#IDREF',\n\n  // Other types\n  XSD_DURATION = 'http://www.w3.org/2001/XMLSchema#duration',\n  XSD_YEAR_MONTH_DURATION = 'http://www.w3.org/2001/XMLSchema#yearMonthDuration',\n  XSD_DAY_TIME_DURATION = 'http://www.w3.org/2001/XMLSchema#dayTimeDuration',\n}\n\n// ----------------------------------------------------------------------------\n// Operators\n// ----------------------------------------------------------------------------\n\nexport type GeneralOperator = KnownOperator | string;\n\nexport type KnownOperator = SparqlOperator | NamedOperator;\n\n// TODO: Remove unneeded double typing\nexport enum SparqlOperator {\n  // Operator mapping\n  // https://www.w3.org/TR/sparql11-query/#OperatorMapping\n  NOT = '!',\n  UMINUS = 'uminus',\n  UPLUS = 'uplus',\n  LOGICAL_OR = '||',\n  LOGICAL_AND = '&&',\n\n  EQUAL = '=',\n  NOT_EQUAL = '!=',\n  LT = '<',\n  GT = '>',\n  LTE = '<=',\n  GTE = '>=',\n  SAME_TERM = 'sameterm',\n  IN = 'in',\n  NOT_IN = 'notin',\n\n  MULTIPLICATION = '*',\n  DIVISION = '/',\n  ADDITION = '+',\n  SUBTRACTION = '-',\n\n  // Functional Forms\n  // https://www.w3.org/TR/sparql11-query/#func-forms\n  // See SpecialOperators\n\n  // Functions on RDF Terms\n  // https://www.w3.org/TR/sparql11-query/#func-rdfTerms\n  IS_IRI = 'isiri',\n  IS_URI = 'isuri',\n  IS_BLANK = 'isblank',\n  IS_LITERAL = 'isliteral',\n  IS_NUMERIC = 'isnumeric',\n  STR = 'str',\n  LANG = 'lang',\n  DATATYPE = 'datatype',\n  IRI = 'iri',\n  URI = 'uri',\n  BNODE = 'bnode',\n  STRDT = 'strdt',\n  STRLANG = 'strlang',\n  UUID = 'uuid',\n  STRUUID = 'struuid',\n\n  // Functions on strings\n  // https://www.w3.org/TR/sparql11-query/#func-strings\n  STRLEN = 'strlen',\n  SUBSTR = 'substr',\n  UCASE = 'ucase',\n  LCASE = 'lcase',\n  STRSTARTS = 'strstarts',\n  STRENDS = 'strends',\n  CONTAINS = 'contains',\n  STRBEFORE = 'strbefore',\n  STRAFTER = 'strafter',\n  ENCODE_FOR_URI = 'encode_for_uri',\n  CONCAT = 'concat',\n  LANG_MATCHES = 'langmatches',\n  REGEX = 'regex',\n  REPLACE = 'replace',\n\n  // Functions on numerics\n  // https://www.w3.org/TR/sparql11-query/#func-numerics\n  ABS = 'abs',\n  ROUND = 'round',\n  CEIL = 'ceil',\n  FLOOR = 'floor',\n  RAND = 'rand',\n\n  // Functions on Dates and Times\n  // https://www.w3.org/TR/sparql11-query/#func-date-time\n  NOW = 'now',\n  YEAR = 'year',\n  MONTH = 'month',\n  DAY = 'day',\n  HOURS = 'hours',\n  MINUTES = 'minutes',\n  SECONDS = 'seconds',\n  TIMEZONE = 'timezone',\n  TZ = 'tz',\n  // Hash functions\n  // https://www.w3.org/TR/sparql11-query/#func-hash\n  MD5 = 'md5',\n  SHA1 = 'sha1',\n  SHA256 = 'sha256',\n  SHA384 = 'sha384',\n  SHA512 = 'sha512',\n\n  // XPath Constructor functions\n  // https://www.w3.org/TR/sparql11-query/#FunctionMapping\n  // See Named Operators\n\n  // Functions for quoted triples\n  // https://w3c.github.io/rdf-star/cg-spec/editors_draft.html#triple-function\n  TRIPLE = 'triple',\n  SUBJECT = 'subject',\n  PREDICATE = 'predicate',\n  OBJECT = 'object',\n  IS_TRIPLE = 'istriple',\n\n  // Functional Forms\n  // https://www.w3.org/TR/sparql11-query/#func-forms\n  BOUND = 'bound',\n  IF = 'if',\n  COALESCE = 'coalesce',\n}\n\nexport type NamedOperator =\n  // XPath Constructor functions\n  // https://www.w3.org/TR/sparql11-query/#FunctionMapping\n  TypeURL.XSD_STRING\n  | TypeURL.XSD_FLOAT\n  | TypeURL.XSD_DOUBLE\n  | TypeURL.XSD_DECIMAL\n  | TypeURL.XSD_INTEGER\n  | TypeURL.XSD_DATE_TIME\n  | TypeURL.XSD_DATE\n  | TypeURL.XSD_BOOLEAN\n  | TypeURL.XSD_TIME\n  | TypeURL.XSD_DURATION\n  | TypeURL.XSD_DAY_TIME_DURATION\n  | TypeURL.XSD_YEAR_MONTH_DURATION;\n"]}

package/lib/util/Context.d.ts

@@ -0,0 +1,2 @@
+import type { IActionContext } from '@comunica/types';
+export declare function prepareEvaluatorActionContext(orgContext: IActionContext): IActionContext;

package/lib/util/Context.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareEvaluatorActionContext = void 0;
+const context_entries_1 = require("@comunica/context-entries");
+const lru_cache_1 = require("lru-cache");
+const DateTimeHelpers_1 = require("./DateTimeHelpers");
+function prepareEvaluatorActionContext(orgContext) {
+    let context = orgContext;
+    // Handle two variants of providing extension functions
+    if (context.has(context_entries_1.KeysInitQuery.extensionFunctionCreator) && context.has(context_entries_1.KeysInitQuery.extensionFunctions)) {
+        throw new Error('Illegal simultaneous usage of extensionFunctionCreator and extensionFunctions in context');
+    }
+    if (context.has(context_entries_1.KeysInitQuery.extensionFunctionCreator)) {
+        context = context.set(context_entries_1.KeysExpressionEvaluator.extensionFunctionCreator, context.get(context_entries_1.KeysInitQuery.extensionFunctionCreator));
+    }
+    else if (context.has(context_entries_1.KeysInitQuery.extensionFunctions)) {
+        const extensionFunctions = context.getSafe(context_entries_1.KeysInitQuery.extensionFunctions);
+        context = context.set(context_entries_1.KeysExpressionEvaluator.extensionFunctionCreator, async (functionNamedNode) => extensionFunctions[functionNamedNode.value]);
+    }
+    else {
+        // eslint-disable-next-line unicorn/no-useless-undefined
+        context = context.setDefault(context_entries_1.KeysExpressionEvaluator.extensionFunctionCreator, async () => undefined);
+    }
+    context = context.setDefault(context_entries_1.KeysExpressionEvaluator.defaultTimeZone, (0, DateTimeHelpers_1.extractTimeZone)(context.getSafe(context_entries_1.KeysInitQuery.queryTimestamp)));
+    context = context.setDefault(context_entries_1.KeysExpressionEvaluator.superTypeProvider, {
+        cache: new lru_cache_1.LRUCache({ max: 1_000 }),
+        discoverer: () => 'term',
+    });
+    return context;
+}
+exports.prepareEvaluatorActionContext = prepareEvaluatorActionContext;
+//# sourceMappingURL=Context.js.map

package/lib/util/Context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.js","sourceRoot":"","sources":["Context.ts"],"names":[],"mappings":";;;AAAA,+DAAmF;AAGnF,yCAAqC;AACrC,uDAAoD;AAEpD,SAAgB,6BAA6B,CAAC,UAA0B;IACtE,IAAI,OAAO,GAAG,UAAU,CAAC;IAEzB,uDAAuD;IACvD,IAAI,OAAO,CAAC,GAAG,CAAC,+BAAa,CAAC,wBAAwB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,+BAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACzG,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,+BAAa,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACxD,OAAO,GAAG,OAAO,CAAC,GAAG,CACnB,yCAAuB,CAAC,wBAAwB,EAChD,OAAO,CAAC,GAAG,CAAC,+BAAa,CAAC,wBAAwB,CAAC,CACpD,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,+BAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACzD,MAAM,kBAAkB,GAA2C,OAAO,CAAC,OAAO,CAChF,+BAAa,CAAC,kBAAkB,CACjC,CAAC;QACF,OAAO,GAAG,OAAO,CAAC,GAAG,CACnB,yCAAuB,CAAC,wBAAwB,EAChD,KAAK,EAAC,iBAAgC,EAAE,EAAE,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CACvF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,wDAAwD;QACxD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,yCAAuB,CAAC,wBAAwB,EAAE,KAAK,IAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACvG,CAAC;IAED,OAAO,GAAG,OAAO,CAAC,UAAU,CAC1B,yCAAuB,CAAC,eAAe,EACvC,IAAA,iCAAe,EAAC,OAAO,CAAC,OAAO,CAAC,+BAAa,CAAC,cAAc,CAAC,CAAC,CAC/D,CAAC;IAEF,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,yCAAuB,CAAC,iBAAiB,EAAE;QACtE,KAAK,EAAE,IAAI,oBAAQ,CAA+B,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QACjE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM;KACzB,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AApCD,sEAoCC","sourcesContent":["import { KeysExpressionEvaluator, KeysInitQuery } from '@comunica/context-entries';\nimport type { AsyncExtensionFunction, GeneralSuperTypeDict, IActionContext } from '@comunica/types';\nimport type * as RDF from '@rdfjs/types';\nimport { LRUCache } from 'lru-cache';\nimport { extractTimeZone } from './DateTimeHelpers';\n\nexport function prepareEvaluatorActionContext(orgContext: IActionContext): IActionContext {\n  let context = orgContext;\n\n  // Handle two variants of providing extension functions\n  if (context.has(KeysInitQuery.extensionFunctionCreator) && context.has(KeysInitQuery.extensionFunctions)) {\n    throw new Error('Illegal simultaneous usage of extensionFunctionCreator and extensionFunctions in context');\n  }\n  if (context.has(KeysInitQuery.extensionFunctionCreator)) {\n    context = context.set(\n      KeysExpressionEvaluator.extensionFunctionCreator,\n      context.get(KeysInitQuery.extensionFunctionCreator),\n    );\n  } else if (context.has(KeysInitQuery.extensionFunctions)) {\n    const extensionFunctions: Record<string, AsyncExtensionFunction> = context.getSafe(\n      KeysInitQuery.extensionFunctions,\n    );\n    context = context.set(\n      KeysExpressionEvaluator.extensionFunctionCreator,\n      async(functionNamedNode: RDF.NamedNode) => extensionFunctions[functionNamedNode.value],\n    );\n  } else {\n    // eslint-disable-next-line unicorn/no-useless-undefined\n    context = context.setDefault(KeysExpressionEvaluator.extensionFunctionCreator, async() => undefined);\n  }\n\n  context = context.setDefault(\n    KeysExpressionEvaluator.defaultTimeZone,\n    extractTimeZone(context.getSafe(KeysInitQuery.queryTimestamp)),\n  );\n\n  context = context.setDefault(KeysExpressionEvaluator.superTypeProvider, {\n    cache: new LRUCache<string, GeneralSuperTypeDict>({ max: 1_000 }),\n    discoverer: () => 'term',\n  });\n\n  return context;\n}\n"]}

package/lib/util/DateTimeHelpers.d.ts

@@ -0,0 +1,19 @@
+import type { IDateTimeRepresentation, IDayTimeDurationRepresentation, IDurationRepresentation, ITimeZoneRepresentation, IYearMonthDurationRepresentation } from '@comunica/types';
+export declare function defaultedDayTimeDurationRepresentation(rep: Partial<IDayTimeDurationRepresentation>): IDayTimeDurationRepresentation;
+export declare function defaultedYearMonthDurationRepresentation(rep: Partial<IYearMonthDurationRepresentation>): IYearMonthDurationRepresentation;
+export declare function defaultedDurationRepresentation(rep: Partial<IDurationRepresentation>): IDurationRepresentation;
+export declare function simplifyDurationRepresentation(rep: Partial<IDurationRepresentation>): Partial<IDurationRepresentation>;
+export declare function defaultedDateTimeRepresentation(rep: Partial<IDateTimeRepresentation>): IDateTimeRepresentation;
+export declare function toDateTimeRepresentation({ date, timeZone }: {
+    date: Date;
+    timeZone: ITimeZoneRepresentation;
+}): IDateTimeRepresentation;
+export declare function negateDuration(dur: Partial<IDurationRepresentation>): Partial<IDurationRepresentation>;
+export declare function toJSDate(date: IDateTimeRepresentation): Date;
+export declare function toUTCDate(date: Partial<IDateTimeRepresentation>, defaultTimezone: ITimeZoneRepresentation): Date;
+export declare function trimToYearMonthDuration(dur: Partial<IDurationRepresentation>): Partial<IYearMonthDurationRepresentation>;
+export declare function trimToDayTimeDuration(dur: Partial<IDurationRepresentation>): Partial<IDayTimeDurationRepresentation>;
+export declare function yearMonthDurationsToMonths(dur: IYearMonthDurationRepresentation): number;
+export declare function dayTimeDurationsToSeconds(dur: IDayTimeDurationRepresentation): number;
+export declare function extractRawTimeZone(zoneContained: string): string;
+export declare function extractTimeZone(date: Date): ITimeZoneRepresentation;

package/lib/util/DateTimeHelpers.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTimeZone = exports.extractRawTimeZone = exports.dayTimeDurationsToSeconds = exports.yearMonthDurationsToMonths = exports.trimToDayTimeDuration = exports.trimToYearMonthDuration = exports.toUTCDate = exports.toJSDate = exports.negateDuration = exports.toDateTimeRepresentation = exports.defaultedDateTimeRepresentation = exports.simplifyDurationRepresentation = exports.defaultedDurationRepresentation = exports.defaultedYearMonthDurationRepresentation = exports.defaultedDayTimeDurationRepresentation = void 0;
+// Important is to notice JS and XSD datatypes have different defaulted values
+// | Field | Default in JS | Default in XSD_DayTime | Default in XSD_Duration |
+// | Month | 0             | 1                      | 0                       |
+// | Day   | 1             | 1                      | 0                       |
+function defaultedDayTimeDurationRepresentation(rep) {
+    return {
+        day: rep.day ?? 0,
+        hours: rep.hours ?? 0,
+        minutes: rep.minutes ?? 0,
+        seconds: rep.seconds ?? 0,
+    };
+}
+exports.defaultedDayTimeDurationRepresentation = defaultedDayTimeDurationRepresentation;
+function defaultedYearMonthDurationRepresentation(rep) {
+    return {
+        year: rep.year ?? 0,
+        month: rep.month ?? 0,
+    };
+}
+exports.defaultedYearMonthDurationRepresentation = defaultedYearMonthDurationRepresentation;
+function defaultedDurationRepresentation(rep) {
+    return {
+        ...defaultedDayTimeDurationRepresentation(rep),
+        ...defaultedYearMonthDurationRepresentation(rep),
+    };
+}
+exports.defaultedDurationRepresentation = defaultedDurationRepresentation;
+function simplifyDurationRepresentation(rep) {
+    const temp = defaultedDurationRepresentation(rep);
+    const res = {};
+    // Simplify year part
+    const years = temp.year + Math.trunc(temp.month / 12);
+    if (years) {
+        res.year = years;
+        temp.month %= 12;
+    }
+    if (temp.month) {
+        res.month = temp.month;
+    }
+    // Simplify day part
+    const days = temp.day + Math.trunc(temp.hours / 24) +
+        Math.trunc(temp.minutes / (24 * 60)) + Math.trunc(temp.seconds / (24 * 60 * 60));
+    if (days) {
+        res.day = days;
+        temp.hours %= 24;
+        temp.minutes %= 24 * 60;
+        temp.seconds %= 24 * 60 * 60;
+    }
+    const hours = temp.hours + Math.trunc(temp.minutes / 60) +
+        Math.trunc(temp.seconds / (60 * 60));
+    if (hours) {
+        res.hours = hours;
+        temp.minutes %= 60;
+        temp.seconds %= 60 * 60;
+    }
+    const minutes = temp.minutes + Math.trunc(temp.seconds / 60);
+    if (minutes) {
+        res.minutes = minutes;
+        temp.seconds %= 60;
+    }
+    if (temp.seconds) {
+        res.seconds = temp.seconds;
+    }
+    return res;
+}
+exports.simplifyDurationRepresentation = simplifyDurationRepresentation;
+function defaultedDateTimeRepresentation(rep) {
+    return {
+        ...rep,
+        day: rep.day ?? 1,
+        hours: rep.hours ?? 0,
+        month: rep.month ?? 1,
+        year: rep.year ?? 0,
+        seconds: rep.seconds ?? 0,
+        minutes: rep.minutes ?? 0,
+    };
+}
+exports.defaultedDateTimeRepresentation = defaultedDateTimeRepresentation;
+function toDateTimeRepresentation({ date, timeZone }) {
+    return {
+        year: date.getFullYear(),
+        month: date.getMonth() + 1,
+        day: date.getDate(),
+        hours: date.getHours(),
+        minutes: date.getMinutes(),
+        seconds: date.getSeconds(),
+        zoneHours: timeZone.zoneHours,
+        zoneMinutes: timeZone.zoneMinutes,
+    };
+}
+exports.toDateTimeRepresentation = toDateTimeRepresentation;
+function negateDuration(dur) {
+    return {
+        year: dur.year === undefined ? undefined : -1 * dur.year,
+        month: dur.month === undefined ? undefined : -1 * dur.month,
+        day: dur.day === undefined ? undefined : -1 * dur.day,
+        hours: dur.hours === undefined ? undefined : -1 * dur.hours,
+        minutes: dur.minutes === undefined ? undefined : -1 * dur.minutes,
+        seconds: dur.seconds === undefined ? undefined : -1 * dur.seconds,
+    };
+}
+exports.negateDuration = negateDuration;
+function toJSDate(date) {
+    // The given hours will be assumed to be local time.
+    const res = new Date(date.year, date.month - 1, date.day, date.hours, date.minutes, Math.trunc(date.seconds), (date.seconds % 1) * 1_000);
+    if (date.year >= 0 && date.year < 100) {
+        // Special rule of date has gone int action:
+        // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date#individual_date_and_time_component_values
+        const jumpDeltaOfDate = 1_900;
+        res.setFullYear(res.getFullYear() - jumpDeltaOfDate);
+    }
+    return res;
+}
+exports.toJSDate = toJSDate;
+function toUTCDate(date, defaultTimezone) {
+    const localTime = toJSDate(defaultedDateTimeRepresentation(date));
+    // This date has been constructed in machine local time, now we alter it to become UTC and convert to correct timezone
+    // Correction needed from local machine timezone to UTC
+    const minutesCorrectionLocal = localTime.getTimezoneOffset();
+    // Correction needed from UTC to provided timeZone
+    const hourCorrectionUTC = date.zoneHours ?? defaultTimezone.zoneHours;
+    const minutesCorrectionUTC = date.zoneMinutes ?? defaultTimezone.zoneMinutes;
+    return new Date(localTime.getTime() - (minutesCorrectionLocal + hourCorrectionUTC * 60 + minutesCorrectionUTC) * 60 * 1_000);
+}
+exports.toUTCDate = toUTCDate;
+function trimToYearMonthDuration(dur) {
+    return {
+        year: dur.year,
+        month: dur.month,
+    };
+}
+exports.trimToYearMonthDuration = trimToYearMonthDuration;
+function trimToDayTimeDuration(dur) {
+    return {
+        day: dur.day,
+        hours: dur.hours,
+        minutes: dur.minutes,
+        seconds: dur.seconds,
+    };
+}
+exports.trimToDayTimeDuration = trimToDayTimeDuration;
+function yearMonthDurationsToMonths(dur) {
+    return dur.year * 12 + dur.month;
+}
+exports.yearMonthDurationsToMonths = yearMonthDurationsToMonths;
+function dayTimeDurationsToSeconds(dur) {
+    return (((dur.day * 24) + dur.hours) * 60 + dur.minutes) * 60 + dur.seconds;
+}
+exports.dayTimeDurationsToSeconds = dayTimeDurationsToSeconds;
+function extractRawTimeZone(zoneContained) {
+    const extraction = /(Z|([+-]\d\d:\d\d))?$/u.exec(zoneContained);
+    // It is safe to cast here because the empty string can always match.
+    return extraction[0];
+}
+exports.extractRawTimeZone = extractRawTimeZone;
+function extractTimeZone(date) {
+    return {
+        zoneHours: date.getTimezoneOffset() / 60,
+        zoneMinutes: date.getTimezoneOffset() % 60,
+    };
+}
+exports.extractTimeZone = extractTimeZone;
+//# sourceMappingURL=DateTimeHelpers.js.map

package/lib/util/DateTimeHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateTimeHelpers.js","sourceRoot":"","sources":["DateTimeHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  IDateTimeRepresentation,\n  IDayTimeDurationRepresentation,\n  IDurationRepresentation,\n  ITimeZoneRepresentation,\n  IYearMonthDurationRepresentation,\n} from '@comunica/types';\n\n// Important is to notice JS and XSD datatypes have different defaulted values\n// | Field | Default in JS | Default in XSD_DayTime | Default in XSD_Duration |\n// | Month | 0             | 1                      | 0                       |\n// | Day   | 1             | 1                      | 0                       |\n\nexport function defaultedDayTimeDurationRepresentation(rep: Partial<IDayTimeDurationRepresentation>):\nIDayTimeDurationRepresentation {\n  return {\n    day: rep.day ?? 0,\n    hours: rep.hours ?? 0,\n    minutes: rep.minutes ?? 0,\n    seconds: rep.seconds ?? 0,\n  };\n}\n\nexport function defaultedYearMonthDurationRepresentation(rep: Partial<IYearMonthDurationRepresentation>):\nIYearMonthDurationRepresentation {\n  return {\n    year: rep.year ?? 0,\n    month: rep.month ?? 0,\n  };\n}\n\nexport function defaultedDurationRepresentation(\n  rep: Partial<IDurationRepresentation>,\n): IDurationRepresentation {\n  return {\n    ...defaultedDayTimeDurationRepresentation(rep),\n    ...defaultedYearMonthDurationRepresentation(rep),\n  };\n}\n\nexport function simplifyDurationRepresentation(rep: Partial<IDurationRepresentation>):\nPartial<IDurationRepresentation> {\n  const temp = defaultedDurationRepresentation(rep);\n  const res: Partial<IDurationRepresentation> = {};\n\n  // Simplify year part\n  const years = temp.year + Math.trunc(temp.month / 12);\n  if (years) {\n    res.year = years;\n    temp.month %= 12;\n  }\n  if (temp.month) {\n    res.month = temp.month;\n  }\n\n  // Simplify day part\n  const days = temp.day + Math.trunc(temp.hours / 24) +\n    Math.trunc(temp.minutes / (24 * 60)) + Math.trunc(temp.seconds / (24 * 60 * 60));\n  if (days) {\n    res.day = days;\n    temp.hours %= 24;\n    temp.minutes %= 24 * 60;\n    temp.seconds %= 24 * 60 * 60;\n  }\n  const hours = temp.hours + Math.trunc(temp.minutes / 60) +\n    Math.trunc(temp.seconds / (60 * 60));\n  if (hours) {\n    res.hours = hours;\n    temp.minutes %= 60;\n    temp.seconds %= 60 * 60;\n  }\n  const minutes = temp.minutes + Math.trunc(temp.seconds / 60);\n  if (minutes) {\n    res.minutes = minutes;\n    temp.seconds %= 60;\n  }\n  if (temp.seconds) {\n    res.seconds = temp.seconds;\n  }\n  return res;\n}\n\nexport function defaultedDateTimeRepresentation(rep: Partial<IDateTimeRepresentation>): IDateTimeRepresentation {\n  return {\n    ...rep,\n    day: rep.day ?? 1,\n    hours: rep.hours ?? 0,\n    month: rep.month ?? 1,\n    year: rep.year ?? 0,\n    seconds: rep.seconds ?? 0,\n    minutes: rep.minutes ?? 0,\n  };\n}\n\nexport function toDateTimeRepresentation({ date, timeZone }:\n{ date: Date; timeZone: ITimeZoneRepresentation }): IDateTimeRepresentation {\n  return {\n    year: date.getFullYear(),\n    month: date.getMonth() + 1,\n    day: date.getDate(),\n    hours: date.getHours(),\n    minutes: date.getMinutes(),\n    seconds: date.getSeconds(),\n    zoneHours: timeZone.zoneHours,\n    zoneMinutes: timeZone.zoneMinutes,\n  };\n}\n\nexport function negateDuration(dur: Partial<IDurationRepresentation>): Partial<IDurationRepresentation> {\n  return {\n    year: dur.year === undefined ? undefined : -1 * dur.year,\n    month: dur.month === undefined ? undefined : -1 * dur.month,\n    day: dur.day === undefined ? undefined : -1 * dur.day,\n    hours: dur.hours === undefined ? undefined : -1 * dur.hours,\n    minutes: dur.minutes === undefined ? undefined : -1 * dur.minutes,\n    seconds: dur.seconds === undefined ? undefined : -1 * dur.seconds,\n  };\n}\n\nexport function toJSDate(date: IDateTimeRepresentation): Date {\n  // The given hours will be assumed to be local time.\n  const res = new Date(\n    date.year,\n    date.month - 1,\n    date.day,\n    date.hours,\n    date.minutes,\n    Math.trunc(date.seconds),\n    (date.seconds % 1) * 1_000,\n  );\n  if (date.year >= 0 && date.year < 100) {\n    // Special rule of date has gone int action:\n\n    // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date#individual_date_and_time_component_values\n\n    const jumpDeltaOfDate = 1_900;\n    res.setFullYear(res.getFullYear() - jumpDeltaOfDate);\n  }\n  return res;\n}\n\nexport function toUTCDate(date: Partial<IDateTimeRepresentation>, defaultTimezone: ITimeZoneRepresentation): Date {\n  const localTime = toJSDate(defaultedDateTimeRepresentation(date));\n  // This date has been constructed in machine local time, now we alter it to become UTC and convert to correct timezone\n\n  // Correction needed from local machine timezone to UTC\n  const minutesCorrectionLocal = localTime.getTimezoneOffset();\n  // Correction needed from UTC to provided timeZone\n  const hourCorrectionUTC = date.zoneHours ?? defaultTimezone.zoneHours;\n  const minutesCorrectionUTC = date.zoneMinutes ?? defaultTimezone.zoneMinutes;\n  return new Date(\n    localTime.getTime() - (minutesCorrectionLocal + hourCorrectionUTC * 60 + minutesCorrectionUTC) * 60 * 1_000,\n  );\n}\n\nexport function trimToYearMonthDuration(dur: Partial<IDurationRepresentation>):\nPartial<IYearMonthDurationRepresentation> {\n  return {\n    year: dur.year,\n    month: dur.month,\n  };\n}\n\nexport function trimToDayTimeDuration(dur: Partial<IDurationRepresentation>): Partial<IDayTimeDurationRepresentation> {\n  return {\n    day: dur.day,\n    hours: dur.hours,\n    minutes: dur.minutes,\n    seconds: dur.seconds,\n  };\n}\n\nexport function yearMonthDurationsToMonths(dur: IYearMonthDurationRepresentation): number {\n  return dur.year * 12 + dur.month;\n}\n\nexport function dayTimeDurationsToSeconds(dur: IDayTimeDurationRepresentation): number {\n  return (((dur.day * 24) + dur.hours) * 60 + dur.minutes) * 60 + dur.seconds;\n}\n\nexport function extractRawTimeZone(zoneContained: string): string {\n  const extraction = /(Z|([+-]\\d\\d:\\d\\d))?$/u.exec(zoneContained);\n  // It is safe to cast here because the empty string can always match.\n  return extraction![0];\n}\n\nexport function extractTimeZone(date: Date): ITimeZoneRepresentation {\n  return {\n    zoneHours: date.getTimezoneOffset() / 60,\n    zoneMinutes: date.getTimezoneOffset() % 60,\n  };\n}\n"]}

package/lib/util/Errors.d.ts

@@ -0,0 +1,130 @@
+import type { Expression } from '@comunica/types';
+import type * as RDF from '@rdfjs/types';
+import type * as E from '../expressions';
+import type * as C from './Consts';
+/**
+ * This class of error will be thrown when an expression errors.
+ * Various reasons this could happen are:
+ *   - invalid types for the given operator
+ *   - unbound variables
+ *   - invalid lexical forms
+ *   - ...
+ *
+ * The distinction is made so that one can catch this specific type
+ * and handle it accordingly to the SPARQL spec (relevant for e.g. FILTER, EXTEND),
+ * while others (programming errors) can be re-thrown.
+ *
+ * @see isExpressionError
+ */
+export declare class ExpressionError extends Error {
+}
+/**
+ * Checks whether a given error is an {@link ExpressionError}.
+ * Also useful for mocking in tests for covering all branches.
+ *
+ * @see ExpressionError
+ */
+export declare function isExpressionError(error: Error): boolean;
+/**
+ * A literal has an invalid lexical form for the datatype it is accompanied by.
+ * This error is only thrown when the term is as function argument that requires
+ * a valid lexical form.
+ */
+export declare class InvalidLexicalForm extends ExpressionError {
+    arg: RDF.Term;
+    constructor(arg: RDF.Term);
+}
+/**
+ * A variable in the expression was not bound.
+ */
+export declare class UnboundVariableError extends ExpressionError {
+    variable: string;
+    bindings: RDF.Bindings;
+    constructor(variable: string, bindings: RDF.Bindings);
+}
+/**
+ * An invalid term was being coerced to an Effective Boolean Value.
+ *
+ * See the {@link https://www.w3.org/TR/sparql11-query/#ebv | SPARQL docs}
+ * on EBVs.
+ */
+export declare class EBVCoercionError extends ExpressionError {
+    arg: E.Term;
+    constructor(arg: E.Term);
+}
+/**
+ * An equality test was done on literals with unsupported datatypes.
+ *
+ * See {@link https://www.w3.org/TR/sparql11-query/#func-RDFterm-equal | term equality spec}.
+ */
+export declare class RDFEqualTypeError extends ExpressionError {
+    args: Expression[];
+    constructor(args: Expression[]);
+}
+/**
+ * All the expressions in a COALESCE call threw errors.
+ */
+export declare class CoalesceError extends ExpressionError {
+    errors: Error[];
+    constructor(errors: Error[]);
+}
+/**
+ * No arguments to an IN call where equal, and at least one threw an error.
+ */
+export declare class InError extends ExpressionError {
+    errors: (Error | false)[];
+    constructor(errors: (Error | false)[]);
+}
+/**
+ * Literals were passed to an operator that doesn't support their datatypes.
+ */
+export declare class InvalidArgumentTypes extends ExpressionError {
+    args: Expression[];
+    op: C.GeneralOperator;
+    constructor(args: Expression[], op: C.GeneralOperator);
+}
+/**
+ * An invalid typecast happened.
+ */
+export declare class CastError<T> extends ExpressionError {
+    arg: T;
+    constructor(arg: T, cast: C.TypeURL);
+}
+export declare class InvalidTimezoneCall extends ExpressionError {
+    dateString: string;
+    constructor(dateString: string);
+}
+export declare class IncompatibleLanguageOperation extends ExpressionError {
+    arg1: E.LangStringLiteral;
+    arg2: E.LangStringLiteral;
+    constructor(arg1: E.LangStringLiteral, arg2: E.LangStringLiteral);
+}
+export declare class EmptyAggregateError extends ExpressionError {
+    constructor();
+}
+export declare class ParseError extends ExpressionError {
+    constructor(str: string, type: string);
+}
+/**
+ * An error that arises when we detect a 'should-be-impossible' state.
+ * Given that this error is thrown, it clearly wasn't impossible, and some
+ * mistake has been made.
+ */
+export declare class UnexpectedError<T> extends Error {
+    payload?: T | undefined;
+    constructor(message: string, payload?: T | undefined);
+}
+export declare class InvalidArity extends Error {
+    args: Expression[];
+    op: C.GeneralOperator;
+    constructor(args: Expression[], op: C.GeneralOperator);
+}
+export declare class InvalidExpression<T> extends Error {
+    constructor(expr: T);
+}
+export declare class ExtensionFunctionError extends Error {
+    constructor(name: string, functionError: unknown);
+}
+export declare class NoAggregator extends Error {
+    constructor(name?: string);
+}

package/lib/util/Errors.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoAggregator = exports.ExtensionFunctionError = exports.InvalidExpression = exports.InvalidArity = exports.UnexpectedError = exports.ParseError = exports.EmptyAggregateError = exports.IncompatibleLanguageOperation = exports.InvalidTimezoneCall = exports.CastError = exports.InvalidArgumentTypes = exports.InError = exports.CoalesceError = exports.RDFEqualTypeError = exports.EBVCoercionError = exports.UnboundVariableError = exports.InvalidLexicalForm = exports.isExpressionError = exports.ExpressionError = void 0;
+/**
+ * This class of error will be thrown when an expression errors.
+ * Various reasons this could happen are:
+ *   - invalid types for the given operator
+ *   - unbound variables
+ *   - invalid lexical forms
+ *   - ...
+ *
+ * The distinction is made so that one can catch this specific type
+ * and handle it accordingly to the SPARQL spec (relevant for e.g. FILTER, EXTEND),
+ * while others (programming errors) can be re-thrown.
+ *
+ * @see isExpressionError
+ */
+class ExpressionError extends Error {
+}
+exports.ExpressionError = ExpressionError;
+/**
+ * Checks whether a given error is an {@link ExpressionError}.
+ * Also useful for mocking in tests for covering all branches.
+ *
+ * @see ExpressionError
+ */
+function isExpressionError(error) {
+    return error instanceof ExpressionError;
+}
+exports.isExpressionError = isExpressionError;
+/**
+ * A literal has an invalid lexical form for the datatype it is accompanied by.
+ * This error is only thrown when the term is as function argument that requires
+ * a valid lexical form.
+ */
+class InvalidLexicalForm extends ExpressionError {
+    constructor(arg) {
+        super(`Invalid lexical form '${pp(arg)}'`);
+        this.arg = arg;
+    }
+}
+exports.InvalidLexicalForm = InvalidLexicalForm;
+/**
+ * A variable in the expression was not bound.
+ */
+class UnboundVariableError extends ExpressionError {
+    constructor(variable, bindings) {
+        super(`Unbound variable '${pp(variable)}'`);
+        this.variable = variable;
+        this.bindings = bindings;
+    }
+}
+exports.UnboundVariableError = UnboundVariableError;
+/**
+ * An invalid term was being coerced to an Effective Boolean Value.
+ *
+ * See the {@link https://www.w3.org/TR/sparql11-query/#ebv | SPARQL docs}
+ * on EBVs.
+ */
+class EBVCoercionError extends ExpressionError {
+    constructor(arg) {
+        super(`Cannot coerce term to EBV '${pp(arg)}'`);
+        this.arg = arg;
+    }
+}
+exports.EBVCoercionError = EBVCoercionError;
+/**
+ * An equality test was done on literals with unsupported datatypes.
+ *
+ * See {@link https://www.w3.org/TR/sparql11-query/#func-RDFterm-equal | term equality spec}.
+ */
+class RDFEqualTypeError extends ExpressionError {
+    constructor(args) {
+        super('Equality test for literals with unsupported datatypes');
+        this.args = args;
+    }
+}
+exports.RDFEqualTypeError = RDFEqualTypeError;
+/**
+ * All the expressions in a COALESCE call threw errors.
+ */
+class CoalesceError extends ExpressionError {
+    constructor(errors) {
+        super('All COALESCE arguments threw errors');
+        this.errors = errors;
+    }
+}
+exports.CoalesceError = CoalesceError;
+/**
+ * No arguments to an IN call where equal, and at least one threw an error.
+ */
+class InError extends ExpressionError {
+    constructor(errors) {
+        super(`Some argument to IN errorred and none where equal. ${errors.map(err => `(${err.toString()}) `).join('and ')}`);
+        this.errors = errors;
+    }
+}
+exports.InError = InError;
+/**
+ * Literals were passed to an operator that doesn't support their datatypes.
+ */
+class InvalidArgumentTypes extends ExpressionError {
+    constructor(args, op) {
+        super(`Argument types not valid for operator: '${pp(op)}' with '${pp(args)}`);
+        this.args = args;
+        this.op = op;
+    }
+}
+exports.InvalidArgumentTypes = InvalidArgumentTypes;
+/**
+ * An invalid typecast happened.
+ */
+class CastError extends ExpressionError {
+    constructor(arg, cast) {
+        super(`Invalid cast: '${pp(arg)}' to '${pp(cast)}'`);
+        this.arg = arg;
+    }
+}
+exports.CastError = CastError;
+class InvalidTimezoneCall extends ExpressionError {
+    constructor(dateString) {
+        super(`TIMEZONE call on ${dateString} which has no timezone`);
+        this.dateString = dateString;
+    }
+}
+exports.InvalidTimezoneCall = InvalidTimezoneCall;
+class IncompatibleLanguageOperation extends ExpressionError {
+    constructor(arg1, arg2) {
+        super(`Operation on incompatible language literals '${pp(arg1)}' and '${pp(arg2)}'`);
+        this.arg1 = arg1;
+        this.arg2 = arg2;
+    }
+}
+exports.IncompatibleLanguageOperation = IncompatibleLanguageOperation;
+class EmptyAggregateError extends ExpressionError {
+    constructor() {
+        super('Empty aggregate expression');
+    }
+}
+exports.EmptyAggregateError = EmptyAggregateError;
+class ParseError extends ExpressionError {
+    constructor(str, type) {
+        super(`Failed to parse "${str}" as ${type}.`);
+    }
+}
+exports.ParseError = ParseError;
+// Non Expression Errors ------------------------------------------------------
+/**
+ * An error that arises when we detect a 'should-be-impossible' state.
+ * Given that this error is thrown, it clearly wasn't impossible, and some
+ * mistake has been made.
+ */
+class UnexpectedError extends Error {
+    constructor(message, payload) {
+        super(`Programmer Error '${message}'`);
+        this.payload = payload;
+    }
+}
+exports.UnexpectedError = UnexpectedError;
+class InvalidArity extends Error {
+    constructor(args, op) {
+        super(`The number of args does not match the arity of the operator '${pp(op)}'.`);
+        this.args = args;
+        this.op = op;
+    }
+}
+exports.InvalidArity = InvalidArity;
+class InvalidExpression extends Error {
+    constructor(expr) {
+        super(`Invalid SPARQL Expression '${pp(expr)}'`);
+    }
+}
+exports.InvalidExpression = InvalidExpression;
+class ExtensionFunctionError extends Error {
+    constructor(name, functionError) {
+        if (functionError instanceof Error) {
+            super(`Error thrown in ${name}: ${functionError.message}${functionError.stack ? `\n${functionError.stack}` : ''}`);
+        }
+        else {
+            super(`Error thrown in ${name}`);
+        }
+    }
+}
+exports.ExtensionFunctionError = ExtensionFunctionError;
+class NoAggregator extends Error {
+    constructor(name) {
+        super(`Aggregate expression ${pp(name)} found, but no aggregate hook provided.`);
+    }
+}
+exports.NoAggregator = NoAggregator;
+function pp(object) {
+    return JSON.stringify(object);
+}
+//# sourceMappingURL=Errors.js.map

package/lib/util/Errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.js","sourceRoot":"","sources":["Errors.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Expression } from '@comunica/types';\nimport type * as RDF from '@rdfjs/types';\nimport type * as E from '../expressions';\nimport type * as C from './Consts';\n\n/**\n * This class of error will be thrown when an expression errors.\n * Various reasons this could happen are:\n *   - invalid types for the given operator\n *   - unbound variables\n *   - invalid lexical forms\n *   - ...\n *\n * The distinction is made so that one can catch this specific type\n * and handle it accordingly to the SPARQL spec (relevant for e.g. FILTER, EXTEND),\n * while others (programming errors) can be re-thrown.\n *\n * @see isExpressionError\n */\nexport class ExpressionError extends Error {}\n\n/**\n * Checks whether a given error is an {@link ExpressionError}.\n * Also useful for mocking in tests for covering all branches.\n *\n * @see ExpressionError\n */\nexport function isExpressionError(error: Error): boolean {\n  return error instanceof ExpressionError;\n}\n\n/**\n * A literal has an invalid lexical form for the datatype it is accompanied by.\n * This error is only thrown when the term is as function argument that requires\n * a valid lexical form.\n */\nexport class InvalidLexicalForm extends ExpressionError {\n  public constructor(public arg: RDF.Term) {\n    super(`Invalid lexical form '${pp(arg)}'`);\n  }\n}\n\n/**\n * A variable in the expression was not bound.\n */\nexport class UnboundVariableError extends ExpressionError {\n  public constructor(public variable: string, public bindings: RDF.Bindings) {\n    super(`Unbound variable '${pp(variable)}'`);\n  }\n}\n\n/**\n * An invalid term was being coerced to an Effective Boolean Value.\n *\n * See the {@link https://www.w3.org/TR/sparql11-query/#ebv | SPARQL docs}\n * on EBVs.\n */\nexport class EBVCoercionError extends ExpressionError {\n  public constructor(public arg: E.Term) {\n    super(`Cannot coerce term to EBV '${pp(arg)}'`);\n  }\n}\n\n/**\n * An equality test was done on literals with unsupported datatypes.\n *\n * See {@link https://www.w3.org/TR/sparql11-query/#func-RDFterm-equal | term equality spec}.\n */\nexport class RDFEqualTypeError extends ExpressionError {\n  public constructor(public args: Expression[]) {\n    super('Equality test for literals with unsupported datatypes');\n  }\n}\n\n/**\n * All the expressions in a COALESCE call threw errors.\n */\nexport class CoalesceError extends ExpressionError {\n  public constructor(public errors: Error[]) {\n    super('All COALESCE arguments threw errors');\n  }\n}\n\n/**\n * No arguments to an IN call where equal, and at least one threw an error.\n */\nexport class InError extends ExpressionError {\n  public constructor(public errors: (Error | false)[]) {\n    super(\n      `Some argument to IN errorred and none where equal. ${\n\n        errors.map(err => `(${err.toString()}) `).join('and ')}`,\n    );\n  }\n}\n\n/**\n * Literals were passed to an operator that doesn't support their datatypes.\n */\nexport class InvalidArgumentTypes extends ExpressionError {\n  public constructor(public args: Expression[], public op: C.GeneralOperator) {\n    super(`Argument types not valid for operator: '${pp(op)}' with '${pp(args)}`);\n  }\n}\n\n/**\n * An invalid typecast happened.\n */\nexport class CastError<T> extends ExpressionError {\n  public constructor(public arg: T, cast: C.TypeURL) {\n    super(`Invalid cast: '${pp(arg)}' to '${pp(cast)}'`);\n  }\n}\n\nexport class InvalidTimezoneCall extends ExpressionError {\n  public constructor(public dateString: string) {\n    super(`TIMEZONE call on ${dateString} which has no timezone`);\n  }\n}\n\nexport class IncompatibleLanguageOperation extends ExpressionError {\n  public constructor(public arg1: E.LangStringLiteral, public arg2: E.LangStringLiteral) {\n    super(`Operation on incompatible language literals '${pp(arg1)}' and '${pp(arg2)}'`);\n  }\n}\n\nexport class EmptyAggregateError extends ExpressionError {\n  public constructor() {\n    super('Empty aggregate expression');\n  }\n}\n\nexport class ParseError extends ExpressionError {\n  public constructor(str: string, type: string) {\n    super(`Failed to parse \"${str}\" as ${type}.`);\n  }\n}\n\n// Non Expression Errors ------------------------------------------------------\n\n/**\n * An error that arises when we detect a 'should-be-impossible' state.\n * Given that this error is thrown, it clearly wasn't impossible, and some\n * mistake has been made.\n */\nexport class UnexpectedError<T> extends Error {\n  public constructor(message: string, public payload?: T) {\n    super(`Programmer Error '${message}'`);\n  }\n}\n\nexport class InvalidArity extends Error {\n  public constructor(public args: Expression[], public op: C.GeneralOperator) {\n    super(`The number of args does not match the arity of the operator '${pp(op)}'.`);\n  }\n}\n\nexport class InvalidExpression<T> extends Error {\n  public constructor(expr: T) {\n    super(`Invalid SPARQL Expression '${pp(expr)}'`);\n  }\n}\n\nexport class ExtensionFunctionError extends Error {\n  public constructor(name: string, functionError: unknown) {\n    if (functionError instanceof Error) {\n      super(`Error thrown in ${name}: ${functionError.message}${functionError.stack ? `\\n${functionError.stack}` : ''}`);\n    } else {\n      super(`Error thrown in ${name}`);\n    }\n  }\n}\n\nexport class NoAggregator extends Error {\n  public constructor(name?: string) {\n    super(`Aggregate expression ${pp(name)} found, but no aggregate hook provided.`);\n  }\n}\n\nfunction pp<T>(object: T): string {\n  return JSON.stringify(object);\n}\n"]}

package/lib/util/Parsing.d.ts

@@ -0,0 +1,25 @@
+import type { IDateRepresentation, IDateTimeRepresentation, IDayTimeDurationRepresentation, IDurationRepresentation, ITimeRepresentation, IYearMonthDurationRepresentation } from '@comunica/types';
+/**
+ * TODO: Fix decently
+ * Parses float datatypes (double, float).
+ *
+ * All invalid lexical values return undefined.
+ *
+ * @param value the string to interpret as a number
+ */
+export declare function parseXSDFloat(value: string): number | undefined;
+/**
+ * Parses decimal datatypes (decimal, int, byte, nonPositiveInteger, etc...).
+ *
+ * All other values, including NaN, INF, and floating point numbers all
+ * return undefined;
+ *
+ * @param value the string to interpret as a number
+ */
+export declare function parseXSDDecimal(value: string): number | undefined;
+export declare function parseDateTime(dateTimeStr: string): IDateTimeRepresentation;
+export declare function parseDate(dateStr: string): IDateRepresentation;
+export declare function parseTime(timeStr: string): ITimeRepresentation;
+export declare function parseDuration(durationStr: string): Partial<IDurationRepresentation>;
+export declare function parseYearMonthDuration(durationStr: string): Partial<IYearMonthDurationRepresentation>;
+export declare function parseDayTimeDuration(durationStr: string): Partial<IDayTimeDurationRepresentation>;