rn-update-cli 1.0.0

package/lib/app.d.ts

@@ -0,0 +1,107 @@
+import type { ServiceChannel } from './api';
+import type { Platform } from './types';
+interface AppSummary {
+    id: string | number;
+    name: string;
+    platform: Platform;
+}
+export interface AppTargetOptions {
+    appId?: string;
+    config?: string;
+    platform?: Platform | '';
+}
+export interface ResolvedChannel {
+    channel: ServiceChannel;
+    created: boolean;
+}
+/** The selected-app config file was missing or has no entry for the platform. */
+export declare class AppNotSelectedError extends Error {
+    readonly code = "APP_NOT_SELECTED";
+    constructor(platform: Platform);
+}
+/** Resolve an explicit platform or prompt for one interactively. */
+export declare function getPlatform(platform?: string): Promise<Platform>;
+/** Validate that a string names a platform supported by the update service. */
+export declare function assertPlatform(platform: string): Platform;
+/** Read the selected app for a platform from the requested config file. */
+export declare function getSelectedApp(platform: Platform, configPath?: string): Promise<{
+    appId: string;
+    appKey: string;
+    platform: Platform;
+}>;
+/** Resolve a standalone channel and create it on first use when absent. */
+export declare function getOrCreateChannel(appId: string, code: string): Promise<ResolvedChannel>;
+/**
+ * Resolve the app an operation targets: an explicit `--appId` wins, otherwise
+ * the app selected for the platform in `--config` (default: update.json).
+ * Prompts for the platform only when it is needed and not given.
+ */
+export declare function resolveAppId(options?: AppTargetOptions): Promise<string>;
+/** List apps, optionally filtering them to one platform. */
+export declare function listApp(platform?: Platform | ''): Promise<AppSummary[]>;
+/** Prompt until the user chooses an app belonging to the target platform. */
+export declare function chooseApp(platform: Platform): Promise<AppSummary>;
+/** Persist an app selection in the requested brand-aware config file. */
+declare function selectApp({ args, options, }: {
+    args: string[];
+    options: {
+        platform?: Platform | '';
+        config?: string;
+    };
+}): Promise<void>;
+/** Build the application-management command handlers used by the CLI. */
+export declare function getAppCommands(): {
+    /** Create an app and select it in the same configuration file. */
+    createApp: ({ options, }: {
+        options: {
+            name: string;
+            downloadUrl: string;
+            platform?: Platform | '';
+            config?: string;
+        };
+    }) => Promise<void>;
+    /** Delete the specified app, or prompt for one when no ID is supplied. */
+    deleteApp: ({ args, options, }: {
+        args: string[];
+        options: {
+            platform: Platform;
+        };
+    }) => Promise<void>;
+    /** List apps through the command interface. */
+    apps: ({ options }: {
+        options: {
+            platform?: Platform | '';
+        };
+    }) => Promise<AppSummary[]>;
+    /** List channels without exposing service-internal UUIDs as input. */
+    channels: ({ options }: {
+        options: AppTargetOptions & {
+            json?: boolean;
+        };
+    }) => Promise<ServiceChannel[]>;
+    /** Create a channel; the default channel is created with the application. */
+    createChannel: ({ options }: {
+        options: AppTargetOptions & {
+            code: string;
+            name: string;
+            nativePackageUrl?: string;
+            paused?: boolean;
+            json?: boolean;
+        };
+    }) => Promise<any>;
+    updateChannel: ({ args, options }: {
+        args: string[];
+        options: AppTargetOptions & {
+            code: string;
+            name: string;
+            nativePackageUrl?: string;
+            paused?: boolean;
+            json?: boolean;
+        };
+    }) => Promise<any>;
+    deleteChannel: ({ args }: {
+        args: string[];
+    }) => Promise<void>;
+    selectApp: typeof selectApp;
+};
+export {};

package/lib/app.js

