@jamesgopsill/gtr-client v1.1.3

A TS client for the GtR API

This client is a fully-typed Typescript client for the UKRI's Gateway to Research GtR-2 API. It runs both on server (Node.js v18+) and client-side (Browser) javascript providing both ESM and CommonJS modules.

Contents

• Getting Started
• Docs
• Roadmap
• Contributing
• Support the Project
• References

Getting Started

To install the package, use the following code (npm, pnpm or yarn).

pnpm install @jamesgopsill/gtr-client

You can then use package in your code like so (see the examples folder for more implementations):

Typescript

import {
	FundsQuery,
	FundsSearchFields,
	GtrClient,
} from "@jamesgopsill/gtr-client"

const client = new GtrClient(true)

const query: FundsQuery = {
	query: "epsrc",
	searchFields: [FundsSearchFields.FUNDER_ORGANISATION_NAME],
	pageSize: 10,
}

const r = await client.getFunds(query)
if (r.ok) console.log(r.data)

Javascript (ESM)

import { GtrClient, FundsSearchFields } from "@jamesgopsill/gtr-client"

const client = new GtrClient(true)

const query = {
	query: "epsrc",
	searchFields: [FundsSearchFields.FUNDER_ORGANISATION_NAME],
	pageSize: 10,
}

const r = await client.getFunds(query)
if (r.ok) console.log(r.data)

Javascript (CommonJS)

const gtr = require("@jamesgopsill/gtr-client")

const performQuery = async () => {
	const client = new gtr.GtrClient(true)

	const query = {
		query: "epsrc",
		searchFields: [gtr.FundsSearchFields.FUNDER_ORGANISATION_NAME],
		pageSize: 10,
	}

	const r = await client.getFunds(query)
	if (r.ok) console.log(r.data)
}

performQuery()

Docs

The docs have been produced using TypeDoc and can be accessed here.

Roadmap

Contributing

We would love to have additional contributors to the project to help us maintain and add functionality to the project. Please use pnpm pre-add before committing to the repository.

Note. if wanting to run the examples as you develop the repo. Use pnpm link . to link the repo to your available packages.

Support the Project

If you like this project, please consider sponsoring the developers so they can continue to maintain and improve the package.

References

• UKRI Gateway to Research
• Hybrid ESM / CommonJS Module
• Git AutoCLRF
• API Client Template
• Git CRLF LF issues
• CLRF LF issue