@comunica/actor-query-operation-distinct-identity 4.3.0

package/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright © 2017–now Ruben Taelman, Joachim Van Herwegen
+Comunica Association and Ghent University – imec, Belgium
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# Comunica Distinct Identity Query Operation Actor
+
+[![npm version](https://badge.fury.io/js/%40comunica%2Factor-query-operation-distinct-identity.svg)](https://www.npmjs.com/package/@comunica/actor-query-operation-distinct-identity)
+
+A [Query Operation](https://github.com/comunica/comunica/tree/master/packages/bus-query-operation) actor that handles [SPARQL `DISTINCT`](https://www.w3.org/TR/sparql11-query/#sparqlDistinct) operations
+by maintaining a identity-based cache of infinite size.
+
+This module is part of the [Comunica framework](https://github.com/comunica/comunica),
+and should only be used by [developers that want to build their own query engine](https://comunica.dev/docs/modify/).
+
+[Click here if you just want to query with Comunica](https://comunica.dev/docs/query/).
+
+## Install
+
+```bash
+$ yarn add @comunica/actor-query-operation-distinct-identity
+```
+
+## Configure
+
+After installing, this package can be added to your engine's configuration as follows:
+```text
+{
+  "@context": [
+    ...
+    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/actor-query-operation-distinct-identity/^4.0.0/components/context.jsonld"
+  ],
+  "actors": [
+    ...
+    {
+      "@id": "urn:comunica:default:query-operation/actors#distinct",
+      "@type": "ActorQueryOperationDistinctIdentity",
+      "mediatorQueryOperation": { "@id": "#mediatorQueryOperation" },
+    }
+  ]
+}
+```
+
+### Config Parameters
+
+* `mediatorQueryOperation`: A mediator over the [Query Operation bus](https://github.com/comunica/comunica/tree/master/packages/bus-query-operation).

package/components/ActorQueryOperationDistinctIdentity.jsonld

@@ -0,0 +1,211 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/actor-query-operation-distinct-identity/^4.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/core/^4.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/bus-query-operation/^4.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@comunica/actor-query-operation-distinct-identity",
+  "components": [
+    {
+      "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity",
+      "@type": "Class",
+      "requireElement": "ActorQueryOperationDistinctIdentity",
+      "extends": [
+        {
+          "@type": "GenericComponentExtension",
+          "component": "cbqo:components/ActorQueryOperationTypedMediated.jsonld#ActorQueryOperationTypedMediated",
+          "genericTypeInstances": [
+            "urn:npm:sparqlalgebrajs:Distinct"
+          ]
+        }
+      ],
+      "comment": "A comunica Distinct Identity Query Operation Actor.",
+      "parameters": [
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_mediatorQueryOperation",
+          "range": "cc:components/Mediator.jsonld#Mediator"
+        },
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_name",
+          "range": "xsd:string",
+          "default": {
+            "@id": "rdf:subject"
+          },
+          "comment": "The name for this actor."
+        },
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_bus",
+          "range": {
+            "@type": "ParameterRangeGenericComponent",
+            "component": "cc:components/Bus.jsonld#Bus",
+            "genericTypeInstances": [
+              {
+                "@type": "ParameterRangeGenericComponent",
+                "component": "cc:components/Actor.jsonld#Actor",
+                "genericTypeInstances": [
+                  {
+                    "@type": "ParameterRangeGenericTypeReference",
+                    "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_I"
+                  },
+                  {
+                    "@type": "ParameterRangeGenericTypeReference",
+                    "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_T"
+                  },
+                  {
+                    "@type": "ParameterRangeGenericTypeReference",
+                    "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+                  },
+                  {
+                    "@type": "ParameterRangeGenericTypeReference",
+                    "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
+                  }
+                ]
+              },
+              {
+                "@type": "ParameterRangeGenericTypeReference",
+                "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_I"
+              },
+              {
+                "@type": "ParameterRangeGenericTypeReference",
+                "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_T"
+              },
+              {
+                "@type": "ParameterRangeGenericTypeReference",
+                "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+              },
+              {
+                "@type": "ParameterRangeGenericTypeReference",
+                "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
+              }
+            ]
+          },
+          "default": {
+            "@id": "cbqo:components/ActorQueryOperation.jsonld#ActorQueryOperation_default_bus",
+            "@type": "cbqo:components/BusQueryOperation.jsonld#BusQueryOperation"
+          },
+          "comment": "The bus this actor subscribes to."
+        },
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_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": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_beforeActors",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              {
+                "@type": "ParameterRangeArray",
+                "parameterRangeValue": {
+                  "@type": "ParameterRangeGenericComponent",
+                  "component": "cc:components/Actor.jsonld#Actor",
+                  "genericTypeInstances": [
+                    {
+                      "@type": "ParameterRangeGenericTypeReference",
+                      "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_I"
+                    },
+                    {
+                      "@type": "ParameterRangeGenericTypeReference",
+                      "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_T"
+                    },
+                    {
+                      "@type": "ParameterRangeGenericTypeReference",
+                      "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_O"
+                    },
+                    {
+                      "@type": "ParameterRangeGenericTypeReference",
+                      "parameterRangeGenericType": "npmd:@comunica/actor-abstract-mediatyped/^4.0.0/components/ActorAbstractMediaTyped.jsonld#ActorAbstractMediaTyped__generic_TS"
+                    }
+                  ]
+                }
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "Actor that must be registered in the bus before this actor."
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity__member_testOperation",
+          "memberFieldName": "testOperation"
+        },
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity__member_runOperation",
+          "memberFieldName": "runOperation"
+        },
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity__member_newIdentityFilter",
+          "memberFieldName": "newIdentityFilter"
+        },
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity__member_newIdentityFilterQuads",
+          "memberFieldName": "newIdentityFilterQuads"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "mediatorQueryOperation",
+              "value": {
+                "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_mediatorQueryOperation"
+              }
+            },
+            {
+              "keyRaw": "name",
+              "value": {
+                "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_name"
+              }
+            },
+            {
+              "keyRaw": "bus",
+              "value": {
+                "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_bus"
+              }
+            },
+            {
+              "keyRaw": "busFailMessage",
+              "value": {
+                "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_busFailMessage"
+              }
+            },
+            {
+              "keyRaw": "beforeActors",
+              "value": {
+                "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_beforeActors"
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#IActorQueryOperationDistinctIdentityArgs",
+      "@type": "AbstractClass",
+      "requireElement": "IActorQueryOperationDistinctIdentityArgs",
+      "extends": [
+        "cbqo:components/ActorQueryOperationTypedMediated.jsonld#IActorQueryOperationTypedMediatedArgs"
+      ],
+      "parameters": [],
+      "constructorArguments": []
+    }
+  ]
+}

package/components/components.jsonld

@@ -0,0 +1,11 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/actor-query-operation-distinct-identity/^4.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@comunica/actor-query-operation-distinct-identity",
+  "@type": "Module",
+  "requireName": "@comunica/actor-query-operation-distinct-identity",
+  "import": [
+    "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld"
+  ]
+}

package/components/context.jsonld

@@ -0,0 +1,52 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/componentsjs/^6.0.0/components/context.jsonld",
+    {
+      "npmd": "https://linkedsoftwaredependencies.org/bundles/npm/",
+      "caqodi": "npmd:@comunica/actor-query-operation-distinct-identity/^4.0.0/",
+      "ActorQueryOperationDistinctIdentity": {
+        "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity",
+        "@prefix": true,
+        "@context": {
+          "args_mediatorQueryOperation": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_mediatorQueryOperation"
+          },
+          "args_name": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_name"
+          },
+          "args_bus": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_bus"
+          },
+          "args_busFailMessage": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_busFailMessage"
+          },
+          "args_beforeActors": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_beforeActors",
+            "@container": "@list"
+          },
+          "mediatorQueryOperation": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_mediatorQueryOperation"
+          },
+          "name": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_name"
+          },
+          "bus": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_bus"
+          },
+          "busFailMessage": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_busFailMessage"
+          },
+          "beforeActors": {
+            "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#ActorQueryOperationDistinctIdentity_args_beforeActors",
+            "@container": "@list"
+          }
+        }
+      },
+      "IActorQueryOperationDistinctIdentityArgs": {
+        "@id": "caqodi:components/ActorQueryOperationDistinctIdentity.jsonld#IActorQueryOperationDistinctIdentityArgs",
+        "@prefix": true,
+        "@context": {}
+      }
+    }
+  ]
+}

