@avantf/dsh-plugin-base 0.3.1

package/dist/providers/archive.js

@@ -0,0 +1,248 @@
+/**
+ * The built-in `binary-archive` provider.
+ * @module providers/archive
+ */
+import { delimiter, dirname, join } from 'node:path';
+import { execFile } from 'node:child_process';
+import { ProvisionError } from '../errors.js';
+import { exists } from '../fs.js';
+import { sriOfSha256 } from '../integrity.js';
+import { decodeJson, readInstallManifest } from '../manifest.js';
+import { candidateUrls, downloadBytes, platformKey, verifySha256 } from '../net.js';
+import { extractTarGz } from '../tar.js';
+import { extractZip } from '../zip.js';
+export const BINARY_ARCHIVE_KIND = 'binary-archive';
+const VERIFY_TIMEOUT_MS = 15_000;
+/** Timeout for the short version probe that confirms a PATH hit. */
+const PROBE_TIMEOUT_MS = 3_000;
+const UNPACK_DIR = '.unpack';
+const MAX_SEARCH_DEPTH = 4;
+function parseSpec(item) {
+    const spec = item.spec;
+    if (typeof spec !== 'object' || spec === null) {
+        throw new ProvisionError('invalid-option', `binary-archive 的 spec 必须是 {id, version, packs}：${String(item.id)}`);
+    }
+    const record = spec;
+    if (typeof record['id'] !== 'string' || typeof record['version'] !== 'string' || typeof record['packs'] !== 'object' || record['packs'] === null) {
+        throw new ProvisionError('invalid-option', `binary-archive 的 spec 缺少 id/version/packs：${String(item.id)}`);
+    }
+    return spec;
+}
+function binaryOf(spec, pack) {
+    return pack?.binary ?? spec.binary ?? spec.id;
+}
+/** Search a tree for the executable, preferring shallower matches. */
+async function findBinary(root, name, fs, depth = 0) {
+    if (depth > MAX_SEARCH_DEPTH)
+        return undefined;
+    let entries;
+    try {
+        entries = await fs.readdir(root);
+    }
+    catch {
+        return undefined;
+    }
+    const directories = [];
+    for (const entry of entries) {
+        const path = join(root, entry);
+        const info = await fs.stat(path);
+        if (info === undefined)
+            continue;
+        if (info.isDirectory) {
+            directories.push(path);
+            continue;
+        }
+        if (entry === name || entry === `${name}.exe`)
+            return path;
+    }
+    for (const directory of directories.sort()) {
+        const found = await findBinary(directory, name, fs, depth + 1);
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+/** Every executable candidate on `PATH`, in scan order. */
+async function findAllOnPath(binary, fs) {
+    const names = process.platform === 'win32' ? [binary, `${binary}.exe`, `${binary}.cmd`] : [binary];
+    const path = process.env['PATH'] ?? '';
+    const found = [];
+    for (const directory of path.split(delimiter)) {
+        if (directory === '')
+            continue;
+        for (const candidate of names) {
+            const full = join(directory, candidate);
+            if (await exists(fs, full))
+                found.push(full);
+        }
+    }
+    return found;
+}
+/** PATH contribution of a managed/explicit executable directory. */
+function pathEnvOf(dir) {
+    return { PATH: `${dir}${delimiter}${process.env['PATH'] ?? ''}` };
+}
+/** Run the `--version` probe; `'timeout'` means the version is unknown. */
+function runVersionProbe(path, args, options = {}) {
+    return new Promise(resolve => {
+        execFile(path, [...args], {
+            timeout: options.timeoutMs ?? VERIFY_TIMEOUT_MS,
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        }, error => {
+            if (error === null) {
+                resolve('ok');
+                return;
+            }
+            const killed = error.killed === true || error.code === 'ETIMEDOUT';
+            resolve(killed ? 'timeout' : 'failed');
+        });
+    });
+}
+/** Build the built-in binary-archive provider. */
+export function binaryArchiveProvider(options = {}) {
+    const id = options.id ?? '@avantf/dsh-plugin-base/binary-archive';
+    return {
+        id,
+        kinds: [BINARY_ARCHIVE_KIND],
+        identify(item) {
+            const spec = parseSpec(item);
+            return { name: spec.id, range: spec.version };
+        },
+        targetDir(_item, ref) {
+            return `${ref.name}/${ref.segment}`;
+        },
+        /** Return `install` with the pinned version and pack URLs, or `unknown` without a pack. */
+        plan(item, ctx) {
+            const spec = parseSpec(item);
+            const pack = spec.packs[platformKey()];
+            if (pack === undefined)
+                return { action: 'unknown' };
+            return { action: 'install', version: spec.version, urls: candidateUrls(pack.url, ctx.policy.mirrors?.archive) };
+        },
+        async probe(item, ctx) {
+            const spec = parseSpec(item);
+            const binary = binaryOf(spec);
+            const args = spec.versionArgs ?? ['--version'];
+            // A PATH/explicit hit is confirmed with the same `--version` probe as verify.
+            const check = async (path) => {
+                if (args.length === 0)
+                    return { version: spec.version };
+                const outcome = await runVersionProbe(path, args, { timeoutMs: PROBE_TIMEOUT_MS, ...(ctx.signal === undefined ? {} : { signal: ctx.signal }) });
+                if (outcome === 'ok')
+                    return { version: spec.version };
+                if (outcome === 'timeout') {
+                    ctx.logger.warn(`${path} 的 ${args.join(' ')} 探针超时；按"存在但版本未知"处理`);
+                    return {};
+                }
+                return undefined;
+            };
+            const fromEnv = spec.envVar === undefined ? undefined : process.env[spec.envVar];
+            const explicit = spec.entry ?? (fromEnv === undefined || fromEnv === '' ? undefined : fromEnv);
+            if (explicit !== undefined && (await exists(ctx.fs, explicit))) {
+                const confirmed = await check(explicit);
+                if (confirmed !== undefined) {
+                    return { found: true, ...confirmed, dir: dirname(explicit), source: 'explicit', env: pathEnvOf(dirname(explicit)) };
+                }
+            }
+            const root = join(ctx.home, item.target.root, spec.id);
+            try {
+                for (const entry of await ctx.fs.readdir(root)) {
+                    const manifestPath = join(root, entry, 'install.json');
+                    if ((await ctx.fs.stat(manifestPath)) === undefined)
+                        continue;
+                    const manifest = readInstallManifest(decodeJson(await ctx.fs.readFile(manifestPath)), BINARY_ARCHIVE_KIND);
+                    if (manifest === undefined || manifest.version !== spec.version)
+                        continue;
+                    // The manifest's entry is authoritative.
+                    const relative = manifest.entry ?? `bin/${binaryOf(spec, spec.packs[platformKey()])}`;
+                    const executable = join(root, entry, ...relative.split('/'));
+                    if (await exists(ctx.fs, executable)) {
+                        const dir = dirname(executable);
+                        return { found: true, version: spec.version, dir, source: 'managed', env: pathEnvOf(dir) };
+                    }
+                }
+            }
+            catch {
+                // No managed root yet: fall through to PATH.
+            }
+            // A failed PATH candidate does not stop the scan; rejected candidates are reported once.
+            const rejected = [];
+            for (const candidate of await findAllOnPath(binary, ctx.fs)) {
+                const confirmed = await check(candidate);
+                if (confirmed !== undefined) {
+                    if (rejected.length > 0) {
+                        ctx.logger.warn(`PATH 上的 ${rejected.join('、')} 未通过 ${args.join(' ')} 探针，已跳过；改用 ${candidate}`);
+                    }
+                    return { found: true, ...confirmed, dir: dirname(candidate), source: 'system' };
+                }
+                rejected.push(candidate);
+            }
+            if (rejected.length > 0) {
+                ctx.logger.warn(`PATH 上的 ${rejected.join('、')} 均未通过 ${args.join(' ')} 探针；按未安装处理`);
+            }
+            return { found: false };
+        },
+        async install(item, ctx) {
+            const spec = parseSpec(item);
+            const key = platformKey();
+            const pack = spec.packs[key];
+            if (pack === undefined) {
+                throw new ProvisionError('archive/no-platform-pack', `${spec.id}@${spec.version} 没有 ${key} 的 pack`);
+            }
+            const urls = candidateUrls(pack.url, ctx.policy.mirrors?.archive);
+            const { bytes } = await downloadBytes(ctx, urls, `${BINARY_ARCHIVE_KIND}+${spec.id}`, ctx.onProgress);
+            verifySha256(bytes, pack.sha256);
+            const staging = await ctx.stage();
+            const unpack = join(staging, UNPACK_DIR);
+            if ((pack.archive ?? 'tar.gz') === 'zip')
+                await extractZip(bytes, unpack, ctx.fs);
+            else
+                await extractTarGz(bytes, unpack, ctx.fs);
+            const binary = binaryOf(spec, pack);
+            const found = await findBinary(unpack, binary, ctx.fs);
+            if (found === undefined) {
+                throw new ProvisionError('extract/failed', `${spec.id}@${spec.version} 的归档里找不到可执行物 ${binary}`);
+            }
+            const binDir = join(staging, 'bin');
+            await ctx.fs.mkdir(binDir);
+            const target = join(binDir, binary);
+            await ctx.fs.copyFile(found, target);
+            await ctx.fs.chmod(target, 0o755);
+            await ctx.fs.rm(unpack, { recursive: true });
+            const meta = {
+                name: spec.id,
+                version: spec.version,
+                integrity: sriOfSha256(pack.sha256),
+                tarball: pack.url,
+                source: 'installed',
+                entry: `bin/${binary}`,
+                entryDir: 'bin',
+            };
+            return ctx.publish(staging, meta);
+        },
+        async verify(item, resolved, ctx) {
+            const spec = parseSpec(item);
+            // The published entry is the manifest's.
+            const manifest = readInstallManifest(decodeJson(await ctx.fs.readFile(join(resolved.dir, 'install.json'))), BINARY_ARCHIVE_KIND);
+            const entry = manifest?.entry;
+            const path = entry === undefined ? join(resolved.entryDir, binaryOf(spec)) : join(resolved.dir, ...entry.split('/'));
+            if (!(await exists(ctx.fs, path))) {
+                throw new ProvisionError('verify/failed', `归档可执行物不存在：${path}`);
+            }
+            await ctx.fs.chmod(path, 0o755);
+            const args = spec.versionArgs ?? ['--version'];
+            if (args.length === 0)
+                return;
+            const outcome = await runVersionProbe(path, args, { ...(ctx.signal === undefined ? {} : { signal: ctx.signal }) });
+            if (outcome === 'timeout') {
+                // A timeout leaves the binary usable; only a failed probe fails verification.
+                ctx.logger.warn(`${path} 的 ${args.join(' ')} 探针超时；按可用处理`);
+                return;
+            }
+            if (outcome === 'failed') {
+                throw new ProvisionError('verify/failed', `${path} 的 ${args.join(' ')} 探针失败`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=archive.js.map

package/dist/providers/archive.js.map

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

package/dist/providers/model.d.ts

@@ -0,0 +1,25 @@
+import type { Provider } from '../types.js';
+export declare const MODEL_CACHE_KIND = "model-cache";
+/** How an item's files are placed under `target.root`.
+ *  @stable */
+export type ModelCacheLayout = 'hub' | 'flat';
+/** The `spec` of a `model-cache` item. */
+export interface ModelCacheSpec {
+    /** The repo id, e.g. `org/name`; also the resource name. */
+    readonly repo: string;
+    /** Branch/tag/sha; default `main`. */
+    readonly revision?: string;
+    /** File placement; default `hub`. */
+    readonly layout?: ModelCacheLayout;
+    /** Endpoint override; wins over `policy.mirrors.model`. */
+    readonly endpoint?: string;
+    /** Explicit file list; when absent the repository API's `siblings` are used. */
+    readonly files?: readonly string[];
+    /** Extra files that must exist for `verify` to pass. */
+    readonly requiredFiles?: readonly string[];
+}
+/** Build the built-in model-cache provider. */
+export declare function modelCacheProvider(options?: {
+    readonly id?: string;
+}): Provider;
+//# sourceMappingURL=model.d.ts.map

package/dist/providers/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/providers/model.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAGV,QAAQ,EAOT,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAoB7C;cACc;AACd,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAAA;AAY7C,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3C;AA8ZD,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,QAAQ,CAgHnF"}