@comunica/actor-init-query 2.0.1-alpha.5.0 → 2.0.1-alpha.6.0

package/components/ActorInitQuery.jsonld

@@ -217,15 +217,9 @@
           "comment": "Actor that must be registered in the bus before this actor."
         }
       ],
-      "memberFields": [
-        {
-          "@id": "caiq:components/ActorInitQuery.jsonld#ActorInitQuery__member_constructor",
-          "memberFieldName": "constructor"
-        },
-        {
-          "@id": "caiq:components/ActorInitQuery.jsonld#ActorInitQuery__member_run",
-          "memberFieldName": "run"
-        }
+      "memberKeys": [
+        "constructor",
+        "run"
       ],
       "constructorArguments": [
         {

package/components/ActorInitQueryBase.jsonld

@@ -218,86 +218,23 @@
           "comment": "Actor that must be registered in the bus before this actor."
         }
       ],
-      "memberFields": [
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_mediatorOptimizeQueryOperation",
-          "memberFieldName": "mediatorOptimizeQueryOperation",
-          "range": "cc:components/Mediator.jsonld#Mediator"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_mediatorQueryOperation",
-          "memberFieldName": "mediatorQueryOperation",
-          "range": "cc:components/Mediator.jsonld#Mediator"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_mediatorQueryParse",
-          "memberFieldName": "mediatorQueryParse",
-          "range": "cc:components/Mediator.jsonld#Mediator"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_mediatorQueryResultSerialize",
-          "memberFieldName": "mediatorQueryResultSerialize",
-          "range": "cc:components/Mediator.jsonld#Mediator"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_mediatorQueryResultSerializeMediaTypeCombiner",
-          "memberFieldName": "mediatorQueryResultSerializeMediaTypeCombiner",
-          "range": "cc:components/Mediator.jsonld#Mediator"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_mediatorQueryResultSerializeMediaTypeFormatCombiner",
-          "memberFieldName": "mediatorQueryResultSerializeMediaTypeFormatCombiner",
-          "range": "cc:components/Mediator.jsonld#Mediator"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_mediatorContextPreprocess",
-          "memberFieldName": "mediatorContextPreprocess",
-          "range": "cc:components/Mediator.jsonld#Mediator"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_mediatorHttpInvalidate",
-          "memberFieldName": "mediatorHttpInvalidate",
-          "range": "cc:components/Mediator.jsonld#Mediator"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_logger",
-          "memberFieldName": "logger",
-          "range": "cc:components/Logger.jsonld#Logger"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_queryString",
-          "memberFieldName": "queryString",
-          "range": "xsd:string"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_defaultQueryInputFormat",
-          "memberFieldName": "defaultQueryInputFormat",
-          "range": "xsd:string"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_context",
-          "memberFieldName": "context",
-          "range": "xsd:string"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_contextKeyShortcuts",
-          "memberFieldName": "contextKeyShortcuts",
-          "range": {
-            "@type": "ParameterRangeWildcard"
-          }
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_constructor",
-          "memberFieldName": "constructor"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_test",
-          "memberFieldName": "test"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase__member_run",
-          "memberFieldName": "run"
-        }
+      "memberKeys": [
+        "mediatorOptimizeQueryOperation",
+        "mediatorQueryOperation",
+        "mediatorQueryParse",
+        "mediatorQueryResultSerialize",
+        "mediatorQueryResultSerializeMediaTypeCombiner",
+        "mediatorQueryResultSerializeMediaTypeFormatCombiner",
+        "mediatorContextPreprocess",
+        "mediatorHttpInvalidate",
+        "logger",
+        "queryString",
+        "defaultQueryInputFormat",
+        "context",
+        "contextKeyShortcuts",
+        "constructor",
+        "test",
+        "run"
       ],
       "constructorArguments": [
         {
@@ -408,59 +345,20 @@
       "@type": "AbstractClass",
       "requireElement": "IActorInitQueryBaseArgs",
       "parameters": [],
-      "memberFields": [
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_mediatorOptimizeQueryOperation",
-          "memberFieldName": "mediatorOptimizeQueryOperation"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_mediatorQueryOperation",
-          "memberFieldName": "mediatorQueryOperation"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_mediatorQueryParse",
-          "memberFieldName": "mediatorQueryParse"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_mediatorQueryResultSerialize",
-          "memberFieldName": "mediatorQueryResultSerialize"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_mediatorQueryResultSerializeMediaTypeCombiner",
-          "memberFieldName": "mediatorQueryResultSerializeMediaTypeCombiner"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_mediatorQueryResultSerializeMediaTypeFormatCombiner",
-          "memberFieldName": "mediatorQueryResultSerializeMediaTypeFormatCombiner"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_mediatorContextPreprocess",
-          "memberFieldName": "mediatorContextPreprocess"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_mediatorHttpInvalidate",
-          "memberFieldName": "mediatorHttpInvalidate"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_logger",
-          "memberFieldName": "logger"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_queryString",
-          "memberFieldName": "queryString"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_defaultQueryInputFormat",
-          "memberFieldName": "defaultQueryInputFormat"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_context",
-          "memberFieldName": "context"
-        },
-        {
-          "@id": "caiq:components/ActorInitQueryBase.jsonld#IActorInitQueryBaseArgs__member_contextKeyShortcuts",
-          "memberFieldName": "contextKeyShortcuts"
-        }
+      "memberKeys": [
+        "mediatorOptimizeQueryOperation",
+        "mediatorQueryOperation",
+        "mediatorQueryParse",
+        "mediatorQueryResultSerialize",
+        "mediatorQueryResultSerializeMediaTypeCombiner",
+        "mediatorQueryResultSerializeMediaTypeFormatCombiner",
+        "mediatorContextPreprocess",
+        "mediatorHttpInvalidate",
+        "logger",
+        "queryString",
+        "defaultQueryInputFormat",
+        "context",
+        "contextKeyShortcuts"
       ],
       "constructorArguments": []
     }

package/components/HttpServiceSparqlEndpoint.jsonld

@@ -9,15 +9,9 @@
       "@type": "AbstractClass",
       "requireElement": "IQueryBody",
       "parameters": [],
-      "memberFields": [
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IQueryBody__member_type",
-          "memberFieldName": "type"
-        },
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IQueryBody__member_value",
-          "memberFieldName": "value"
-        }
+      "memberKeys": [
+        "type",
+        "value"
       ],
       "constructorArguments": []
     },