package/lib/ActorQueryOperationDistinctIdentity.d.ts

@@ -0,0 +1,29 @@
+import type { IActorQueryOperationTypedMediatedArgs } from '@comunica/bus-query-operation';
+import { ActorQueryOperationTypedMediated } from '@comunica/bus-query-operation';
+import type { IActorTest, TestResult } from '@comunica/core';
+import type { Bindings, IActionContext, IQueryOperationResult } from '@comunica/types';
+import type * as RDF from '@rdfjs/types';
+import type { Algebra } from 'sparqlalgebrajs';
+/**
+ * A comunica Distinct Identity Query Operation Actor.
+ */
+export declare class ActorQueryOperationDistinctIdentity extends ActorQueryOperationTypedMediated<Algebra.Distinct> {
+    constructor(args: IActorQueryOperationDistinctIdentityArgs);
+    testOperation(_operation: Algebra.Distinct, _context: IActionContext): Promise<TestResult<IActorTest>>;
+    runOperation(operation: Algebra.Distinct, context: IActionContext): Promise<IQueryOperationResult>;
+    /**
+     * Create a new distinct filter function.
+     * This will maintain an internal Identity datastructure so that every bindings object only returns true once.
+     * @param variables The variables to take into account while hashing.
+     * @return {(bindings: Bindings) => boolean} A distinct filter for bindings.
+     */
+    newIdentityFilter(variables: RDF.Variable[]): Promise<(bindings: Bindings) => boolean>;
+    /**
+     * Create a new distinct filter function to Identity quads.
+     * This will maintain an internal Identity datastructure so that every quad object only returns true once.
+     * @return {(quad: RDF.Quad) => boolean} A distinct filter for quads.
+     */
+    newIdentityFilterQuads(): Promise<(quad: RDF.Quad) => boolean>;
+}
+export interface IActorQueryOperationDistinctIdentityArgs extends IActorQueryOperationTypedMediatedArgs {
+}

