npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@windyroad/ofetch-link

v1.0.1

Published

A library that adapts the ofetch library to work with RFC8288 Link objects.

Downloads

13

Readme

@windyroad/ofetch-link

We believe that hypermedia APIs, APIs who's responses include links and forms, significantly reduces to coupling between the client and server, making them easier to evolve.

This library that adapts the ofetch library to work with RFC8288 Links. It parses Link and Link-Template headers, providing them via links() method on the Response, and it can use links as request inputs, allowing call chaining.

Installation

You can install this library using npm:

npm install @windyroad/ofetch-link

Usage

ofetchLink.raw

ofetchLink.raw is an enhanced ofetch.raw function that allows requests to RFC8288 Link objects. It takes in a Link, URL, or RequestInfo object and any custom settings that you want to apply to the request. It returns a Promise that resolves to the Response object representing the response to the request.

import { ofetchLink } from '@windyroad/ofetch-link';

// Fetch the collection using a URL
const collectionResponse = await ofetchLink.raw(
  'https://jsonplaceholder.typicode.com/posts',
);
// Fetch the first item linked by the collection
const itemResponse = await ofetchLink.raw(collectionResponse.links('item')[0]);
// Fetch the collection from the item
const collectionResponse2 = await ofetchLink.raw(itemResponse.links('collection')[0]);

API

ofetchLink<T = unknown, ResponseType = 'json'>(target: string | Link | RequestInfo, init?: RequestInit): Promise<T>

An enhanced ofetch that allows requests to RFC8288 Link objects and returns a Response object with a links method that returns an array of RFC8288 Link objects.

Parameters

  • target - The Link, URL or RequestInfo to fetch from.
  • init - Any custom settings that you want to apply to the request.

Returns

A Promise that resolves to the data returned by the request.

ofetchLink.raw<T = unknown, ResponseType = 'json'>(target: string | Link | RequestInfo, init?: RequestInit): Promise<FetchResponse<MappedType<R,T>>>

An enhanced ofetch.raw that allows requests to RFC8288 Link objects and returns a Response object with a links method that returns an array of RFC8288 Link objects.

Parameters

  • target - The Link, URL or RequestInfo to fetch from.
  • init - Any custom settings that you want to apply to the request.

Returns

A Promise that resolves to the Response object representing the response to the request.

glowUpOfetchWithLinks(): (target: string | Link | RequestInfo, init?: RequestInit) => Promise<Response>

A function that returns an enhanced ofetch.raw function that allows requests to RFC8288 Link objects and returns a Response object with a links method that returns an array of RFC8288 Link objects.

Returns

A function that can be used as an enhanced fetch function.

LinkedResponse

A type that extends the FetchReturns type with a links method that returns an array of RFC8288 Link objects.

Properties

  • links: Returns an array of RFC8288 Link objects from the response headers.

Methods

links(filter?, parameters?)

Returns an array of RFC8288 Link objects from the response headers.

Parameters
  • filter (optional): A partial Link object or string to filter the links by.
  • parameters (optional): An object containing key-value pairs to interpolate into the link templates.
Returns

An array of RFC8288 Link objects.

Link

An RFC8288 Link object, which represents a hyperlink from one resource to another.

Properties

  • uri (string): The URI of the resource that the link refers to. See RFC8288 Section 2.1.
  • rel (string): The relationship between the resource and the link. See RFC8288 Section 3.3.
  • anchor (string, optional): The anchor for the link. See RFC8288 Section 3.4.
  • rev (string, optional): The reverse relationship between the resource and the link. This property is @deprecated and should be avoided. See RFC8288 Section 3.5.
  • hreflang (string, optional): The language of the resource that the link refers to. See RFC8288 Section 3.2.
  • media (string, optional): The media type of the resource that the link refers to. See RFC8288 Section 3.1.
  • title (string, optional): The title of the resource that the link refers to. See RFC8288 Section 3.6.
  • type (string, optional): The media type of the resource that the link refers to. See RFC8288 Section 3.1.
  • method (string, optional): The HTTP method to use when accessing the resource that the link refers to. See RFC8288 Section 3.8.

Contributing

Contributions are welcome! Please read the contributing guidelines for more information.

License

@windyroad/ofetch-link is lovingly licensed under the MIT License. ❤️