Yichen Jiang
716e2e2683
Add registry and fallbackRegistries to the manager Config, ask them in order from inspect and installBundle with --registry, and move on only for failures another registry can change: unreachable, timed out, or a copy the registry lacks. A git or tarball spec's own host is never retried through a registry, and a registry outside the configured set is asked alone. The lookup runs without pnpm's retries so a dead registry is reported within inspectTimeoutMs; the install keeps pnpm's defaults. Results carry the registries asked, the install-state event names each attempt, and the plugin_manager tool takes a registry.
92 lines
4.5 KiB
TypeScript
92 lines
4.5 KiB
TypeScript
/**
|
|
* Reading an install spec before pnpm sees it: which of pnpm's spec forms it
|
|
* takes, and for a registry name whether it is one the registry can accept.
|
|
* @module @deepseek-ai/dsh-plugin-manager/install-spec
|
|
*/
|
|
|
|
import { isAbsolute } from 'node:path'
|
|
|
|
/**
|
|
* One spec read into its form and the parts an inspection needs. A git spec
|
|
* and a tarball URL carry the `host` pnpm fetches them from, which no registry
|
|
* stands in for; only their dependencies come from the registry.
|
|
*/
|
|
export type ParsedInstallSpec =
|
|
| { readonly kind: 'registry'; readonly spec: string; readonly name: string; readonly range?: string }
|
|
| { readonly kind: 'path'; readonly spec: string; readonly path: string }
|
|
| { readonly kind: 'tarball'; readonly spec: string; readonly path?: string; readonly host?: string }
|
|
| { readonly kind: 'git'; readonly spec: string; readonly host: string }
|
|
|
|
/** The forms pnpm resolves through a git host: a host shorthand, a git URL, or a hosted repository URL. */
|
|
const GIT_SHORTHAND = /^(?:github|gitlab|bitbucket|gist):/i
|
|
const GIT_URL = /^git(?:\+[a-z]+)?:\/\/|^git@[^:]+:/i
|
|
const HOSTED_REPOSITORY_URL = /^https?:\/\/[^/]+\/[^/]+\/[^/#]+(?:\.git)?(?:#.*)?$/i
|
|
/** The hosts pnpm's shorthands stand for. */
|
|
const GIT_SHORTHAND_HOSTS: Readonly<Record<string, string>> = {
|
|
github: 'github.com', gitlab: 'gitlab.com', bitbucket: 'bitbucket.org', gist: 'gist.github.com',
|
|
}
|
|
/** A tarball, on disk or over HTTP. */
|
|
const TARBALL_SPEC = /\.(?:tgz|tar\.gz)(?:#.*)?$/i
|
|
/** An npm package name: lowercase URL-safe segments, an optional scope, no leading dot or underscore. */
|
|
const PACKAGE_NAME = /^(?:@[a-z0-9][a-z0-9._~-]*\/)?[a-z0-9][a-z0-9._~-]*$/
|
|
const PACKAGE_NAME_MAX_LENGTH = 214
|
|
|
|
/** A spec neither pnpm nor the registry would take; `reason` is what the person reads. */
|
|
export class InvalidInstallSpecError extends Error {
|
|
/**
|
|
* @param spec - the spec as typed, trimmed.
|
|
* @param reason - why it is refused, as one sentence.
|
|
*/
|
|
constructor(readonly spec: string, readonly reason: string) {
|
|
super(`plugin-manager: ${reason}: ${spec}`)
|
|
this.name = 'InvalidInstallSpecError'
|
|
}
|
|
}
|
|
|
|
function invalid(spec: string, reason: string): InvalidInstallSpecError {
|
|
return new InvalidInstallSpecError(spec, reason)
|
|
}
|
|
|
|
/** The host a git spec is cloned from: the shorthand's host, the scp-like user@host, or the URL's host with its port. */
|
|
function gitHost(spec: string): string {
|
|
const shorthand = /^([a-z]+):/i.exec(spec)?.[1]?.toLowerCase()
|
|
if (shorthand !== undefined && Object.hasOwn(GIT_SHORTHAND_HOSTS, shorthand)) return GIT_SHORTHAND_HOSTS[shorthand] as string
|
|
const scp = /^git@([^:]+):/i.exec(spec)?.[1]
|
|
if (scp !== undefined) return scp.toLowerCase()
|
|
return new URL(spec.replace(/^git\+/i, '')).host
|
|
}
|
|
|
|
/**
|
|
* Read a spec into its form. A path must be absolute: the Host's working
|
|
* directory means nothing to the person typing into a browser, and a
|
|
* relative path resolved against the profile would point inside it.
|
|
* @param raw - the spec as typed.
|
|
* @returns the parsed spec.
|
|
* @throws {InvalidInstallSpecError} for an empty spec, a relative path, a name the
|
|
* registry would refuse, or a URL that is neither a git host nor a tarball.
|
|
*/
|
|
export function parseInstallSpec(raw: string): ParsedInstallSpec {
|
|
const spec = raw.trim()
|
|
if (spec === '') throw invalid(spec, 'the package spec must not be empty')
|
|
const path = spec.replace(/^(?:file|link):/, '')
|
|
if (path !== spec || isAbsolute(path)) {
|
|
if (!isAbsolute(path)) throw invalid(spec, 'a local path must be absolute')
|
|
return TARBALL_SPEC.test(path) ? { kind: 'tarball', spec, path } : { kind: 'path', spec, path }
|
|
}
|
|
if (/^\.{1,2}(?:[\\/]|$)/.test(spec)) throw invalid(spec, 'a local path must be absolute')
|
|
const git = GIT_SHORTHAND.test(spec) || GIT_URL.test(spec) || HOSTED_REPOSITORY_URL.test(spec)
|
|
if (git && !TARBALL_SPEC.test(spec)) return { kind: 'git', spec, host: gitHost(spec) }
|
|
if (/^https?:\/\//i.test(spec)) {
|
|
if (TARBALL_SPEC.test(spec)) return { kind: 'tarball', spec, host: new URL(spec).host }
|
|
throw invalid(spec, 'a URL must point at a git repository or a tarball')
|
|
}
|
|
const at = spec.indexOf('@', 1)
|
|
const name = at === -1 ? spec : spec.slice(0, at)
|
|
const range = at === -1 ? undefined : spec.slice(at + 1)
|
|
if (name.length > PACKAGE_NAME_MAX_LENGTH || !PACKAGE_NAME.test(name)) {
|
|
throw invalid(spec, 'not a package name the registry accepts')
|
|
}
|
|
if (range === '') throw invalid(spec, 'a version after @ must not be empty')
|
|
return range === undefined ? { kind: 'registry', spec, name } : { kind: 'registry', spec, name, range }
|
|
}
|