package/lib/ActorQueryOperationDistinctIdentity.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActorQueryOperationDistinctIdentity = void 0;
+const bus_query_operation_1 = require("@comunica/bus-query-operation");
+const core_1 = require("@comunica/core");
+const utils_query_operation_1 = require("@comunica/utils-query-operation");
+const RdfString = require("rdf-string");
+/**
+ * A comunica Distinct Identity Query Operation Actor.
+ */
+class ActorQueryOperationDistinctIdentity extends bus_query_operation_1.ActorQueryOperationTypedMediated {
+    constructor(args) {
+        super(args, 'distinct');
+    }
+    async testOperation(_operation, _context) {
+        return (0, core_1.passTestVoid)();
+    }
+    async runOperation(operation, context) {
+        const output = await this.mediatorQueryOperation.mediate({ operation: operation.input, context });
+        if (output.type === 'quads') {
+            const outputQuads = (0, utils_query_operation_1.getSafeQuads)(output);
+            const quadStream = outputQuads.quadStream
+                .filter(await this.newIdentityFilterQuads());
+            return {
+                type: 'quads',
+                quadStream,
+                metadata: outputQuads.metadata,
+            };
+        }
+        const outputBindings = (0, utils_query_operation_1.getSafeBindings)(output);
+        const variables = (await outputBindings.metadata()).variables.map(v => v.variable);
+        const bindingsStream = outputBindings.bindingsStream
+            .filter(await this.newIdentityFilter(variables));
+        return {
+            type: 'bindings',
+            bindingsStream,
+            metadata: outputBindings.metadata,
+        };
+    }
+    /**
+     * Create a new distinct filter function.
+     * This will maintain an internal Identity datastructure so that every bindings object only returns true once.
+     * @param variables The variables to take into account while hashing.
+     * @return {(bindings: Bindings) => boolean} A distinct filter for bindings.
+     */
+    async newIdentityFilter(variables) {
+        const identities = {};
+        return (bindings) => {
+            const identity = variables.map(v => RdfString.termToString(bindings.get(v))).join('-');
+            return !(identity in identities) && (identities[identity] = true);
+        };
+    }
+    /**
+     * Create a new distinct filter function to Identity quads.
+     * This will maintain an internal Identity datastructure so that every quad object only returns true once.
+     * @return {(quad: RDF.Quad) => boolean} A distinct filter for quads.
+     */
+    async newIdentityFilterQuads() {
+        const identities = {};
+        return (quad) => {
+            const identity = Object.values(RdfString.quadToStringQuad(quad)).join(' ');
+            return !(identity in identities) && (identities[identity] = true);
+        };
+    }
+}
+exports.ActorQueryOperationDistinctIdentity = ActorQueryOperationDistinctIdentity;
+//# sourceMappingURL=ActorQueryOperationDistinctIdentity.js.map

package/lib/ActorQueryOperationDistinctIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorQueryOperationDistinctIdentity.js","sourceRoot":"","sources":["ActorQueryOperationDistinctIdentity.ts"],"names":[],"mappings":";;;AACA,uEAEuC;AAEvC,yCAA8C;AAS9C,2EAAgF;AAGhF,wCAAwC;AAGxC;;GAEG;AACH,MAAa,mCAAoC,SAAQ,sDAAkD;IACzG,YAAmB,IAA8C;QAC/D,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,UAA4B,EAAE,QAAwB;QAC/E,OAAO,IAAA,mBAAY,GAAE,CAAC;IACxB,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,SAA2B,EAAE,OAAuB;QAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAElG,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,MAAM,WAAW,GAA+B,IAAA,oCAAY,EAC1D,MAAM,CACP,CAAC;YAEF,MAAM,UAAU,GAA4B,WAAW,CAAC,UAAU;iBAC/D,MAAM,CAAC,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;YAC/C,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,UAAU;gBACV,QAAQ,EAAE,WAAW,CAAC,QAAQ;aAC/B,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAkC,IAAA,uCAAe,EACnE,MAAM,CACP,CAAC;QAEF,MAAM,SAAS,GAAG,CAAC,MAAM,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACnF,MAAM,cAAc,GAAmB,cAAc,CAAC,cAAc;aACjE,MAAM,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;QACnD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,cAAc;YACd,QAAQ,EAAE,cAAc,CAAC,QAAQ;SAClC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,iBAAiB,CAC5B,SAAyB;QAEzB,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,OAAO,CAAC,QAAkB,EAAE,EAAE;YAC5B,MAAM,QAAQ,GAAW,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/F,OAAO,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,sBAAsB;QACjC,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAc,EAAE,EAAE;YACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3E,OAAO,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC,CAAC;IACJ,CAAC;CACF;AApED,kFAoEC","sourcesContent":["import type { IActorQueryOperationTypedMediatedArgs } from '@comunica/bus-query-operation';\nimport {\n  ActorQueryOperationTypedMediated,\n} from '@comunica/bus-query-operation';\nimport type { IActorTest, TestResult } from '@comunica/core';\nimport { passTestVoid } from '@comunica/core';\nimport type {\n  Bindings,\n  BindingsStream,\n  IActionContext,\n  IQueryOperationResult,\n  IQueryOperationResultBindings,\n  IQueryOperationResultQuads,\n} from '@comunica/types';\nimport { getSafeBindings, getSafeQuads } from '@comunica/utils-query-operation';\nimport type * as RDF from '@rdfjs/types';\nimport type { AsyncIterator } from 'asynciterator';\nimport * as RdfString from 'rdf-string';\nimport type { Algebra } from 'sparqlalgebrajs';\n\n/**\n * A comunica Distinct Identity Query Operation Actor.\n */\nexport class ActorQueryOperationDistinctIdentity extends ActorQueryOperationTypedMediated<Algebra.Distinct> {\n  public constructor(args: IActorQueryOperationDistinctIdentityArgs) {\n    super(args, 'distinct');\n  }\n\n  public async testOperation(_operation: Algebra.Distinct, _context: IActionContext): Promise<TestResult<IActorTest>> {\n    return passTestVoid();\n  }\n\n  public async runOperation(operation: Algebra.Distinct, context: IActionContext): Promise<IQueryOperationResult> {\n    const output = await this.mediatorQueryOperation.mediate({ operation: operation.input, context });\n\n    if (output.type === 'quads') {\n      const outputQuads: IQueryOperationResultQuads = getSafeQuads(\n        output,\n      );\n\n      const quadStream: AsyncIterator<RDF.Quad> = outputQuads.quadStream\n        .filter(await this.newIdentityFilterQuads());\n      return {\n        type: 'quads',\n        quadStream,\n        metadata: outputQuads.metadata,\n      };\n    }\n\n    const outputBindings: IQueryOperationResultBindings = getSafeBindings(\n      output,\n    );\n\n    const variables = (await outputBindings.metadata()).variables.map(v => v.variable);\n    const bindingsStream: BindingsStream = outputBindings.bindingsStream\n      .filter(await this.newIdentityFilter(variables));\n    return {\n      type: 'bindings',\n      bindingsStream,\n      metadata: outputBindings.metadata,\n    };\n  }\n\n  /**\n   * Create a new distinct filter function.\n   * This will maintain an internal Identity datastructure so that every bindings object only returns true once.\n   * @param variables The variables to take into account while hashing.\n   * @return {(bindings: Bindings) => boolean} A distinct filter for bindings.\n   */\n  public async newIdentityFilter(\n    variables: RDF.Variable[],\n  ): Promise<(bindings: Bindings) => boolean> {\n    const identities: Record<string, boolean> = {};\n    return (bindings: Bindings) => {\n      const identity: string = variables.map(v => RdfString.termToString(bindings.get(v))).join('-');\n      return !(identity in identities) && (identities[identity] = true);\n    };\n  }\n\n  /**\n   * Create a new distinct filter function to Identity quads.\n   * This will maintain an internal Identity datastructure so that every quad object only returns true once.\n   * @return {(quad: RDF.Quad) => boolean} A distinct filter for quads.\n   */\n  public async newIdentityFilterQuads(): Promise<(quad: RDF.Quad) => boolean> {\n    const identities: Record<string, boolean> = {};\n    return (quad: RDF.Quad) => {\n      const identity = Object.values(RdfString.quadToStringQuad(quad)).join(' ');\n      return !(identity in identities) && (identities[identity] = true);\n    };\n  }\n}\n\nexport interface IActorQueryOperationDistinctIdentityArgs extends IActorQueryOperationTypedMediatedArgs {\n}\n"]}

