@avantf/dsh-plugin-base 0.3.1

package/dist/providers/npm.js

@@ -0,0 +1,458 @@
+/**
+ * The built-in `npm-package` provider.
+ * @module providers/npm
+ */
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { ProvisionError } from '../errors.js';
+import { exists, linkOrCopy } from '../fs.js';
+import { verifyIntegrity } from '../integrity.js';
+import { isInside } from '../layout.js';
+import { decodeJson, readInstallManifest } from '../manifest.js';
+import { DEFAULT_MAX_BYTES, candidateUrls, fetchImplOf, readCapped, signalFor } from '../net.js';
+import { assertPackageName } from '../package-name.js';
+import { parseRange, parseVersion, satisfiesRange, selectVersion } from '../semver.js';
+import { extractTarGz } from '../tar.js';
+export const NPM_PACKAGE_KIND = 'npm-package';
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+const VERIFY_TIMEOUT_MS = 15_000;
+/** Depth limit for the `verify` scan for a prebuilt native module. */
+const NATIVE_SCAN_DEPTH = 3;
+function parseSpec(item) {
+    const spec = item.spec;
+    if (typeof spec !== 'object' || spec === null) {
+        throw new ProvisionError('invalid-option', `npm-package 的 spec 必须是 {name, range}：${String(item.id)}`);
+    }
+    const record = spec;
+    const name = record['name'];
+    const range = record['range'];
+    if (typeof name !== 'string' || name === '' || typeof range !== 'string' || range === '') {
+        throw new ProvisionError('invalid-option', `npm-package 的 spec 缺少 name/range：${String(item.id)}`);
+    }
+    assertPackageName(name);
+    return spec;
+}
+async function fetchPackument(ctx, spec) {
+    const registry = spec.registry ?? DEFAULT_REGISTRY;
+    const url = `${registry.replace(/\/+$/, '')}/${spec.name}`;
+    let response;
+    try {
+        response = await fetchImplOf(ctx)(url, { headers: { accept: 'application/json' }, signal: signalFor(ctx) });
+    }
+    catch (error) {
+        throw new ProvisionError('fetch/failed', `无法获取 packument：${url}（${error instanceof Error ? error.message : String(error)}）`);
+    }
+    if (!response.ok)
+        throw new ProvisionError('fetch/failed', `packument ${url} 返回 HTTP ${String(response.status)}`);
+    const body = await response.json();
+    const versions = typeof body === 'object' && body !== null ? body.versions : undefined;
+    if (typeof versions !== 'object' || versions === null) {
+        throw new ProvisionError('fetch/failed', `packument ${url} 没有 versions`);
+    }
+    return versions;
+}
+async function download(ctx, urls, integrity) {
+    const problems = [];
+    for (const url of urls) {
+        let bytes;
+        try {
+            const response = await fetchImplOf(ctx)(url, { signal: signalFor(ctx) });
+            if (!response.ok) {
+                problems.push(`${url} → HTTP ${String(response.status)}`);
+                continue;
+            }
+            bytes = await readCapped(response, DEFAULT_MAX_BYTES);
+        }
+        catch (error) {
+            problems.push(`${url} → ${error instanceof Error ? error.message : String(error)}`);
+            continue;
+        }
+        // Only transport failures fall through to the next candidate.
+        verifyIntegrity(bytes, integrity);
+        return { bytes, url };
+    }
+    throw new ProvisionError('fetch/failed', `npm 包的所有候选源都失败：${problems.join('; ')}`);
+}
+/** npm's `os`/`cpu` semantics: bare names allow, `!name` denials win. */
+function listAllows(list, value) {
+    if (list === undefined || list.length === 0)
+        return true;
+    const negatives = list.filter(entry => entry.startsWith('!')).map(entry => entry.slice(1));
+    if (negatives.includes(value))
+        return false;
+    const positives = list.filter(entry => !entry.startsWith('!'));
+    return positives.length === 0 || positives.includes(value);
+}
+function nodeAllows(range, runtime) {
+    if (range === undefined || range === '')
+        return true;
+    try {
+        return satisfiesRange(runtime, range);
+    }
+    catch {
+        return true; // an engine range outside the supported subset is ignored
+    }
+}
+/** Versions a range names with an exact comparator, i.e. those allowed to be deprecated. */
+function pinnedVersions(range) {
+    const pinned = new Set();
+    try {
+        for (const alternative of parseRange(range)) {
+            for (const comparator of alternative) {
+                if (comparator.op !== '=')
+                    continue;
+                const { major, minor, patch, prerelease } = comparator.version;
+                pinned.add(`${String(major)}.${String(minor)}.${String(patch)}${prerelease.length === 0 ? '' : `-${prerelease.join('.')}`}`);
+            }
+        }
+    }
+    catch {
+        return pinned;
+    }
+    return pinned;
+}
+/** Pick the highest release satisfying the range, engine, `os`/`cpu` and deprecation filters. */
+function resolveVersion(versions, spec, platform, arch, runtime) {
+    const pinned = pinnedVersions(spec.range);
+    const usable = Object.entries(versions).filter(([text, candidate]) => {
+        if (candidate === undefined || parseVersion(text) === undefined)
+            return false;
+        if (!nodeAllows(candidate.engines?.node, runtime))
+            return false;
+        if (!listAllows(candidate.os, platform))
+            return false;
+        if (!listAllows(candidate.cpu, arch))
+            return false;
+        if (candidate.deprecated !== undefined && !pinned.has(text))
+            return false;
+        return true;
+    });
+    return selectVersion(usable.map(([text]) => text), spec.range);
+}
+/** Depth-first search for a prebuilt native module (`*.node`). */
+async function findNativeModule(ctx, dir, depth = 0) {
+    if (depth > NATIVE_SCAN_DEPTH)
+        return undefined;
+    let entries;
+    try {
+        entries = await ctx.fs.readdir(dir);
+    }
+    catch {
+        return undefined;
+    }
+    for (const entry of entries) {
+        if (entry.endsWith('.node'))
+            return join(dir, entry);
+        if (entry === 'node_modules')
+            continue;
+        const path = join(dir, entry);
+        const info = await ctx.fs.stat(path);
+        if (info?.isDirectory === true) {
+            const found = await findNativeModule(ctx, path, depth + 1);
+            if (found !== undefined)
+                return found;
+        }
+    }
+    return undefined;
+}
+async function packageVersionOf(ctx, dir) {
+    try {
+        const raw = decodeJson(await ctx.fs.readFile(join(dir, 'package.json')));
+        if (typeof raw !== 'object' || raw === null)
+            return undefined;
+        const version = raw.version;
+        return typeof version === 'string' && version !== '' ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Walk up from a resolved entry to the owning package directory. */
+function packageDirOf(entry, name) {
+    let dir = dirname(entry);
+    for (let depth = 0; depth < 6; depth += 1) {
+        if (dir === dirname(dir))
+            return undefined;
+        dir = dirname(dir);
+        if (dir.endsWith(name))
+            return dir;
+    }
+    return undefined;
+}
+/** Resolve a peer directory from the caller's tree, falling back to an entry walk-up. */
+function resolvePeerDir(peer) {
+    const roots = [join(process.cwd(), 'noop.js'), import.meta.url];
+    for (const root of roots) {
+        try {
+            return dirname(createRequire(root).resolve(`${peer}/package.json`));
+        }
+        catch {
+            // fall through to the entry walk-up
+        }
+    }
+    for (const root of roots) {
+        try {
+            const entry = createRequire(root).resolve(peer);
+            const dir = packageDirOf(entry, peer);
+            if (dir !== undefined)
+                return dir;
+        }
+        catch {
+            // not resolvable from this root
+        }
+    }
+    return undefined;
+}
+async function linkPeers(pkgDir, spec, staging, ctx) {
+    const raw = decodeJson(await ctx.fs.readFile(join(pkgDir, 'package.json')));
+    if (typeof raw !== 'object' || raw === null)
+        return;
+    const manifest = raw;
+    const peers = manifest.peerDependencies ?? {};
+    const meta = manifest.peerDependenciesMeta ?? {};
+    for (const [peer, range] of Object.entries(peers)) {
+        assertPackageName(peer, 'peer 名');
+        const declared = spec.peers?.find(candidate => candidate.name === peer);
+        const optional = meta[peer]?.optional === true || declared?.optional === true;
+        const dir = declared?.dir ?? resolvePeerDir(peer);
+        if (dir === undefined) {
+            if (optional)
+                continue;
+            throw new ProvisionError('peer/unsatisfied', `peer ${peer}@${range} 不可满足（调用方未解析该 peer，也没有提供目录）`);
+        }
+        // A peer that is present but does not satisfy the range makes the item unusable.
+        const installed = await packageVersionOf(ctx, dir);
+        if (installed !== undefined) {
+            let satisfied = true;
+            try {
+                satisfied = satisfiesRange(installed, range);
+            }
+            catch {
+                ctx.logger.warn(`peer ${peer} 的区间 "${range}" 不在支持的 semver 子集内，按满足处理`);
+            }
+            if (!satisfied) {
+                if (optional)
+                    continue;
+                throw new ProvisionError('peer/unsatisfied', `peer ${peer} 需要 ${range}，调用方解析到的是 ${installed}`);
+            }
+        }
+        const linkPath = join(staging, 'node_modules', ...peer.split('/'));
+        // Fall back to a real copy when symlinks are unavailable.
+        await linkOrCopy(ctx.fs, dir, linkPath, {
+            onFallback: () => ctx.logger.warn(`peer ${peer} 退化为复制：identity 不再保证`),
+        });
+    }
+}
+async function withTimeout(promise, ms, message) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => reject(new ProvisionError('verify/failed', message)), ms);
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+/** The entry-file candidates a `package.json` points at, in Node's resolution order. */
+function entryCandidatesOf(pkgDir, pkg) {
+    const exported = pkg['exports'];
+    let relativePath;
+    let exact = false;
+    if (typeof exported === 'string') {
+        relativePath = exported;
+        exact = true;
+    }
+    else if (typeof exported === 'object' && exported !== null) {
+        const dot = exported['.'] ?? exported;
+        if (typeof dot === 'string') {
+            relativePath = dot;
+            exact = true;
+        }
+        else if (typeof dot === 'object' && dot !== null) {
+            const conditions = dot;
+            for (const key of ['import', 'default', 'require']) {
+                const value = conditions[key];
+                if (typeof value === 'string') {
+                    relativePath = value;
+                    exact = true;
+                    break;
+                }
+            }
+        }
+    }
+    if (relativePath === undefined && typeof pkg['main'] === 'string') {
+        const main = pkg['main'];
+        // An empty or root-relative `main` maps to index.js.
+        relativePath = main === '' || main === '.' || main === './' ? 'index.js' : main;
+    }
+    if (relativePath === undefined)
+        relativePath = 'index.js';
+    const base = join(pkgDir, relativePath);
+    if (exact)
+        return [base];
+    return [base, `${base}.js`, `${base}.json`, `${base}.node`, join(base, 'index.js')];
+}
+/** Build the built-in npm provider. */
+export function npmPackageProvider(options = {}) {
+    const id = options.id ?? '@avantf/dsh-plugin-base/npm';
+    // Version directories already reported as `unverifiable`, warned once per provider instance.
+    const warnedUnverifiable = new Set();
+    return {
+        id,
+        kinds: [NPM_PACKAGE_KIND],
+        identify(item) {
+            const spec = parseSpec(item);
+            return { name: spec.name, range: spec.range };
+        },
+        targetDir(_item, ref) {
+            return `${ref.name}/${ref.segment}`;
+        },
+        async probe(item, ctx) {
+            const spec = parseSpec(item);
+            const root = join(ctx.home, item.target.root, ...spec.name.split('/'));
+            let entries;
+            try {
+                entries = await ctx.fs.readdir(root);
+            }
+            catch {
+                return { found: false };
+            }
+            const candidates = [];
+            for (const entry of entries) {
+                if (entry.startsWith('.'))
+                    continue;
+                const versionDir = join(root, entry);
+                const manifestPath = join(versionDir, 'install.json');
+                if ((await ctx.fs.stat(manifestPath)) === undefined)
+                    continue;
+                const manifest = readInstallManifest(decodeJson(await ctx.fs.readFile(manifestPath)), NPM_PACKAGE_KIND);
+                if (manifest === undefined)
+                    continue;
+                if (!satisfiesRange(manifest.version, spec.range))
+                    continue;
+                if (manifest.integrity === undefined && !warnedUnverifiable.has(versionDir)) {
+                    // Without integrity the copy is still reusable, but is reported once as unverifiable.
+                    warnedUnverifiable.add(versionDir);
+                    ctx.logger.warn(`unverifiable: ${versionDir} 的 install.json 没有 integrity；按可用处理`);
+                }
+                const relativeEntry = manifest.entryDir ?? `node_modules/${spec.name}`;
+                const entryDir = join(versionDir, ...relativeEntry.split('/'));
+                // A copy whose entry directory is missing is not usable.
+                if (!(await exists(ctx.fs, entryDir)))
+                    continue;
+                candidates.push({
+                    version: manifest.version,
+                    versionDir,
+                    entryDir,
+                    installedAt: Date.parse(manifest.installed_at) || 0,
+                });
+            }
+            // The newest `installed_at` wins when several directories describe one version.
+            const best = candidates.sort((a, b) => b.installedAt - a.installedAt)[0];
+            if (best === undefined)
+                return { found: false };
+            return { found: true, version: best.version, dir: best.entryDir, source: 'managed' };
+        },
+        plan() {
+            return { action: 'install' };
+        },
+        async install(item, ctx) {
+            const spec = parseSpec(item);
+            const versions = await fetchPackument(ctx, spec);
+            const version = resolveVersion(versions, spec, process.platform, process.arch, process.version);
+            if (version === undefined) {
+                throw new ProvisionError('npm/no-satisfying-version', `${spec.name} 没有同时满足 "${spec.range}" 与本机（node ${process.version} / ${process.platform}-${process.arch}）的版本`);
+            }
+            const candidate = versions[version];
+            const dist = candidate?.dist;
+            const integrity = spec.expectedIntegrity ?? dist?.integrity;
+            if (integrity === undefined) {
+                throw new ProvisionError('npm/no-integrity', `${spec.name}@${version} 的 packument 没有 dist.integrity（只有 shasum 的包一律拒绝）`);
+            }
+            const tarball = dist?.tarball;
+            if (tarball === undefined || tarball === '') {
+                throw new ProvisionError('fetch/failed', `${spec.name}@${version} 的 packument 没有 dist.tarball`);
+            }
+            const staging = await ctx.stage();
+            const urls = candidateUrls(tarball, ctx.policy.mirrors?.npm);
+            const downloaded = await download(ctx, urls, integrity);
+            if (downloaded.url !== tarball)
+                ctx.logger.debug(`tarball 来自镜像：${downloaded.url}`);
+            const bytes = downloaded.bytes;
+            const pkgDir = join(staging, 'node_modules', ...spec.name.split('/'));
+            await extractTarGz(bytes, pkgDir, ctx.fs, { strip: 1 });
+            await linkPeers(pkgDir, spec, staging, ctx);
+            const meta = {
+                name: spec.name,
+                version,
+                integrity,
+                tarball,
+                source: 'installed',
+                entryDir: `node_modules/${spec.name}`,
+            };
+            return ctx.publish(staging, meta);
+        },
+        async verify(item, resolved, ctx) {
+            const pkgDir = resolved.entryDir;
+            const packageJsonPath = join(pkgDir, 'package.json');
+            if (!(await exists(ctx.fs, packageJsonPath))) {
+                throw new ProvisionError('verify/failed', `包缺少 package.json：${pkgDir}`);
+            }
+            const parsed = decodeJson(await ctx.fs.readFile(packageJsonPath));
+            if (typeof parsed !== 'object' || parsed === null) {
+                throw new ProvisionError('verify/failed', `package.json 不可解析：${packageJsonPath}`);
+            }
+            const pkg = parsed;
+            const scripts = (pkg['scripts'] ?? {});
+            for (const lifecycle of ['preinstall', 'install', 'postinstall']) {
+                const command = scripts[lifecycle];
+                if (typeof command === 'string' && command !== '') {
+                    throw new ProvisionError('npm/lifecycle-script-unsupported', `${specNameOf(item)} 声明了 ${lifecycle} 脚本；本设施手动解包、不执行 lifecycle scripts，请手动预置`);
+                }
+            }
+            if (await exists(ctx.fs, join(pkgDir, 'binding.gyp'))) {
+                throw new ProvisionError('verify/failed', `${specNameOf(item)} 是原生模块（binding.gyp）；本设施不接管原生模块，请走平台 prebuilt 或二进制归档路线`);
+            }
+            const native = await findNativeModule(ctx, pkgDir);
+            if (native !== undefined) {
+                throw new ProvisionError('verify/failed', `${specNameOf(item)} 带预编译原生模块（${native}）；本设施不接管原生模块，请走平台 prebuilt 或二进制归档路线`);
+            }
+            const candidates = entryCandidatesOf(pkgDir, pkg);
+            // A candidate must be a real descendant of the package directory.
+            const safe = candidates.filter(candidate => candidate !== pkgDir && isInside(pkgDir, candidate));
+            if (safe.length === 0) {
+                throw new ProvisionError('verify/failed', `package.json 的入口跳出包目录：${String(pkg['exports'] ?? pkg['main'])}`);
+            }
+            let entry;
+            for (const candidate of safe) {
+                if (await exists(ctx.fs, candidate)) {
+                    entry = candidate;
+                    break;
+                }
+            }
+            // A missing entry file means the tarball is incomplete.
+            if (entry === undefined) {
+                throw new ProvisionError('verify/failed', `${specNameOf(item)} 的入口文件不存在：${safe[0] ?? pkgDir}（包自身不完整）`);
+            }
+            const url = pathToFileURL(entry).href;
+            try {
+                await withTimeout(import(url), VERIFY_TIMEOUT_MS, `import() 超时：${url}`);
+            }
+            catch (error) {
+                if (error instanceof ProvisionError)
+                    throw error;
+                throw new ProvisionError('verify/failed', `import() 失败：${url}（${error instanceof Error ? error.message : String(error)}）`);
+            }
+        },
+    };
+}
+function specNameOf(item) {
+    return parseSpec(item).name;
+}
+//# sourceMappingURL=npm.js.map

package/dist/providers/npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.js","sourceRoot":"","sources":["../../src/providers/npm.ts"],"names":[],"mappings":"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"}

package/dist/provisioner.d.ts

@@ -0,0 +1,21 @@
+import type { AtStartup, AtUse, ProvisionItem, Provisioner, ProvisionerOptions } from './types.js';
+/** The capability names this copy implements. @stable */
+export declare const CAPABILITIES: readonly string[];
+/** Startup critical-path budget in ms. @stable */
+export declare const DEFAULT_DEADLINE_MS = 15000;
+/** Descriptor version this build understands. @stable */
+export declare const ITEM_SCHEMA_VERSION = 1;
+interface NormalizedMissing {
+    readonly atStartup: AtStartup;
+    readonly atUse: AtUse;
+}
+/** `onMissing` defaults, per axis: `degrade` / `error` (see `docs/DESIGN.md`). Absent and `{}` are the
+ *  SAME request — the two used to disagree on `atUse`, so "omit the object" quietly meant something
+ *  other than "declare no preference". (`atUse` is declarative today: nothing consumes it yet, which
+ *  is exactly why the documented default has to be the one the code reports.) */
+export declare function normalizeOnMissing(value: ProvisionItem['onMissing']): NormalizedMissing;
+/** Create a provisioner instance.
+ *  @stable */
+export declare function createProvisioner(options: ProvisionerOptions): Provisioner;
+export {};
+//# sourceMappingURL=provisioner.d.ts.map

package/dist/provisioner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioner.d.ts","sourceRoot":"","sources":["../src/provisioner.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EAeL,aAAa,EAMb,WAAW,EAEX,kBAAkB,EAMnB,MAAM,YAAY,CAAA;AAEnB,yDAAyD;AACzD,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAA6C,CAAA;AAEvF,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,QAAS,CAAA;AAEzC,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,IAAI,CAAA;AASpC,UAAU,iBAAiB;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CACtB;AAED;;;iFAGiF;AACjF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,iBAAiB,CAKvF;AAwCD;cACc;AACd,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAm5B1E"}