@comunica/bus-query-operation 3.2.2 → 3.2.4-alpha.47.0

package/components/ActorQueryOperation.jsonld

@@ -25,11 +25,23 @@
                 "ct:components/IQueryOperationResult.jsonld#IQueryOperationResultBoolean",
                 "ct:components/IQueryOperationResult.jsonld#IQueryOperationResultVoid"
               ]
+            },
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__generic_TS"
             }
           ]
         }
       ],
       "comment": "A comunica actor for query-operation events.  Actor types: * Input:  IActionQueryOperation:      A SPARQL Algebra operation. * Test:   <none> * Output: IActorQueryOperationOutput: A bindings stream.",
+      "genericTypeParameters": [
+        {
+          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__generic_TS",
+          "default": {
+            "@type": "ParameterRangeUndefined"
+          }
+        }
+      ],
       "parameters": [
         {
           "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_name",
@@ -60,6 +72,10 @@
                   {
                     "@type": "ParameterRangeGenericTypeReference",
                     "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+                  },
+                  {
+                    "@type": "ParameterRangeGenericTypeReference",
+                    "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
                   }
                 ]
               },
@@ -74,6 +90,10 @@
               {
                 "@type": "ParameterRangeGenericTypeReference",
                 "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+              },
+              {
+                "@type": "ParameterRangeGenericTypeReference",
+                "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
               }
             ]
           },
@@ -83,6 +103,20 @@
           },
           "comment": "The bus this actor subscribes to."
         },
+        {
+          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_busFailMessage",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "default": "Query operation processing failed: none of the configured actors were able to handle the operation type ${action.operation.type}",
+          "comment": "The message that will be configured in the bus for reporting failures.  This message may be a template string that contains references to the executed `action`. For example, the following templated string is allowed: \"RDF dereferencing failed: no actors could handle ${action.handle.mediaType}\""
+        },
         {
           "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_beforeActors",
           "range": {
@@ -105,6 +139,10 @@
                     {
                       "@type": "ParameterRangeGenericTypeReference",
                       "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+                    },
+                    {
+                      "@type": "ParameterRangeGenericTypeReference",
+                      "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
                     }
                   ]
                 }
@@ -121,62 +159,6 @@
         {
           "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_constructor",
           "memberFieldName": "constructor"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_getSafeBindings",
-          "memberFieldName": "getSafeBindings"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_getSafeQuads",
-          "memberFieldName": "getSafeQuads"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_getSafeBoolean",
-          "memberFieldName": "getSafeBoolean"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_getSafeVoid",
-          "memberFieldName": "getSafeVoid"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_validateQueryOutput",
-          "memberFieldName": "validateQueryOutput"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_getBaseExpressionContext",
-          "memberFieldName": "getBaseExpressionContext"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_getExpressionContext",
-          "memberFieldName": "getExpressionContext"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_getAsyncExpressionContext",
-          "memberFieldName": "getAsyncExpressionContext"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_createExistenceResolver",
-          "memberFieldName": "createExistenceResolver"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_throwOnReadOnly",
-          "memberFieldName": "throwOnReadOnly"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_getOperationSource",
-          "memberFieldName": "getOperationSource"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_assignOperationSource",
-          "memberFieldName": "assignOperationSource"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_removeOperationSource",
-          "memberFieldName": "removeOperationSource"
-        },
-        {
-          "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation__member_doesShapeAcceptOperation",
-          "memberFieldName": "doesShapeAcceptOperation"
         }
       ],
       "constructorArguments": [
@@ -195,6 +177,12 @@
                 "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_bus"
               }
             },
+            {
+              "keyRaw": "busFailMessage",
+              "value": {
+                "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_busFailMessage"
+              }
+            },
             {
               "keyRaw": "beforeActors",
               "value": {
@@ -242,6 +230,10 @@
         {
           "@id": "cbqo:components/ActorQueryOperation.jsonld#IBaseExpressionContext__member_functionArgumentsCache",
           "memberFieldName": "functionArgumentsCache"
+        },
+        {
+          "@id": "cbqo:components/ActorQueryOperation.jsonld#IBaseExpressionContext__member_actionContext",
+          "memberFieldName": "actionContext"
         }
       ],
       "constructorArguments": []

package/components/ActorQueryOperationTyped.jsonld

@@ -10,7 +10,16 @@
       "@type": "AbstractClass",
       "requireElement": "ActorQueryOperationTyped",
       "extends": [
-        "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation"
+        {
+          "@type": "GenericComponentExtension",
+          "component": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation",
+          "genericTypeInstances": [
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped__generic_TS"
+            }
+          ]
+        }
       ],
       "comment": "A base implementation for query operation actors for a specific operation type.",
       "genericTypeParameters": [
@@ -85,6 +94,12 @@
               }
             ]
           }