@@ -26,35 +20,14 @@
       "@type": "AbstractClass",
       "requireElement": "IHttpServiceSparqlEndpointArgs",
       "parameters": [],
-      "memberFields": [
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IHttpServiceSparqlEndpointArgs__member_context",
-          "memberFieldName": "context"
-        },
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IHttpServiceSparqlEndpointArgs__member_timeout",
-          "memberFieldName": "timeout"
-        },
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IHttpServiceSparqlEndpointArgs__member_port",
-          "memberFieldName": "port"
-        },
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IHttpServiceSparqlEndpointArgs__member_workers",
-          "memberFieldName": "workers"
-        },
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IHttpServiceSparqlEndpointArgs__member_invalidateCacheBeforeQuery",
-          "memberFieldName": "invalidateCacheBeforeQuery"
-        },
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IHttpServiceSparqlEndpointArgs__member_moduleRootPath",
-          "memberFieldName": "moduleRootPath"
-        },
-        {
-          "@id": "caiq:components/HttpServiceSparqlEndpoint.jsonld#IHttpServiceSparqlEndpointArgs__member_defaultConfigPath",
-          "memberFieldName": "defaultConfigPath"
-        }
+      "memberKeys": [
+        "context",
+        "timeout",
+        "port",
+        "workers",
+        "invalidateCacheBeforeQuery",
+        "moduleRootPath",
+        "defaultConfigPath"
       ],
       "constructorArguments": []
     }

package/components/MemoryPhysicalQueryPlanLogger.jsonld

@@ -14,39 +14,15 @@
       ],
       "comment": "A physical query plan logger that stores everything in memory.",
       "parameters": [],
