rn-update-cli 1.0.0

package/lib/utils/dep-versions.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * [INPUT]: 依赖项目 package.json、已安装依赖目录、文件系统与路径解析
+ * [OUTPUT]: 对外提供 getDepVersions、getDepVersion 与惰性 depVersions 代理
+ * [POS]: CLI 运行时版本信息边界，按需读取依赖版本并缓存，供诊断和命令编排消费
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.depVersions = void 0;
+exports.getDepVersions = getDepVersions;
+exports.getDepVersion = getDepVersion;
+// Installed versions of the dependencies/devDependencies of the project in
+// cwd. Resolving them means reading one package.json per dependency, so the
+// full map is built lazily (on first use) and memoized rather than at import
+// time, and the version banner printed by every command asks for the single
+// dependency it needs (`getDepVersion`) instead of the whole map.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+let cachedCwd;
+let cached;
+function readProjectPackageJson(cwd) {
+    try {
+        return JSON.parse(fs_1.default.readFileSync(path_1.default.join(cwd, 'package.json'), 'utf8'));
+    }
+    catch {
+        // no package.json (or not JSON): the project simply declares nothing
+        return null;
+    }
+}
+/** direct dependency names (dependencies + devDependencies), deduplicated */
+function directDependencyNames(pkg) {
+    return [
+        ...new Set([
+            ...Object.keys(pkg.dependencies ?? {}),
+            ...Object.keys(pkg.devDependencies ?? {}),
+        ]),
+    ];
+}
+/**
+ * Version of the installed copy of `dep`: the nearest
+ * `node_modules/<dep>/package.json` from `cwd` upwards, read directly. Not
+ * `require.resolve`: a package whose `exports` map omits package.json makes
+ * it throw, and bun caches its answer per specifier, ignoring `paths`.
+ */
+function readInstalledVersion(dep, cwd) {
+    let dir = path_1.default.resolve(cwd);
+    for (;;) {
+        try {
+            const pkg = JSON.parse(fs_1.default.readFileSync(path_1.default.join(dir, 'node_modules', dep, 'package.json'), 'utf8'));
+            return typeof pkg.version === 'string' ? pkg.version : undefined;
+        }
+        catch {
+            // not installed at this level
+        }
+        const parent = path_1.default.dirname(dir);
+        if (parent === dir) {
+            return undefined;
+        }
+        dir = parent;
+    }
+}
+function readDepVersions(cwd) {
+    const versions = {};
+    const pkg = readProjectPackageJson(cwd);
+    if (pkg) {
+        for (const dep of directDependencyNames(pkg)) {
+            const version = readInstalledVersion(dep, cwd);
+            if (version) {
+                versions[dep] = version;
+            }
+        }
+    }
+    // sorted keys: the object is sent to the server as-is and diffed
+    return Object.keys(versions)
+        .sort()
+        .reduce((obj, key) => {
+        obj[key] = versions[key];
+        return obj;
+    }, {});
+}
+/** Installed versions of the cwd project's dependencies, keys sorted. */
+function getDepVersions() {
+    const cwd = path_1.default.resolve(process.cwd());
+    if (!cached || cachedCwd !== cwd) {
+        cached = readDepVersions(cwd);
+        cachedCwd = cwd;
+    }
+    return cached;
+}
+/**
+ * Installed version of one direct (dev)dependency of the cwd project, or
+ * undefined when the project does not declare it or it is not installed.
+ * Two file reads instead of one per dependency: the version banner printed
+ * before every command must not scale with the size of the project.
+ */
+function getDepVersion(name, cwd = process.cwd()) {
+    const resolvedCwd = path_1.default.resolve(cwd);
+    if (cached && cachedCwd === resolvedCwd) {
+        return cached[name];
+    }
+    const pkg = readProjectPackageJson(resolvedCwd);
+    if (!pkg || !directDependencyNames(pkg).includes(name)) {
+        return undefined;
+    }
+    return readInstalledVersion(name, resolvedCwd);
+}
+/**
+ * Same data as `getDepVersions()` but as a lazily populated object, for the
+ * remaining property-access call sites (`depVersions['react-native']`).
+ * Nothing is resolved until the first property access.
+ */
+exports.depVersions = new Proxy({}, {
+    get: (_target, key) => typeof key === 'string' ? getDepVersions()[key] : undefined,
+    has: (_target, key) => typeof key === 'string' && key in getDepVersions(),
+    ownKeys: () => Object.keys(getDepVersions()),
+    getOwnPropertyDescriptor: (_target, key) => {
+        if (typeof key !== 'string' || !(key in getDepVersions())) {
+            return undefined;
+        }
+        return {
+            value: getDepVersions()[key],
+            writable: false,
+            enumerable: true,
+            configurable: true,
+        };
+    },
+});

