Типизация внешних библиотек

import { parse } from "legacy-parser";

const value = library.parse(input);

tsc --traceResolution

npm install -D @types/name

"legacy-lib": "2.x",
"@types/legacy-lib": "4.x"

// Публичный d.ts пакета содержит:
import type { ExternalType } from "external-lib";

declare module "http-client" {
  interface RequestOptions {
    traceId?: string;
  }
}

// У default export может не быть экспортируемого имени,
// которое доступно для augmentation.

declare module "framework" {
  interface Request { user?: AuthUser }
}

const result = client.load();

const value = libraryCall() as unknown as CorrectType;

declare module "legacy-lib" {
  interface Client {
    load(id: string): Promise<Result>;
  }
}

declare const externalParser: { parse(input: string): unknown };
declare function decodeResult(value: unknown): DomainResult;
export function parseDomain(input: string): DomainResult {
  return decodeResult(externalParser.parse(input));
}

import { parse } from "legacy-lib";
// @ts-expect-error — streamParse отсутствует в используемой версии
import { streamParse } from "legacy-lib";

import { parse } from "legacy-lib";
const result = parse("data");
// Установленные JavaScript и @types выпущены разными версиями.

declare module "external-client" {
  interface ClientOptions { retry?: number }
}
// В новой версии пакет объявил retry как объект политики.

export interface ImageResizer {
  resize(input: Uint8Array, options: ResizeOptions): Promise<Uint8Array>;
}

export type PublicDependency =
  typeof import("large-lib/dist/internal/client");