-      "memberFields": [
-        {
-          "@id": "caiq:components/MemoryPhysicalQueryPlanLogger.jsonld#MemoryPhysicalQueryPlanLogger__member_children",
-          "memberFieldName": "children"
-        },
-        {
-          "@id": "caiq:components/MemoryPhysicalQueryPlanLogger.jsonld#MemoryPhysicalQueryPlanLogger__member_rootNode",
-          "memberFieldName": "rootNode"
-        },
-        {
-          "@id": "caiq:components/MemoryPhysicalQueryPlanLogger.jsonld#MemoryPhysicalQueryPlanLogger__member_constructor",
-          "memberFieldName": "constructor"
-        },
-        {
-          "@id": "caiq:components/MemoryPhysicalQueryPlanLogger.jsonld#MemoryPhysicalQueryPlanLogger__member_logOperation",
-          "memberFieldName": "logOperation"
-        },
-        {
-          "@id": "caiq:components/MemoryPhysicalQueryPlanLogger.jsonld#MemoryPhysicalQueryPlanLogger__member_toJson",
-          "memberFieldName": "toJson"
-        },
-        {
-          "@id": "caiq:components/MemoryPhysicalQueryPlanLogger.jsonld#MemoryPhysicalQueryPlanLogger__member_planNodeToJson",
-          "memberFieldName": "planNodeToJson"
-        },
-        {
-          "@id": "caiq:components/MemoryPhysicalQueryPlanLogger.jsonld#MemoryPhysicalQueryPlanLogger__member_getLogicalMetadata",
-          "memberFieldName": "getLogicalMetadata"
-        },
-        {
-          "@id": "caiq:components/MemoryPhysicalQueryPlanLogger.jsonld#MemoryPhysicalQueryPlanLogger__member_quadToString",
-          "memberFieldName": "quadToString"
-        }
+      "memberKeys": [
+        "children",
+        "rootNode",
+        "constructor",
+        "logOperation",
+        "toJson",
+        "planNodeToJson",
+        "getLogicalMetadata",
+        "quadToString"
       ],
       "constructorArguments": []
     }

package/components/QueryEngineBase.jsonld

@@ -15,67 +15,23 @@
           "range": "caiq:components/ActorInitQueryBase.jsonld#ActorInitQueryBase"
         }
       ],
-      "memberFields": [
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_actorInitQuery",
-          "memberFieldName": "actorInitQuery"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_constructor",
-          "memberFieldName": "constructor"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_queryBindings",
-          "memberFieldName": "queryBindings"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_queryQuads",
-          "memberFieldName": "queryQuads"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_queryBoolean",
-          "memberFieldName": "queryBoolean"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_queryVoid",
-          "memberFieldName": "queryVoid"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_queryOfType",
-          "memberFieldName": "queryOfType"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_query",
-          "memberFieldName": "query"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_queryOrExplain",
-          "memberFieldName": "queryOrExplain"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_getResultMediaTypes",
-          "memberFieldName": "getResultMediaTypes"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_getResultMediaTypeFormats",
-          "memberFieldName": "getResultMediaTypeFormats"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_resultToString",
-          "memberFieldName": "resultToString"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_invalidateHttpCache",
-          "memberFieldName": "invalidateHttpCache"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_internalToFinalResult",
-          "memberFieldName": "internalToFinalResult"
-        },
-        {
-          "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase__member_finalToInternalResult",
-          "memberFieldName": "finalToInternalResult"
-        }
+      "memberKeys": [
+        "actorInitQuery",
+        "constructor",
+        "queryBindings",
+        "queryQuads",
+        "queryBoolean",
+        "queryVoid",
+        "queryOfType",
+        "query",
+        "explain",
+        "queryOrExplain",
+        "getResultMediaTypes",
+        "getResultMediaTypeFormats",
+        "resultToString",
+        "invalidateHttpCache",
+        "internalToFinalResult",
+        "finalToInternalResult"
       ],
       "constructorArguments": [
         {

package/components/QueryEngineFactoryBase.jsonld

@@ -13,19 +13,10 @@
         "cr:components/Setup.jsonld#ISetupProperties"
       ],
       "parameters": [],
-      "memberFields": [
-        {
-          "@id": "caiq:components/QueryEngineFactoryBase.jsonld#IDynamicQueryEngineOptions__member_configPath",
-          "memberFieldName": "configPath"
-        },
-        {
-          "@id": "caiq:components/QueryEngineFactoryBase.jsonld#IDynamicQueryEngineOptions__member_instanceUri",
-          "memberFieldName": "instanceUri"
-        },
-        {
-          "@id": "caiq:components/QueryEngineFactoryBase.jsonld#IDynamicQueryEngineOptions__member_runnerInstanceUri",
-          "memberFieldName": "runnerInstanceUri"
-        }
+      "memberKeys": [
+        "configPath",
+        "instanceUri",
+        "runnerInstanceUri"
       ],
       "constructorArguments": []
     }

package/components/cli/CliArgsHandlerBase.jsonld

@@ -27,35 +27,14 @@
           }
         }
       ],
