# @comunica/actor-query-operation-service

> A service query-operation actor

Latest version **5.4.0** (published 2026-09-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install @comunica/actor-query-operation-service
pnpm add @comunica/actor-query-operation-service
yarn add @comunica/actor-query-operation-service
bun add @comunica/actor-query-operation-service
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 5.4.0 |
| Published | 2026-09-14 |
| First published | 2018-09-05 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 12 |
| Unpacked size | 46.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 583 |
| Maintainers | joachimvh, rubensworks, rubenverborgh, dexagod, jeswr |
| Keywords | comunica, actor, query-operation, service |

## Links

- npm: https://www.npmjs.com/package/@comunica/actor-query-operation-service
- Repository: https://github.com/comunica/comunica
- Homepage: https://comunica.dev/
- Issues: https://github.com/comunica/comunica/issues
- npm.io page: https://npm.io/package/@comunica/actor-query-operation-service

## Dependencies (12)

- [@rdfjs/types](https://npm.io/package/@rdfjs/types.md) *
- [asynciterator](https://npm.io/package/asynciterator.md) ^3.10.0
- [@comunica/core](https://npm.io/package/@comunica/core.md) ^5.4.0
- [@comunica/types](https://npm.io/package/@comunica/types.md) ^5.4.0
- [@comunica/utils-algebra](https://npm.io/package/@comunica/utils-algebra.md) ^5.4.0
- [@comunica/utils-metadata](https://npm.io/package/@comunica/utils-metadata.md) ^5.4.0
- [@comunica/context-entries](https://npm.io/package/@comunica/context-entries.md) ^5.4.0
- [@comunica/bus-query-operation](https://npm.io/package/@comunica/bus-query-operation.md) ^5.4.0
- [@comunica/utils-query-operation](https://npm.io/package/@comunica/utils-query-operation.md) ^5.4.0
- [@comunica/utils-bindings-factory](https://npm.io/package/@comunica/utils-bindings-factory.md) ^5.4.0
- [@comunica/bus-query-source-identify](https://npm.io/package/@comunica/bus-query-source-identify.md) ^5.4.0
- [@comunica/bus-merge-bindings-context](https://npm.io/package/@comunica/bus-merge-bindings-context.md) ^5.4.0

## Alternatives

- [gamedig](https://npm.io/package/gamedig.md) — 29.3K weekly downloads
- [join-monster](https://npm.io/package/join-monster.md) — 12.8K weekly downloads
- [masked](https://npm.io/package/masked.md) — 5.5K weekly downloads
- [@comunica/actor-query-process-explain-logical](https://npm.io/package/@comunica/actor-query-process-explain-logical.md) — 4.7K weekly downloads
- [@veracity/vui](https://npm.io/package/@veracity/vui.md) — 4.6K weekly downloads

## Recent versions

- 5.4.0 (latest) — 2026-09-14
- 4.4.2-alpha.49.0 (next) — 2025-10-22
- 4.5.0 — 2025-11-18
- 4.4.1 — 2025-09-25
- 4.4.0 — 2025-09-17
- 4.2.0 — 2025-04-29
- 4.1.0 — 2025-02-11
- 4.0.2 — 2024-10-16
- 4.0.1 — 2024-10-15
- 4.0.1-alpha.48.0 — 2024-10-08
- 3.3.0 — 2024-10-08
- 3.2.4-alpha.47.0 — 2024-10-08
- 3.2.2 — 2024-08-19
- 3.2.1 — 2024-08-07
- 3.2.0 — 2024-07-05
- … 98 more at https://npm.io/package/@comunica/actor-query-operation-service/versions

## README

# Comunica Service Query Operation Actor

[![npm version](https://badge.fury.io/js/%40comunica%2Factor-query-operation-service.svg)](https://www.npmjs.com/package/@comunica/actor-query-operation-service)

A [Query Operation](https://github.com/comunica/comunica/tree/master/packages/bus-query-operation) actor
that handles SPARQL `SERVICE` clauses of which the target is a variable.

`SERVICE` clauses with an IRI target are rewritten into source-annotated operations by
[`@comunica/actor-optimize-query-operation-assign-sources-exhaustive`](https://github.com/comunica/comunica/tree/master/packages/actor-optimize-query-operation-assign-sources-exhaustive).

Variable targets are disabled by default, as the queried data then determines what is dereferenced,
which is problematic when queries originate from untrusted parties.
They can be enabled via the `serviceAllowVariableTargets` context entry.

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-service
```

## 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-service/^5.0.0/components/context.jsonld"
  ],
  "actors": [
    ...
    {
      "@id": "urn:comunica:default:query-operation/actors#service",
      "@type": "ActorQueryOperationService",
      "mediatorQueryOperation": { "@id": "urn:comunica:default:query-operation/mediators#main" },
      "mediatorQuerySourceIdentify": { "@id": "urn:comunica:default:query-source-identify/mediators#main" },
      "mediatorMergeBindingsContext": { "@id": "urn:comunica:default:merge-bindings-context/mediators#main" }
    }
  ]
}
```

### Config Parameters

* `mediatorQueryOperation`: A mediator over the [Query Operation bus](https://github.com/comunica/comunica/tree/master/packages/bus-query-operation).
* `mediatorQuerySourceIdentify`: A mediator over the [Query Source Identify bus](https://github.com/comunica/comunica/tree/master/packages/bus-query-source-identify).
* `mediatorMergeBindingsContext`: A mediator over the [Merge Bindings Context bus](https://github.com/comunica/comunica/tree/master/packages/bus-merge-bindings-context).
* `forceSparqlEndpoint`: If the SERVICE target should be assumed to be a SPARQL endpoint, defaults to `false`.

---
_Source: https://npm.io/package/@comunica/actor-query-operation-service · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._