package/lib/index.d.ts

@@ -0,0 +1 @@
+export * from './ActorQueryOperationDistinctIdentity';

package/lib/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ActorQueryOperationDistinctIdentity"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wEAAsD","sourcesContent":["export * from './ActorQueryOperationDistinctIdentity';\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@comunica/actor-query-operation-distinct-identity",
+  "version": "4.3.0",
+  "description": "A distinct-identity query-operation actor",
+  "lsd:module": true,
+  "license": "MIT",
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/comunica-association"
+  },
+  "homepage": "https://comunica.dev/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/comunica/comunica.git",
+    "directory": "packages/actor-query-operation-distinct-identity"
+  },
+  "bugs": {
+    "url": "https://github.com/comunica/comunica/issues"
+  },
+  "keywords": [
+    "comunica",
+    "actor",
+    "query-operation",
+    "distinct-hash"
+  ],
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "typings": "lib/index",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "components",
+    "lib/**/*.d.ts",
+    "lib/**/*.js",
+    "lib/**/*.js.map"
+  ],
+  "scripts": {
+    "build": "yarn run build:ts && yarn run build:components",
+    "build:ts": "node \"../../node_modules/typescript/bin/tsc\"",
+    "build:components": "componentsjs-generator"
+  },
+  "dependencies": {
+    "@comunica/bus-query-operation": "^4.2.0",
+    "@comunica/core": "^4.2.0",
+    "@comunica/types": "^4.2.0",
+    "@comunica/utils-query-operation": "^4.2.0",
+    "@rdfjs/types": "*",
+    "asynciterator": "^3.9.0",
+    "rdf-string": "^2.0.1",
+    "sparqlalgebrajs": "^4.3.8"
+  },
+  "gitHead": "1e53e7a688be2bdb428a8c46e45f7a3c5c64a2aa"
+}