+        },
+        {
+          "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped__generic_TS",
+          "default": {
+            "@type": "ParameterRangeUndefined"
+          }
         }
       ],
       "parameters": [
@@ -121,6 +136,10 @@
                   {
                     "@type": "ParameterRangeGenericTypeReference",
                     "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+                  },
+                  {
+                    "@type": "ParameterRangeGenericTypeReference",
+                    "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
                   }
                 ]
               },
@@ -135,6 +154,10 @@
               {
                 "@type": "ParameterRangeGenericTypeReference",
                 "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+              },
+              {
+                "@type": "ParameterRangeGenericTypeReference",
+                "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
               }
             ]
           },
@@ -144,6 +167,20 @@
           },
           "comment": "The bus this actor subscribes to."
         },
+        {
+          "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_busFailMessage",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "default": "Query operation processing failed: none of the configured actors were able to handle the operation type ${action.operation.type}",
+          "comment": "The message that will be configured in the bus for reporting failures.  This message may be a template string that contains references to the executed `action`. For example, the following templated string is allowed: \"RDF dereferencing failed: no actors could handle ${action.handle.mediaType}\""
+        },
         {
           "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_beforeActors",
           "range": {
@@ -166,6 +203,10 @@
                     {
                       "@type": "ParameterRangeGenericTypeReference",
                       "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+                    },
+                    {
+                      "@type": "ParameterRangeGenericTypeReference",
+                      "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
                     }
                   ]
                 }
@@ -221,6 +262,12 @@
                 "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_bus"
               }
             },
+            {
+              "keyRaw": "busFailMessage",
+              "value": {
+                "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_busFailMessage"
+              }
+            },
             {
               "keyRaw": "beforeActors",
               "value": {

package/components/ActorQueryOperationTypedMediated.jsonld

@@ -17,10 +17,23 @@
             {
               "@type": "ParameterRangeGenericTypeReference",
               "parameterRangeGenericType": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated__generic_O"
+            },
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated__generic_TS"
             }
           ]
         },
-        "cbqo:components/ActorQueryOperationTypedMediated.jsonld#IActorQueryOperationTypedMediatedArgs"
+        {
+          "@type": "GenericComponentExtension",
+          "component": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#IActorQueryOperationTypedMediatedArgs",
+          "genericTypeInstances": [
+            {
+              "@type": "ParameterRangeGenericTypeReference",
+              "parameterRangeGenericType": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated__generic_TS"
+            }
+          ]
+        }
       ],
       "comment": "A base implementation for query operation actors for a specific operation type that have a query operation mediator.",
       "genericTypeParameters": [
@@ -95,6 +108,12 @@
               }
             ]
           }
+        },
+        {
+          "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated__generic_TS",
+          "default": {
+            "@type": "ParameterRangeUndefined"
+          }
         }
       ],
       "parameters": [
@@ -135,6 +154,10 @@
                   {
                     "@type": "ParameterRangeGenericTypeReference",
                     "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+                  },
+                  {
+                    "@type": "ParameterRangeGenericTypeReference",
+                    "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
                   }
                 ]
               },
@@ -149,6 +172,10 @@
               {
                 "@type": "ParameterRangeGenericTypeReference",
                 "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+              },
+              {
+                "@type": "ParameterRangeGenericTypeReference",
+                "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
               }
             ]
           },
@@ -158,6 +185,20 @@
           },
           "comment": "The bus this actor subscribes to."
         },
+        {
+          "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_busFailMessage",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "default": "Query operation processing failed: none of the configured actors were able to handle the operation type ${action.operation.type}",
+          "comment": "The message that will be configured in the bus for reporting failures.  This message may be a template string that contains references to the executed `action`. For example, the following templated string is allowed: \"RDF dereferencing failed: no actors could handle ${action.handle.mediaType}\""
+        },
         {
           "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_beforeActors",
           "range": {
@@ -180,6 +221,10 @@
                     {
                       "@type": "ParameterRangeGenericTypeReference",
                       "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+                    },
+                    {
+                      "@type": "ParameterRangeGenericTypeReference",
+                      "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^3.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
                     }
                   ]
                 }
@@ -225,6 +270,12 @@
                 "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_bus"
               }
             },
