@comunica/actor-http-fetch

Comunica Fetch HTTP Actor

An HTTP actor that uses cross-fetch to perform HTTP requests.

This module is part of the Comunica framework, and should only be used by developers that want to build their own query engine.

When this actor is used, a custom fetch implementation may be provided via the context (fetch). If none is provided, the default fallback fetch implementation will be used (node-fetch in Node.js, and the browser's fetch in browser environments).

Click here if you just want to query with Comunica.

Install

$ yarn add @comunica/actor-http-fetch

Configure

After installing, this package can be added to your engine's configuration as follows:

{
  "@context": [
    ...
    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/actor-http-fetch/^2.0.0/components/context.jsonld"  
  ],
  "actors": [
    ...
    {
      "@id": "urn:comunica:default:http/actors#fetch",
      "@type": "ActorHttpFetch"
    }
  ]
}

Config Parameters

• agentOptions: The agent JSON options for the HTTP agent. (optional)

Changelog

v2.0.1 - 2022-03-02

BREAKING CHANGES

• Set minimum Node version to 14
  • Update tsconfig to es2020
• Public API
  • Improve names of query result interfaces
  • Implement new RDF/JS Bindings and BindingsFactory
  • Rename update results to void results
  • Implement RDF.Queryable in IQueryEngine
  • Make query context type-safe
  • Represent query formats as RDF.QueryFormat
  • Implement RDF.SparqlQueryable in IQueryEngine
• Internal API
  • Make metadata in query operations mandatory and strictly typed
  • Add Mediate utility type, Closes #902
  • Make ActionContext type-safe
  • Make context object required in actions
  • Use Headers rather than Record<string, string>
  • Rename IQueryableResult to IQueryOperationResult
  • Make IMediatorTypeJoinCoefficients implement RDF.QueryOperationCost
  • Migrate metadata interface to RDF/JS metadata types
  • Move variables field into metadata
  • Make boolean and void results lazy
• Remove deprecated features
  • Remove deprecated string variant in links bus output
  • Make links queue mediator in hypermedia resolver mandatory
  • Remove backwards-compat for source and hypermedia tagged sources
  • Remove deprecated exports
  • Remove unused init actors
  • Remove deprecated packages
  • Remove inefficient query-based metadata extractors
  • Remove utils-datasource package
  • Remove bindings and quads methods in favor of toArray on AsyncIterator
• Restructure packages
  • Move index files to lib directory
  • Rename actor-rdf-dereference-http-parse to actor-rdf-dereference-http
  • Move peerDependencies to dependencies
  • Remove unnecessary entries from package.json files
  • Rename bus-sparql-serialize to bus-query-result-serialize
  • Rename bus-sparql-parse to bus-query-parse
  • Rename actor-http-node-fetch to actor-http-fetch
  • Decouple configs and query engines into separate packages
  • Add generic dereference bus
  • Move sorting of join entries to dedicated bus
  • Remove args_ prefixes in config files when possible
• Refactor join operations:
  • Add logical join type field to join action
  • Add actor to cluster connected join entries
  • Consider multiple coefficients during join mediation
  • Add optimize actor to convert BGPs to joins
  • Add cardinality metadata to all property path actors
  • Rename totalItems metadata to cardinality
  • Remove BGP actors in favor of new join actors
  • Add BGP actor that delegates to join bus
  • Add Bind-Join actor
  • Add bus for providing join selectivities
  • Add variable counting join cardinality heuristic
  • Add minus query operation actor that delegates to join bus
  • Add left join query operation actor that delegates to join bus
  • Add hash-based minus join actor that does not handle undefs
  • Add hash-based minus join actor that handles undefs
  • Add bind-based optional join actor
  • Add nested loop-based optional join actor
  • Change BGP-specific context entries to more general join entries
  • Include original operations into join input interface
  • Migrate to multi-join-based datastructures in sparqlalgebrajs
  • Rename plain join actors to inner join actors
• Other
  • Deskolemise blank nodes before updates, Closes #911

Added

• Public API
  • Allow query plan to be printed
  • Add bindings-factory package
  • Allow full stack trace to be printed on CLI via --showStackTrace
  • Add dedicated explain method on IQueryEngine
• Internal API
  • Expose convenience types in bus packages for simpler actors impls
  • Add hash provider bus
  • Allow packager to output list of dependencies for a config
  • An optional parameter to MediatorCombinePipeline to filter erroring actors
  • Add option to enable ordering strategy in MediatorCombinePipeline
  • Add setSafe method to IActionContext

Changed

• Automatically generate components/ directories:
  • Remove components directory from git
  • Generate components in bulk
• Move index files to lib directory
• Update to sparqlalgebrajs 4
• Mark parsed quad stream as Readable
• Send original SPARQL query string to endpoints
• Update to Webpack 5
• Add sideEffects: false to package.json files for treeshaking
• Prefer joins with early results for queries with limit

<a name="v1.22.3"></a>