@@ -0,0 +1,329 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppNotSelectedError = void 0;
+exports.getPlatform = getPlatform;
+exports.assertPlatform = assertPlatform;
+exports.getSelectedApp = getSelectedApp;
+exports.getOrCreateChannel = getOrCreateChannel;
+exports.resolveAppId = resolveAppId;
+exports.listApp = listApp;
+exports.chooseApp = chooseApp;
+exports.getAppCommands = getAppCommands;
+/**
+ * [INPUT]: 依赖 CLI API、update.json 配置和平台交互提示
+ * [OUTPUT]: 对外提供应用选择、应用 CRUD、独立服务渠道 CRUD 与缺失渠道幂等创建
+ * [POS]: CLI 目标解析层，负责把平台/应用/渠道身份收敛为服务端 UUID，并为发布命令补齐渠道
+ */
+const fs_1 = __importDefault(require("fs"));
+const api_1 = require("./api");
+const utils_1 = require("./utils");
+const constants_1 = require("./utils/constants");
+const http_helper_1 = require("./utils/http-helper");
+const i18n_1 = require("./utils/i18n");
+/** The selected-app config file was missing or has no entry for the platform. */
+class AppNotSelectedError extends Error {
+    code = 'APP_NOT_SELECTED';
+    constructor(platform) {
+        super((0, i18n_1.t)('appNotSelected', { platform }));
+        this.name = 'AppNotSelectedError';
+    }
+}
+exports.AppNotSelectedError = AppNotSelectedError;
+/** Resolve an explicit platform or prompt for one interactively. */
+async function getPlatform(platform) {
+    return assertPlatform(platform || (await (0, utils_1.question)((0, i18n_1.t)('platformQuestion'))));
+}
+/** Validate that a string names a platform supported by the update service. */
+function assertPlatform(platform) {
+    if (platform !== 'ios' && platform !== 'android' && platform !== 'harmony') {
+        throw new Error((0, i18n_1.t)('unsupportedPlatform', { platform }));
+    }
+    return platform;
+}
+/** Parse a legacy positive integer or an RFC 9562 UUID used by standalone services. */
+function parseAppId(value) {
+    if ((0, http_helper_1.isStandaloneService)() && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value)) {
+        return value;
+    }
+    const id = Number(value);
+    if (!/^[1-9]\d*$/.test(value) || !Number.isSafeInteger(id)) {
+        throw new Error((0, i18n_1.t)('invalidId', { id: value }));
+    }
+    return String(id);
+}
+/** Read the selected app for a platform from the requested config file. */
+async function getSelectedApp(platform, configPath) {
+    assertPlatform(platform);
+    const resolvedConfigPath = configPath || constants_1.updateJson;
+    let raw;
+    try {
+        raw = await fs_1.default.promises.readFile(resolvedConfigPath, 'utf8');
+    }
+    catch (e) {
+        if (e.code === 'ENOENT') {
+            throw new AppNotSelectedError(platform);
+        }
+        throw e;
+    }
+    let updateInfo;
+    try {
+        updateInfo = JSON.parse(raw);
+    }
+    catch {
+        throw new Error((0, i18n_1.t)('failedToParseUpdateJson', { configPath: resolvedConfigPath }));
+    }
+    const info = updateInfo[platform];
+    if (!info) {
+        throw new AppNotSelectedError(platform);
+    }
+    return {
+        appId: String(info.appId),
+        appKey: info.appKey,
+        platform,
+    };
+}
+/** Resolve a standalone channel and create it on first use when absent. */
+async function getOrCreateChannel(appId, code) {
+    const normalizedCode = code.trim().toLowerCase();
+    if (!normalizedCode) {
+        throw new Error('渠道 code 不能为空。');
+    }
+    const findChannel = (channels) => channels.find((channel) => channel.code.trim().toLowerCase() === normalizedCode);
+    const existing = findChannel(await (0, api_1.getChannels)(appId));
+    if (existing) {
+        return { channel: existing, created: false };
+    }
+    try {
+        return {
+            channel: await (0, api_1.createChannel)(appId, normalizedCode, normalizedCode),
+            created: true,
+        };
+    }
+    catch (error) {
+        // Two CLI processes may race to create the same channel. Re-read before
+        // surfacing the original failure so the loser remains idempotent.
+        try {
+            const concurrent = findChannel(await (0, api_1.getChannels)(appId));
+            if (concurrent) {
+                return { channel: concurrent, created: false };
+            }
+        }
+        catch {
+            // Preserve the original create error when the recovery lookup fails.
+        }
+        throw error;
+    }
+}
+/**
+ * Fail fast when an explicit `--appId` names an app of another platform.
+ * The server accepts a bundle for any app the account owns and never sees
+ * the platform it was built for, so this is the only place the mistake can
+ * be caught before it reaches devices. A missing or foreign app fails here
+ * too (403/404) instead of after the expensive work.
+ */
+async function assertAppPlatform(appId, platform) {
+    const app = (0, api_1.unwrapData)(await (0, api_1.get)((0, http_helper_1.isStandaloneService)() ? (0, api_1.servicePath)(`/apps/${encodeURIComponent(appId)}`) : `/app/${appId}`));
+    if (app.platform && app.platform !== platform) {
+        throw new Error((0, i18n_1.t)('appPlatformMismatch', { appId, appPlatform: app.platform, platform }));
+    }
+    return app;
+}
+/**
+ * Resolve the app an operation targets: an explicit `--appId` wins, otherwise
+ * the app selected for the platform in `--config` (default: update.json).
+ * Prompts for the platform only when it is needed and not given.
+ */
+async function resolveAppId(options = {}) {
+    if (options.platform) {
+        assertPlatform(options.platform);
+    }
+    if (options.appId) {
+        const appId = String(options.appId);
+        if (options.platform) {
+            await assertAppPlatform(appId, options.platform);
+        }
+        return appId;
+    }
+    const platform = await getPlatform(options.platform || undefined);
+    return (await getSelectedApp(platform, options.config)).appId;
+}
+/** List apps, optionally filtering them to one platform. */
+async function listApp(platform = '') {
+    const response = await (0, api_1.get)((0, http_helper_1.isStandaloneService)()
+        ? (0, api_1.servicePath)('/apps?page=1&pageSize=100')
+        : '/app/list');
+    const page = (0, api_1.unwrapData)(response);
+    const allApps = (0, http_helper_1.isStandaloneService)()
+        ? (page?.items ?? [])
+        : (response?.data ?? []);
+    const list = platform
+        ? allApps.filter((app) => app.platform === platform)
+        : allApps;
+    const header = [
+        { value: (0, i18n_1.t)('appId') },
+        { value: (0, i18n_1.t)('appName') },
+        { value: (0, i18n_1.t)('platform') },
+    ];
+    const rows = [];
+    for (const app of list) {
+        rows.push([app.id, app.name, app.platform]);
+    }
+    // tty-table is ~25 ms to load; only pay for it when a table is rendered
+    const Table = (0, utils_1.loadTtyTable)();
+    console.log(Table(header, rows).render());
+    console.log(`\n${(0, i18n_1.t)('totalApps', { count: list.length, platform })}`);
+    return list;
+}
+/** Prompt until the user chooses an app belonging to the target platform. */
+async function chooseApp(platform) {
+    // Fail before a network request or table output when no prompt is possible.
+    if ((0, utils_1.isNonInteractive)()) {
+        throw new Error((0, i18n_1.t)('appIdRequired'));
+    }
+    const list = await listApp(platform);
+    while (true) {
+        const id = await (0, utils_1.question)((0, i18n_1.t)('enterAppIdQuestion'));
+        const app = list.find((item) => String(item.id) === id);
+        if (app) {
+            return app;
+        }
+    }
+}
+/** Persist an app selection in the requested brand-aware config file. */
+async function selectApp({ args, options, }) {
+    const platform = await getPlatform(options.platform);
+    const id = args[0]
+        ? parseAppId(args[0])
+        : (await chooseApp(platform)).id;
+    if (!id) {
+        throw new Error((0, i18n_1.t)('invalidId', { id: args[0] }));
+    }
+    const app = await assertAppPlatform(String(id), platform);
+    if (typeof app.appKey !== 'string' || !app.appKey) {
+        throw new Error((0, i18n_1.t)('appKeyMissing', { appId: id }));
+    }
+    const appKey = app.appKey;
+    const configPath = options.config || constants_1.updateJson;
+    let updateInfo = {};
+    try {
+        updateInfo = JSON.parse(await fs_1.default.promises.readFile(configPath, 'utf8'));
+    }
+    catch (e) {
+        if (e.code !== 'ENOENT') {
+            console.error((0, i18n_1.t)('failedToParseUpdateJson', { configPath }));
+            throw e;
+        }
+    }
+    updateInfo[platform] = {
+        // 遗留服务沿用数字 appId 的历史契约；独立服务才可能写入 UUID。
+        appId: /^[1-9]\d*$/.test(String(id)) ? Number(id) : id,
+        appKey,
+    };
+    await fs_1.default.promises.writeFile(configPath, JSON.stringify(updateInfo, null, 4), 'utf8');
+}
+/** Build the application-management command handlers used by the CLI. */
+function getAppCommands() {
+    return {
+        /** Create an app and select it in the same configuration file. */
+        createApp: async ({ options, }) => {
+            const name = options.name || (await (0, utils_1.question)((0, i18n_1.t)('appNameQuestion')));
+            const { downloadUrl } = options;
+            const platform = await getPlatform(options.platform);
+            const created = (0, api_1.unwrapData)(await (0, api_1.post)((0, http_helper_1.isStandaloneService)() ? (0, api_1.servicePath)('/apps') : '/app/create', (0, http_helper_1.isStandaloneService)()
+                ? {
+                    name,
+                    platform,
+                    ...(downloadUrl ? { nativePackageUrl: downloadUrl } : {}),
+                }
+                : { name, platform, downloadUrl }));
+            const { id } = created;
+            console.log((0, i18n_1.t)('createAppSuccess', { id }));
+            await selectApp({
+                args: [String(id)],
+                options: { platform, config: options.config },
+            });
+        },
+        /** Delete the specified app, or prompt for one when no ID is supplied. */
+        deleteApp: async ({ args, options, }) => {
+            const { platform } = options;
+            const id = args[0]
+                ? parseAppId(args[0])
+                : (await chooseApp(platform)).id;
+            if (!id) {
+                console.log((0, i18n_1.t)('cancelled'));
+                return;
+            }
+            await (0, api_1.doDelete)((0, http_helper_1.isStandaloneService)()
+                ? (0, api_1.servicePath)(`/apps/${encodeURIComponent(String(id))}`)
+                : `/app/${id}`);
+            console.log((0, i18n_1.t)('operationSuccess'));
+        },
+        /** List apps through the command interface. */
+        apps: async ({ options }) => {
+            const { platform = '' } = options;
+            return listApp(platform);
+        },
+        /** List channels without exposing service-internal UUIDs as input. */
+        channels: async ({ options }) => {
+            const appId = await resolveAppId(options);
+            if (!(0, http_helper_1.isStandaloneService)()) {
+                throw new Error('渠道管理需要独立服务（请设置 RNU_SERVICE_URL）。');
+            }
+            const channels = await (0, api_1.getChannels)(appId);
+            if (options.json) {
+                console.log(JSON.stringify(channels, null, 2));
+            }
+            else {
+                for (const channel of channels) {
+                    console.log(`${channel.code}\t${channel.name}\t${channel.id}${channel.paused ? '\tpaused' : ''}`);
+                }
+            }
+            return channels;
+        },
+        /** Create a channel; the default channel is created with the application. */
+        createChannel: async ({ options }) => {
+            const appId = await resolveAppId(options);
+            if (!(0, http_helper_1.isStandaloneService)()) {
+                throw new Error('渠道管理需要独立服务（请设置 RNU_SERVICE_URL）。');
+            }
+            const channel = (0, api_1.unwrapData)(await (0, api_1.post)((0, api_1.servicePath)(`/apps/${encodeURIComponent(appId)}/channels`), {
+                code: options.code,
+                name: options.name,
+                nativePackageUrl: options.nativePackageUrl || '',
+                paused: Boolean(options.paused),
+            }));
+            console.log(options.json ? JSON.stringify(channel, null, 2) : `已创建渠道 ${options.code}`);
+            return channel;
+        },
+        updateChannel: async ({ args, options }) => {
+            const channelId = args[0];
+            if (!channelId)
+                throw new Error('updateChannel 需要 channelId。');
+            if (!(0, http_helper_1.isStandaloneService)()) {
+                throw new Error('渠道管理需要独立服务（请设置 RNU_SERVICE_URL）。');
+            }
+            const channel = (0, api_1.unwrapData)(await (0, api_1.put)((0, api_1.servicePath)(`/channels/${encodeURIComponent(channelId)}`), {
+                code: options.code,
+                name: options.name,
+                nativePackageUrl: options.nativePackageUrl || '',
+                paused: Boolean(options.paused),
+            }));
+            console.log(options.json ? JSON.stringify(channel, null, 2) : `已更新渠道 ${channelId}`);
+            return channel;
+        },
+        deleteChannel: async ({ args }) => {
+            const channelId = args[0];
+            if (!channelId)
+                throw new Error('deleteChannel 需要 channelId。');
+            if (!(0, http_helper_1.isStandaloneService)()) {
+                throw new Error('渠道管理需要独立服务（请设置 RNU_SERVICE_URL）。');
+            }
+            await (0, api_1.doDelete)((0, api_1.servicePath)(`/channels/${encodeURIComponent(channelId)}`));
+            console.log((0, i18n_1.t)('operationSuccess'));
+        },
+        selectApp,
+    };
+}

