feat: RestApiClient example

[gr2m]

This pull request currently fails because I don't know how to export a RestApiClient class type that is extending Base and has both the plugins and defaults implemented.

The JS code is simple enough

import { Base } from "../../index.js";

import { requestPlugin } from "./request-plugin.js";

export const RestApiClient = Base
  .withPlugins([requestPlugin])
  .withDefaults({ userAgent: "rest-api-client/1.0.0" });

But I'm not clear how to define the type declarations so that an import of RestApiClient would set the .request() instance method as well as RestApiClient.defaults

I think ideally I'd like to do something like this?

import { Base } from "javascript-plugin-architecture-with-typescript-definitions";
import { requestPlugin } from "./request-plugin.js"

type Defaults = {
  userAgent: string
}

export class RestApiClient extends Base<Defaults, [requestPlugin]> {}

But I'm not sure how that would work

import { Base } from "javascript-plugin-architecture-with-typescript-definitions";

export class RestApiClient extends Base.withDefaults({
  userAgent: "rest-api-client/1.0.0"
}) {}

RestApiClient.defaults.userAgent // string

When I try the TypeScript code above in this TypeScript playground then the resulting .D.TS code is quite complex.

So two things I want to figure out

1. How to create a .d.ts file for a new class with custom defaults and plugins based on Base
2. How to make step 1 as simple as possible

[JoshuaKGoldberg]

How to create a .d.ts file for a new class with custom defaults and plugins based on Base

Summarizing our 1:1 conversations here: until TypeScript supports a better syntax .d.ts for it, such as typeof class, I don't see a way to get something clean 😞

[github-actions]

🎉 This PR is included in version 4.1.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