-      "memberFields": [
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase__member_initialContext",
-          "memberFieldName": "initialContext"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase__member_constructor",
-          "memberFieldName": "constructor"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase__member_getScriptOutput",
-          "memberFieldName": "getScriptOutput"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase__member_isDevelopmentEnvironment",
-          "memberFieldName": "isDevelopmentEnvironment"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase__member_getSourceObjectFromString",
-          "memberFieldName": "getSourceObjectFromString"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase__member_populateYargs",
-          "memberFieldName": "populateYargs"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase__member_handleArgs",
-          "memberFieldName": "handleArgs"
-        }
+      "memberKeys": [
+        "initialContext",
+        "constructor",
+        "getScriptOutput",
+        "isDevelopmentEnvironment",
+        "getSourceObjectFromString",
+        "populateYargs",
+        "handleArgs"
       ],
       "constructorArguments": [
         {

package/components/cli/CliArgsHandlerHttp.jsonld

@@ -14,15 +14,9 @@
       ],
       "comment": "CLI arguments handler that handles options for HTTP servers.",
       "parameters": [],
-      "memberFields": [
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerHttp.jsonld#CliArgsHandlerHttp__member_populateYargs",
-          "memberFieldName": "populateYargs"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerHttp.jsonld#CliArgsHandlerHttp__member_handleArgs",
-          "memberFieldName": "handleArgs"
-        }
+      "memberKeys": [
+        "populateYargs",
+        "handleArgs"
       ],
       "constructorArguments": []
     }

package/components/cli/CliArgsHandlerQuery.jsonld

@@ -51,31 +51,13 @@
           }
         }
       ],
-      "memberFields": [
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerQuery.jsonld#CliArgsHandlerQuery__member_defaultQueryInputFormat",
-          "memberFieldName": "defaultQueryInputFormat"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerQuery.jsonld#CliArgsHandlerQuery__member_queryString",
-          "memberFieldName": "queryString"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerQuery.jsonld#CliArgsHandlerQuery__member_context",
-          "memberFieldName": "context"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerQuery.jsonld#CliArgsHandlerQuery__member_constructor",
-          "memberFieldName": "constructor"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerQuery.jsonld#CliArgsHandlerQuery__member_populateYargs",
-          "memberFieldName": "populateYargs"
-        },
-        {
-          "@id": "caiq:components/cli/CliArgsHandlerQuery.jsonld#CliArgsHandlerQuery__member_handleArgs",
-          "memberFieldName": "handleArgs"
-        }
+      "memberKeys": [
+        "defaultQueryInputFormat",
+        "queryString",
+        "context",
+        "constructor",
+        "populateYargs",
+        "handleArgs"
       ],
       "constructorArguments": [
         {

package/components/context.jsonld

@@ -10,6 +10,9 @@
         "@context": {
           "actorInitQuery": {
             "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase_actorInitQuery"
+          },
+          "": {
+            "@id": "caiq:components/QueryEngineBase.jsonld#QueryEngineBase_actorInitQuery"
           }
         }
       },
@@ -246,6 +249,9 @@
         "@context": {
           "initialContext": {
             "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase_initialContext"
+          },
+          "": {
+            "@id": "caiq:components/cli/CliArgsHandlerBase.jsonld#CliArgsHandlerBase_initialContext"
           }
         }
       },
@@ -272,6 +278,9 @@
           },
           "ing": {
             "@id": "caiq:components/cli/CliArgsHandlerQuery.jsonld#CliArgsHandlerQuery_queryString"
+          },
+          "": {
+            "@id": "caiq:components/cli/CliArgsHandlerQuery.jsonld#CliArgsHandlerQuery_context"
           }
         }
       },

package/lib/QueryEngineBase.d.ts

@@ -1,5 +1,5 @@
 import type { IActorQueryResultSerializeOutput } from '@comunica/bus-query-result-serialize';
-import type { IQueryOperationResult, IQueryEngine, IQueryExplained, QueryFormatType, QueryType, BindingsStream, QueryAlgebraContext, QueryStringContext, QueryEnhanced } from '@comunica/types';
+import type { IQueryOperationResult, IQueryEngine, IQueryExplained, QueryFormatType, QueryType, QueryExplainMode, BindingsStream, QueryAlgebraContext, QueryStringContext, QueryEnhanced } from '@comunica/types';
 import type * as RDF from '@rdfjs/types';
 import type { AsyncIterator } from 'asynciterator';
 import type { ActorInitQueryBase } from './ActorInitQueryBase';