+            {
+              "keyRaw": "busFailMessage",
+              "value": {
+                "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_busFailMessage"
+              }
+            },
             {
               "keyRaw": "beforeActors",
               "value": {
@@ -242,6 +293,14 @@
       "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#IActorQueryOperationTypedMediatedArgs",
       "@type": "AbstractClass",
       "requireElement": "IActorQueryOperationTypedMediatedArgs",
+      "genericTypeParameters": [
+        {
+          "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#IActorQueryOperationTypedMediatedArgs__generic_TS",
+          "default": {
+            "@type": "ParameterRangeUndefined"
+          }
+        }
+      ],
       "parameters": [],
       "memberFields": [
         {

package/components/context.jsonld

@@ -14,6 +14,9 @@
           "args_bus": {
             "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_bus"
           },
+          "args_busFailMessage": {
+            "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_busFailMessage"
+          },
           "args_beforeActors": {
             "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_beforeActors",
             "@container": "@list"
@@ -24,6 +27,9 @@
           "bus": {
             "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_bus"
           },
+          "busFailMessage": {
+            "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_busFailMessage"
+          },
           "beforeActors": {
             "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_args_beforeActors",
             "@container": "@list"
@@ -63,6 +69,9 @@
           "args_bus": {
             "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_bus"
           },
+          "args_busFailMessage": {
+            "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_busFailMessage"
+          },
           "args_beforeActors": {
             "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_beforeActors",
             "@container": "@list"
@@ -76,6 +85,9 @@
           "bus": {
             "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_bus"
           },
+          "busFailMessage": {
+            "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_busFailMessage"
+          },
           "beforeActors": {
             "@id": "cbqo:components/ActorQueryOperationTyped.jsonld#ActorQueryOperationTyped_args_beforeActors",
             "@container": "@list"
@@ -98,6 +110,9 @@
           "args_bus": {
             "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_bus"
           },
+          "args_busFailMessage": {
+            "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_busFailMessage"
+          },
           "args_beforeActors": {
             "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_beforeActors",
             "@container": "@list"
@@ -114,6 +129,9 @@
           "bus": {
             "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_bus"
           },
+          "busFailMessage": {
+            "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_busFailMessage"
+          },
           "beforeActors": {
             "@id": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated_args_beforeActors",
             "@container": "@list"

package/lib/ActorQueryOperation.d.ts

@@ -1,7 +1,6 @@
-import type { BindingsFactory } from '@comunica/bindings-factory';
 import type { IActorArgs, IActorTest, IAction, Mediate } from '@comunica/core';
 import { Actor } from '@comunica/core';
-import type { IQueryOperationResult, IQueryOperationResultBindings, IQueryOperationResultBoolean, IQueryOperationResultQuads, IQueryOperationResultVoid, Bindings, IActionContext, FunctionArgumentsCache, IQuerySourceWrapper, FragmentSelectorShape } from '@comunica/types';
+import type { IQueryOperationResult, Bindings, IActionContext, FunctionArgumentsCache } from '@comunica/types';
 import type * as RDF from '@rdfjs/types';
 import type { Algebra } from 'sparqlalgebrajs';
 /**
@@ -15,102 +14,13 @@ import type { Algebra } from 'sparqlalgebrajs';
  * @see IActionQueryOperation
  * @see IQueryOperationResult
  */
-export declare abstract class ActorQueryOperation extends Actor<IActionQueryOperation, IActorTest, IQueryOperationResult> {
+export declare abstract class ActorQueryOperation<TS = undefined> extends Actor<IActionQueryOperation, IActorTest, IQueryOperationResult, TS> {
     /**
-     * @param args - @defaultNested {<default_bus> a <cbqo:components/BusQueryOperation.jsonld#BusQueryOperation>} bus
+     * @param args -
+     *   \ @defaultNested {<default_bus> a <cbqo:components/BusQueryOperation.jsonld#BusQueryOperation>} bus
+     *   \ @defaultNested {Query operation processing failed: none of the configured actors were able to handle the operation type ${action.operation.type}} busFailMessage
      */
-    protected constructor(args: IActorQueryOperationArgs);
-    /**
-     * Safely cast a query operation output to a bindings output.
-     * This will throw a runtime error if the output is of the incorrect type.
-     * @param {IQueryOperationResult} output A query operation output.
-     * @return {IQueryOperationResultBindings} A bindings query operation output.
-     */
-    static getSafeBindings(output: IQueryOperationResult): IQueryOperationResultBindings;
-    /**
-     * Safely cast a query operation output to a quads output.
-     * This will throw a runtime error if the output is of the incorrect type.
-     * @param {IQueryOperationResult} output A query operation output.
-     * @return {IQueryOperationResultQuads} A quads query operation output.
-     */
-    static getSafeQuads(output: IQueryOperationResult): IQueryOperationResultQuads;
-    /**
-     * Safely cast a query operation output to a boolean output.
-     * This will throw a runtime error if the output is of the incorrect type.
-     * @param {IQueryOperationResult} output A query operation output.
-     * @return {IQueryOperationResultBoolean} A boolean query operation output.
-     */
-    static getSafeBoolean(output: IQueryOperationResult): IQueryOperationResultBoolean;
-    /**
-     * Safely cast a query operation output to a void output.
-     * This will throw a runtime error if the output is of the incorrect type.
-     * @param {IQueryOperationResult} output A query operation output.
-     * @return {IQueryOperationResultVoid} A void query operation output.
-     */
-    static getSafeVoid(output: IQueryOperationResult): IQueryOperationResultVoid;
-    /**
-     * Throw an error if the output type does not match the expected type.
-     * @param {IQueryOperationResult} output A query operation output.
-     * @param {string} expectedType The expected output type.
-     */
-    static validateQueryOutput(output: IQueryOperationResult, expectedType: IQueryOperationResult['type']): void;
-    protected static getBaseExpressionContext(context: IActionContext): IBaseExpressionContext;
-    /**
-     * Create an options object that can be used to construct a expression-evaluator synchronous evaluator.
-     * @param context An action context.
-     * @param _mediatorQueryOperation An optional query query operation mediator.
-     *                                If defined, the existence resolver will be defined as `exists`.
-     */
-    static getExpressionContext(context: IActionContext, _mediatorQueryOperation?: MediatorQueryOperation): ISyncExpressionContext;
-    /**
-     * Create an options object that can be used to construct a expression-evaluator asynchronous evaluator.
-     * @param context An action context.
-     * @param mediatorQueryOperation A query query operation mediator for resolving `exists`.
-     * @param bindingsFactory The bindings factory.
-     */
-    static getAsyncExpressionContext(context: IActionContext, mediatorQueryOperation: MediatorQueryOperation, bindingsFactory: BindingsFactory): IAsyncExpressionContext;
-    /**
-     * Create an existence resolver for usage within an expression context.
-     * @param context An action context.
-     * @param mediatorQueryOperation A query operation mediator.
-     * @param bindingsFactory The bindings factory.
-     */
-    static createExistenceResolver(context: IActionContext, mediatorQueryOperation: MediatorQueryOperation, bindingsFactory: BindingsFactory): (expr: Algebra.ExistenceExpression, bindings: Bindings) => Promise<boolean>;
-    /**
-     * Throw an error if the context contains the readOnly flag.
-     * @param context An action context.
-     */
-    static throwOnReadOnly(context: IActionContext): void;
-    /**
-     * Obtain the query source attached to the given operation.
-     * @param operation An algebra operation.
-     */
-    static getOperationSource(operation: Algebra.Operation): IQuerySourceWrapper | undefined;
-    /**
-     * Assign a source wrapper to the given operation.
-     * The operation is copied and returned.
-     * @param operation An operation.
-     * @param source A source wrapper.
-     */
-    static assignOperationSource<O extends Algebra.Operation>(operation: O, source: IQuerySourceWrapper): O;
-    /**
-     * Remove the source wrapper from the given operation.
-     * The operation is mutated.
-     * @param operation An operation.
-     */
-    static removeOperationSource(operation: Algebra.Operation): void;
-    /**
-     * Check if the given shape accepts the given query operation.
-     * @param shape A shape to test the query operation against.
-     * @param operation A query operation to test.
-     * @param options Additional options to consider.
-     * @param options.joinBindings If additional bindings will be pushed down to the source for joining.
-     * @param options.filterBindings If additional bindings will be pushed down to the source for filtering.
-     */
-    static doesShapeAcceptOperation(shape: FragmentSelectorShape, operation: Algebra.Operation, options?: {
-        joinBindings?: boolean;
-        filterBindings?: boolean;
-    }): boolean;
+    protected constructor(args: IActorQueryOperationArgs<TS>);
 }
 export interface IActionQueryOperation extends IAction {
     /**
@@ -118,13 +28,14 @@ export interface IActionQueryOperation extends IAction {
      */
     operation: Algebra.Operation;
 }
-export type IActorQueryOperationArgs = IActorArgs<IActionQueryOperation, IActorTest, IQueryOperationResult>;
+export type IActorQueryOperationArgs<TS = undefined> = IActorArgs<IActionQueryOperation, IActorTest, IQueryOperationResult, TS>;
 export type MediatorQueryOperation = Mediate<IActionQueryOperation, IQueryOperationResult>;
 export interface IBaseExpressionContext {
     now?: Date;
     baseIRI?: string;
     extensionFunctionCreator?: (functionNamedNode: RDF.NamedNode) => ((args: RDF.Term[]) => Promise<RDF.Term>) | undefined;
     functionArgumentsCache?: FunctionArgumentsCache;
+    actionContext: IActionContext;
 }
 export interface ISyncExpressionContext extends IBaseExpressionContext {
     bnode: (input?: string | undefined) => RDF.BlankNode;
@@ -133,3 +44,7 @@ export interface IAsyncExpressionContext extends IBaseExpressionContext {
     bnode: (input?: string | undefined) => Promise<RDF.BlankNode>;
     exists?: (expr: Algebra.ExistenceExpression, bindings: Bindings) => Promise<boolean>;
 }
+export type FragmentSelectorShapeTestFlags = {
+    joinBindings?: boolean;
+    filterBindings?: boolean;
+};