package/lib/utils/git.d.ts

@@ -0,0 +1,14 @@
+/**
+ * [INPUT]: 依赖 Git 子进程、回调转 Promise 与当前工作树状态
+ * [OUTPUT]: 对外提供 CommitInfo、getCurrentCommit 与 getCommitInfo
+ * [POS]: CLI 版本元数据适配层，只读取提交信息，不修改仓库状态
+ */
+export interface CommitInfo {
+    hash: string;
+    message: string;
+    author: string;
+    timestamp: string;
+    origin?: string;
+}
+export declare function getCurrentCommit(): string;
+export declare function getCommitInfo(): Promise<CommitInfo | undefined>;

package/lib/utils/git.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * [INPUT]: 依赖 Git 子进程、回调转 Promise 与当前工作树状态
+ * [OUTPUT]: 对外提供 CommitInfo、getCurrentCommit 与 getCommitInfo
+ * [POS]: CLI 版本元数据适配层，只读取提交信息，不修改仓库状态
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentCommit = getCurrentCommit;
+exports.getCommitInfo = getCommitInfo;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execFile = (0, util_1.promisify)(child_process_1.execFile);
+function getCurrentCommit() {
+    const result = (0, child_process_1.spawnSync)('git', ['rev-parse', 'HEAD']);
+    if (result.status !== 0) {
+        throw new Error('Not a git repository');
+    }
+    return result.stdout.toString().trim();
+}
+async function gitOutput(args, cwd = process.cwd()) {
+    const { stdout } = await execFile('git', args, {
+        cwd,
+        encoding: 'utf8',
+        windowsHide: true,
+    });
+    return stdout.trimEnd();
+}
+async function getRemoteOrigin(cwd) {
+    const origin = await gitOutput(['remote', 'get-url', 'origin'], cwd).catch(() => '');
+    if (origin) {
+        return origin;
+    }
+    const remotes = await gitOutput(['remote'], cwd).catch(() => '');
+    const firstRemote = remotes.split(/\r?\n/).find(Boolean);
+    if (!firstRemote) {
+        return undefined;
+    }
+    return gitOutput(['remote', 'get-url', firstRemote], cwd).catch(() => undefined);
+}
+async function getCommitInfo() {
+    try {
+        const gitRoot = await gitOutput(['rev-parse', '--show-toplevel']);
+        // one `git log` for every commit field (NUL-separated, the multi-line
+        // message last) instead of one git process per field
+        const [log, origin] = await Promise.all([
+            gitOutput(['log', '-1', '--format=%H%x00%an%x00%ct%x00%B'], gitRoot),
+            getRemoteOrigin(gitRoot),
+        ]);
+        const [hash, author, timestamp, ...message] = log.split('\0');
+        if (!hash) {
+            return;
+        }
+        return {
+            hash,
+            message: message.join('\0'),
+            author,
+            timestamp,
+            origin,
+        };
+    }
+    catch (_error) {
+        return;
+    }
+}

package/lib/utils/hbcTransform.d.ts