package/lib/auto-update.d.ts

@@ -0,0 +1,35 @@
+/**
+ * [INPUT]: 依赖 Node 子进程、文件系统、环境变量、全局包管理器布局与本地化文案
+ * [OUTPUT]: 对外提供 PackageManager、AutoUpdateNotice、全局包管理器探测及后台更新编排
+ * [POS]: CLI 后台自更新边界，负责包管理器归属、锁与失败重试，不参与前台命令分发
+ */
+export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+export interface AutoUpdateNotice {
+    kind: 'updated' | 'permission';
+    currentVersion: string;
+    targetVersion: string;
+    command?: string;
+}
+interface PackageManagerDetectionOptions {
+    packageRoot: string;
+    env?: NodeJS.ProcessEnv;
+    npmGlobalDir?: string;
+    yarnGlobalDir?: string;
+}
+/**
+ * Identify the package manager that owns this global installation. Project
+ * lockfiles are deliberately ignored: they say how the app is installed, not
+ * how this CLI was installed.
+ */
+export declare function detectGlobalPackageManager({ packageRoot, env, npmGlobalDir, yarnGlobalDir, }: PackageManagerDetectionOptions): PackageManager | undefined;
+export declare function buildUpdateCommand(manager: PackageManager, targetVersion: string, registryUrl: string, installPrefix?: string): {
+    command: string;
+    args: string[];
+};
+/**
+ * Start a detached updater after the foreground command has completed. This
+ * function is synchronous on purpose: it is safe to call from process.exit.
+ */
+export declare function launchAutoUpdate(currentVersion: string, targetVersion: string | undefined, env?: NodeJS.ProcessEnv): boolean;
+export declare function consumeAutoUpdateNotice(currentVersion: string): AutoUpdateNotice | undefined;
+export {};