@@ -21,6 +21,15 @@ export declare class QueryEngineBase implements IQueryEngine {
      * @return {Promise<QueryType>} A promise that resolves to the query output.
      */
     query<QueryFormatTypeInner extends QueryFormatType>(query: QueryFormatTypeInner, context?: QueryFormatTypeInner extends string ? QueryStringContext : QueryAlgebraContext): Promise<QueryType>;
+    /**
+     * Explain the given query
+     * @param {string | Algebra.Operation} query A query string or algebra.
+     * @param context An optional query context.
+     * @param explainMode The explain mode.
+     * @return {Promise<QueryType | IQueryExplained>} A promise that resolves to
+     *                                                               the query output or explanation.
+     */
+    explain<QueryFormatTypeInner extends QueryFormatType>(query: QueryFormatTypeInner, context: QueryFormatTypeInner extends string ? QueryStringContext : QueryAlgebraContext, explainMode: QueryExplainMode): Promise<IQueryExplained>;
     /**
      * Evaluate or explain the given query
      * @param {string | Algebra.Operation} query A query string or algebra.

package/lib/QueryEngineBase.js

@@ -44,6 +44,19 @@ class QueryEngineBase {
         }
         return output;
     }
+    /**
+     * Explain the given query
+     * @param {string | Algebra.Operation} query A query string or algebra.
+     * @param context An optional query context.
+     * @param explainMode The explain mode.
+     * @return {Promise<QueryType | IQueryExplained>} A promise that resolves to
+     *                                                               the query output or explanation.
+     */
+    async explain(query, context, explainMode) {
+        context.explain = explainMode;
+        const output = await this.queryOrExplain(query, context);
+        return output;
+    }
     /**
      * Evaluate or explain the given query
      * @param {string | Algebra.Operation} query A query string or algebra.
@@ -66,21 +79,16 @@ class QueryEngineBase {
         if (actionContext.has(context_entries_1.KeysInitQuery.queryFormat)) {
             queryFormat = actionContext.get(context_entries_1.KeysInitQuery.queryFormat);
             actionContext = actionContext.delete(context_entries_1.KeysInitQuery.queryFormat);
-            if (queryFormat.language === 'graphql' && !actionContext.has(context_entries_1.KeysInitQuery.graphqlSingularizeVariables)) {
-                actionContext = actionContext.set(context_entries_1.KeysInitQuery.graphqlSingularizeVariables, {});
+            if (queryFormat.language === 'graphql') {
+                actionContext = actionContext.setDefault(context_entries_1.KeysInitQuery.graphqlSingularizeVariables, {});
             }
         }
-        let baseIRI;
-        if (actionContext.has(context_entries_1.KeysInitQuery.baseIRI)) {
-            baseIRI = actionContext.get(context_entries_1.KeysInitQuery.baseIRI);
-        }
-        if (!actionContext.has(context_entries_1.KeysInitQuery.queryTimestamp)) {
-            actionContext = actionContext.set(context_entries_1.KeysInitQuery.queryTimestamp, new Date());
-        }
-        // Set the default logger if none is provided
-        if (!actionContext.has(context_entries_1.KeysCore.log)) {
-            actionContext = actionContext.set(context_entries_1.KeysCore.log, this.actorInitQuery.logger);
-        }
+        const baseIRI = actionContext.get(context_entries_1.KeysInitQuery.baseIRI);
+        actionContext = actionContext
+            .setDefault(context_entries_1.KeysInitQuery.queryTimestamp, new Date())
+            .setDefault(context_entries_1.KeysRdfResolveQuadPattern.sourceIds, new Map())
+            // Set the default logger if none is provided
+            .setDefault(context_entries_1.KeysCore.log, this.actorInitQuery.logger);
         // Pre-processing the context
         actionContext = (await this.actorInitQuery.mediatorContextPreprocess.mediate({ context: actionContext })).context;
         // Determine explain mode
@@ -256,13 +264,13 @@ class QueryEngineBase {
             case 'boolean':
                 return {
                     resultType: 'boolean',
-                    execute: async () => internalResult.booleanResult,
+                    execute: async () => internalResult.execute(),
                     context: internalResult.context,
                 };
             case 'void':
                 return {
                     resultType: 'void',
-                    execute: async () => internalResult.voidResult,
+                    execute: async () => internalResult.execute(),
                     context: internalResult.context,
                 };
         }
@@ -288,12 +296,12 @@ class QueryEngineBase {
             case 'boolean':
                 return {
                     type: 'boolean',
-                    booleanResult: finalResult.execute(),
+                    execute: () => finalResult.execute(),
                 };
             case 'void':
                 return {
                     type: 'void',
-                    voidResult: finalResult.execute(),
+                    execute: () => finalResult.execute(),
                 };
         }
     }

package/lib/cli/CliArgsHandlerBase.js

@@ -135,7 +135,7 @@ class CliArgsHandlerBase {
         if (args.context) {
             Object.assign(context, JSON.parse((0, fs_1.existsSync)(args.context) ? (0, fs_1.readFileSync)(args.c, 'utf8') : args.context));
         }
-        else if (args.sources[0] && args.sources[0].startsWith('{')) {
+        else if (args.sources[0]?.startsWith('{')) {
             // For backwards compatibility inline JSON
             Object.assign(context, JSON.parse(args.sources[0]));
             args.sources.shift();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comunica/actor-init-query",
-  "version": "2.0.1-alpha.5.0",
+  "version": "2.0.1-alpha.6.0",
   "description": "A query init actor",
   "lsd:module": true,
   "main": "lib/index.js",
@@ -13,6 +13,7 @@
   "publishConfig": {
     "access": "public"
   },
+  "sideEffects": false,
   "keywords": [
     "comunica",
     "actor",
@@ -30,20 +31,20 @@
     "lib/**/*.js"
   ],
   "dependencies": {
-    "@comunica/actor-http-proxy": "2.0.1-alpha.5.0",
-    "@comunica/bindings-factory": "2.0.1-alpha.5.0",
-    "@comunica/bus-context-preprocess": "2.0.1-alpha.5.0",
-    "@comunica/bus-http-invalidate": "2.0.1-alpha.5.0",
-    "@comunica/bus-init": "2.0.1-alpha.5.0",
-    "@comunica/bus-optimize-query-operation": "2.0.1-alpha.5.0",
-    "@comunica/bus-query-operation": "2.0.1-alpha.5.0",
-    "@comunica/bus-query-parse": "2.0.1-alpha.5.0",
-    "@comunica/bus-query-result-serialize": "2.0.1-alpha.5.0",
-    "@comunica/context-entries": "2.0.1-alpha.5.0",
-    "@comunica/core": "2.0.1-alpha.5.0",
-    "@comunica/logger-pretty": "2.0.1-alpha.5.0",
-    "@comunica/runner": "2.0.1-alpha.5.0",
-    "@comunica/types": "2.0.1-alpha.5.0",
+    "@comunica/actor-http-proxy": "2.0.1-alpha.6.0",
+    "@comunica/bindings-factory": "2.0.1-alpha.6.0",
+    "@comunica/bus-context-preprocess": "2.0.1-alpha.6.0",
+    "@comunica/bus-http-invalidate": "2.0.1-alpha.6.0",
+    "@comunica/bus-init": "2.0.1-alpha.6.0",
+    "@comunica/bus-optimize-query-operation": "2.0.1-alpha.6.0",
+    "@comunica/bus-query-operation": "2.0.1-alpha.6.0",
+    "@comunica/bus-query-parse": "2.0.1-alpha.6.0",
+    "@comunica/bus-query-result-serialize": "2.0.1-alpha.6.0",
+    "@comunica/context-entries": "2.0.1-alpha.6.0",
+    "@comunica/core": "2.0.1-alpha.6.0",
+    "@comunica/logger-pretty": "2.0.1-alpha.6.0",
+    "@comunica/runner": "2.0.1-alpha.6.0",
+    "@comunica/types": "2.0.1-alpha.6.0",
     "@rdfjs/types": "*",
     "@types/yargs": "^17.0.2",
     "asynciterator": "^3.2.1",
@@ -63,5 +64,5 @@
   "browser": {
     "./lib/index.js": "./lib/index-browser.js"
   },
-  "gitHead": "e2ae2e9e924bf0656df60cc99774f7e560d47695"
+  "gitHead": "bbf46a068e635256495a40e784a4691b22e88bd3"
 }