@@ -0,0 +1,111 @@
+/**
+ * [INPUT]: 依赖 Hermes HBC 二进制布局、Buffer/文件句柄与差分字段规则
+ * [OUTPUT]: 对外提供 HBC 布局探测、可逆变换、文件变换、段范围解析及版本元数据能力
+ * [POS]: CLI Hermes delta 优化底座，为 base-bytecode 差分提供确定性字节变换
+ */
+/** 差分字段:条目内 byte 偏移处按小端读 u32,取 [bit, bit+bits) 位。 */
+type DeltaField = {
+    byte: number;
+    bit: number;
+    bits: number;
+};
+type SectionDesc = {
+    name: string;
+    /** 段大小 = header[countField] × entrySize;字节段 entrySize 为 1 */
+    countField: string;
+    entrySize: number;
+    deltaFields?: DeltaField[];
+};
+export type HbcLayout = {
+    minVersion: number;
+    maxVersion: number;
+    /** 头部 u32 计数字段名序列,从文件偏移 32 开始连续排列 */
+    headerFields: string[];
+    /** 各段按文件顺序排列(其后是函数字节码区,以 debugInfoOffset 为界) */
+    sections: SectionDesc[];
+};
+/**
+ * 布局描述表(唯一需要跟随 Hermes 版本演进的数据)。
+ * 字段序照抄 hermes 源码 include/hermes/BCGen/HBC/BytecodeFileFormat.h。
+ * v97 为 Static Hermes 短期预览版本,生产占比为零,不支持(自动回退)。
+ */
+export declare const HBC_LAYOUTS: HbcLayout[];
+/**
+ * 随 patch 下发的 wire 格式(客户端 C 解释器的输入,全数字、无名字):
+ * counts: 头部 u32 计数字段个数(从偏移 32 起连续读取)
+ * sections: [countIndex, entrySize, [[byte, bit, bits], ...]][]
+ *
+ * 位置约定(C 端校验依赖,两端必须一致):
+ * counts 槽位 0 = fileLength,最后一个槽位 = debugInfoOffset。
+ */
+export type HbcLayoutWire = {
+    counts: number;
+    sections: [number, number, [number, number, number][]][];
+};
+export declare function compileLayoutToWire(layout: HbcLayout): HbcLayoutWire;
+export declare function getHbcVersion(buf: Buffer): number | null;
+/** 同一版本号可能有多个候选布局(按声明顺序即优先级)。 */
+export declare function findLayouts(version: number): HbcLayout[];
+/** Byte range of one section of an HBC file (see resolveHbcSections). */
+export type HbcSectionRange = {
+    start: number;
+    size: number;
+};
+/**
+ * Section byte ranges of an HBC file from its 128-byte header and total
+ * length, keyed by section name (arrayBuffer, objKeyBuffer, ... for v87–96;
+ * literalValueBuffer, objShapeTable, ... for v98). Null when no known layout
+ * fits, which callers treat as "cannot read this file structurally".
+ */
+export declare function resolveHbcSections(header: Buffer, fileLength: number): {
+    version: number;
+    sections: Map<string, HbcSectionRange>;
+} | null;
+/**
+ * 对 HBC buffer 执行变换(inverse=false)或逆变换(inverse=true)。
+ * 同一版本号可能存在多个候选布局(如 v98 早/晚两种头部),按声明顺序
+ * 取第一个通过结构校验的。非 HBC / 无可用布局 → 返回 null。
+ * 注意:变换不改动头部计数,同一文件正/逆向解析选中的布局必然一致。
+ */
+export declare function transformHbc(buf: Buffer, inverse?: boolean): Buffer | null;
+/** 返回该 buffer 结构上匹配的布局(候选中第一个校验通过者)。 */
+export declare function pickLayout(buf: Buffer): HbcLayout | null;
+export declare function transformHbcWithLayout(buf: Buffer, layout: HbcLayout, inverse: boolean): Buffer | null;
+/**
+ * 原地变换:直接改写 buf,不再分配整块副本。调用方须持有 buf 的所有权
+ * (例如 patch() 刚返回的新 Buffer)。结构不匹配时返回 false 且 buf 不变。
+ */
+export declare function transformHbcWithLayoutInPlace(buf: Buffer, layout: HbcLayout, inverse: boolean): boolean;
+/**
+ * 文件版 transformHbcWithLayout:把 src 复制到 dst,再仅对含差分字段的
+ * 段(位于 [128, 最后一段末尾) 区间内)做定位读写改写。任一时刻内存中
+ * 只有一个段的内容,不会持有整个 bundle。输出与内存版逐字节一致。
+ * 结构不匹配时返回 false 并清理 dst。
+ */
+export declare function transformHbcFile(src: string, dst: string, layout: HbcLayout, inverse: boolean): Promise<boolean>;
+export declare const HBC_TRANSFORM_VERSION = 1;
+export type HbcTransformMeta = {
+    v: number;
+    hbcVersion: number;
+    layout: HbcLayoutWire;
+};
+/**
+ * 若 old/new 均为同版本且存在两侧都通过结构校验的候选布局,返回变换结果、
+ * 选中布局与写入 __diff.json 的元数据;否则返回 null。
+ */
+export declare function tryTransformPair(oldBuf: Buffer, newBuf: Buffer): {
+    tOld: Buffer;
+    tNew: Buffer;
+    layout: HbcLayout;
+    meta: HbcTransformMeta;
+} | null;
+/**
+ * tryTransformPair 的文件版:只读两侧头部即可选定布局,变换结果直接写到
+ * tOldPath / tNewPath,全程不把 bundle 读进内存。无可用布局时返回 null
+ * (不产生输出文件)。
+ */
+export declare function tryTransformPairFiles(oldPath: string, newPath: string, tOldPath: string, tNewPath: string): Promise<{
+    layout: HbcLayout;
+    meta: HbcTransformMeta;
+} | null>;
+export {};