@leonxin/meetgames 0.1.17 → 0.1.19

package/src/cli.ts

@@ -63,7 +63,6 @@ interface Parsed {
   topsdkPackageName: string;
   appTarget: string;
   sdkHomeApiBaseUrl: string;
-  iosSdkPlugins: string;
   iosSdkPackageType: string;
 }
 
@@ -74,7 +73,7 @@ meetgames — Android-first integration CLI (TypeScript)
 Usage:
   meetgames integrate [--project-root <path>] [--app-id ID] [--channel-type TYPE] [--env prod|pre|test] [--app-target <target>] [--dry-run] [--verbose] [--patch-file <path>]
   meetgames fetch-config [--app-id ID] [--app-secret SECRET] [--channel-type TYPE] [--env prod|pre|test] [--project-root <path>] [--verbose]
-  meetgames download-ios-sdk [--plugins csv] [--package-type native|unity|cocos] [--sdk-api-base-url URL] [--verbose]
+  meetgames download-ios-sdk [--project-root <path>] [--app-id ID] [--channel-type TYPE] [--env prod|pre|test] [--package-type native|unity|cocos] [--sdk-api-base-url URL] [--verbose]
   meetgames setup [--app-id ID] [--app-secret SECRET] [--channel-type TYPE] [--env prod|pre|test] [--project-root <path>] [--app-target <target>] [--dry-run] [--verbose] [--patch-file <path>]
   meetgames doctor [--app-id ID] [--app-secret SECRET] [--channel-type TYPE] [--env prod|pre|test] --project-root <path> [--app-target <target>] [--verbose]
 
@@ -87,8 +86,8 @@ Notes:
   - doctor first fetches downloadSDKConfig to the cache, then validates the detected platform integration.
   - integrate uses recipes/integrate-default.yaml, filtered to the detected platform before execution.
   - iOS SDK is read from ${MEET_SDK_TOOL_CACHE_ROOT}/sdk/ios/.
-  - Android integrate/doctor reads the latest SDK version from sdk-home and stores it in config/meetsdk-android.json.
-  - download-ios-sdk calls sdk-home getDownLoadUrl, saves and extracts the iOS SDK under ${MEET_SDK_TOOL_CACHE_ROOT}/sdk/ios/.
+  - Android integrate/doctor reads latest SDK config from sdk-home and stores it under ${MEET_SDK_TOOL_CACHE_ROOT}/configs/sdk-home/.
+  - download-ios-sdk reads an iOS meetsdk-remote-config.json, derives sdk-home plugins from it, then calls sdk-home getDownLoadUrl and extracts the iOS SDK under ${MEET_SDK_TOOL_CACHE_ROOT}/sdk/ios/.
   - fetch-config requires --app-secret (or TOPSDK_APP_SECRET) to sign downloadSDKConfig; appSecret is never read from meetsdk-remote-config.json.
   - When analytics.firebase is enabled, Android downloads google-services.json to the detected/selected app module; iOS downloads GoogleService-Info.plist next to Info.plist.
   - fetch-config writes to ${MEET_SDK_TOOL_CACHE_ROOT}/configs/<env>/<appId>/<channelType>/meetsdk-remote-config.json.
@@ -105,11 +104,10 @@ Options (global where noted):
   TOPSDK_API_BASE_URL   fetch-config: 覆盖 API 根地址（如 http://localhost:18080/ 联调本机 console）
   MEETGAMES_SDK_HOME_API_BASE_URL  覆盖 sdk-home API 根地址（默认 https://business-api.meetgames.com）；用于 Android 最新版本查询和 iOS SDK 下载
   --sdk-api-base-url    sdk-home API 根地址；用于 Android 最新版本查询和 iOS SDK 下载
-  --plugins             download-ios-sdk: 逗号分隔插件列表；默认与下载页 iOS 默认选择一致
   --package-type        download-ios-sdk: native（默认）| unity | cocos
   --dry-run             integrate: compute changes and patch preview without writing host project files (default is write to disk)
   --report-file         Write JSON report to path
-  --patch-file          integrate: write unified diff to this path (works with --dry-run). If under <pkg>/preview-patches/, all existing files in that dir are removed first so only the latest patch remains.
+  --patch-file          integrate: write unified diff to this path (works with --dry-run). If under <pkg>/fixtures/expected-patches/, all existing files in that dir are removed first so only the latest patch remains.
   --verbose             Verbose logs and full patch preview
 
 Subcommand notes:
@@ -136,7 +134,6 @@ function parseArgv(argv: string[]): Parsed {
     topsdkPackageName: "",
     appTarget: "",
     sdkHomeApiBaseUrl: "",
-    iosSdkPlugins: "",
     iosSdkPackageType: "",
   };
   const rest = argv.slice(2);
@@ -179,12 +176,6 @@ function parseArgv(argv: string[]): Parsed {
       i += 1;
       continue;
     }
-    if (t === "--plugins") {
-      out.iosSdkPlugins = rest[i + 1] ?? "";
-      if (!out.iosSdkPlugins || out.iosSdkPlugins.startsWith("-")) fail("--plugins requires a comma-separated list", EXIT.INVALID_ARGS);
-      i += 1;
-      continue;
-    }
     if (t === "--package-type") {
       out.iosSdkPackageType = rest[i + 1] ?? "";
       if (!out.iosSdkPackageType || out.iosSdkPackageType.startsWith("-")) {
@@ -285,7 +276,7 @@ function readLocalMeetSdkRemoteConfig(configPath: string): MeetSdkRemoteConfig |
   }
 }
 
-async function cmdFetchConfig(parsed: Parsed): Promise<void> {
+async function cmdFetchConfig(parsed: Parsed): Promise<string> {
   const selectedConfigPath = cachedRemoteConfigPathFromArgs(parsed);
   const localConfig = selectedConfigPath ? readLocalMeetSdkRemoteConfig(selectedConfigPath) : null;
 
@@ -348,6 +339,7 @@ async function cmdFetchConfig(parsed: Parsed): Promise<void> {
     console.log(`[meetgames] GET ${requestUrl}`);
     console.log(`[meetgames] metadata: ${written.metadataPath}`);
   }
+  return written.configPath;
 }
 
 async function cmdIntegrate(parsed: Parsed): Promise<void> {
@@ -394,38 +386,47 @@ async function cmdIntegrate(parsed: Parsed): Promise<void> {
 async function cmdSetup(parsed: Parsed): Promise<void> {
   const { platform } = selectedPlatformContext(parsed);
   console.log("[meetgames] setup: fetching remote config…");
-  await cmdFetchConfig(parsed);
+  const configPath = await cmdFetchConfig(parsed);
   if (platform === "ios") {
     console.log("[meetgames] setup: ensuring iOS SDK cache…");
-    await cmdDownloadIosSdk(parsed);
+    await cmdDownloadIosSdk(parsed, configPath);
   }
   console.log("[meetgames] setup: integrating project…");
   await cmdIntegrate(parsed);
 }
 
-async function cmdDownloadIosSdk(parsed: Parsed): Promise<void> {
+function resolveIosDownloadRemoteConfigPath(parsed: Parsed, explicitPath?: string): string {
+  const candidates = [
+    explicitPath,
+    cachedRemoteConfigPathFromArgs(parsed),
+    path.join(parsed.projectRoot, MEETSDK_REMOTE_CONFIG_FILENAME),
+  ]
+    .filter((p): p is string => Boolean(p))
+    .filter((p, i, arr) => arr.indexOf(p) === i);
+  const found = candidates.find((p) => fs.existsSync(p));
+  if (found) return found;
+  fail(
+    `download-ios-sdk requires an iOS ${MEETSDK_REMOTE_CONFIG_FILENAME}; checked: ${candidates.join(", ")}`,
+    EXIT.CONFIG_ERROR
+  );
+}
+
+async function cmdDownloadIosSdk(parsed: Parsed, remoteConfigPath?: string): Promise<void> {
   const baseUrl =
     parsed.sdkHomeApiBaseUrl || process.env.MEETGAMES_SDK_HOME_API_BASE_URL?.trim() || defaultSdkHomeApiBaseUrl;
   const packageType = parsed.iosSdkPackageType || DEFAULT_IOS_SDK_PACKAGE_TYPE;
   if (!["native", "unity", "cocos"].includes(packageType)) {
     fail(`invalid --package-type (use native, unity, or cocos): ${packageType}`, EXIT.INVALID_ARGS);
   }
-  const plugins = parsed.iosSdkPlugins
-    ? parsed.iosSdkPlugins
-        .split(",")
-        .map((s) => s.trim())
-        .filter(Boolean)
-    : undefined;
-  if (parsed.iosSdkPlugins && !plugins?.length) {
-    fail("--plugins must contain at least one plugin", EXIT.INVALID_ARGS);
-  }
+  const configPath = resolveIosDownloadRemoteConfigPath(parsed, remoteConfigPath);
 
+  console.log(`[meetgames] download-ios-sdk: using remote config ${configPath}`);
   console.log("[meetgames] download-ios-sdk: resolving sdk-home iOS SDK…");
   let result;
   try {
     result = await downloadIosSdkToBundled(resolvePackageRoot(), {
       baseUrl,
-      plugins,
+      remoteConfigPath: configPath,
       packageType,
     });
   } catch (e) {

package/src/config/meetSdkDefaultConfig.ts

@@ -1,42 +1,159 @@
 import fs from "node:fs";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { tryParseAsMeetSdkDefaultConfig, type MeetSdkDefaultConfig } from "./meetSdkRemoteConfig.js";
-import { defaultSdkHomeApiBaseUrl, fetchSdkHomeVersions, type SdkHomePlatformVersion } from "../remote/sdkHomeDownload.js";
+import {
+  MEETSDK_ANDROID_CONFIG_FILENAME,
+  resolveAndroidSdkCacheLayout,
+  resolveMeetSdkAndroidConfigCachePath,
+  withCacheLock,
+} from "../cache.js";
+import {
+  buildSdkHomeDownloadUrl,
+  defaultSdkHomeApiBaseUrl,
+  downloadBinaryFile,
+  extractZip,
+  fetchSdkHomeVersions,
+  type SdkHomePlatformVersion,
+} from "../remote/sdkHomeDownload.js";
+import {
+  DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES,
+  tryParseAsMeetSdkDefaultConfig,
+  type MeetSdkDefaultConfig,
+} from "./meetSdkRemoteConfig.js";
 
-/** Built-in Android SDK defaults (repos and per-plugin dependencies). */
-export const MEETSDK_ANDROID_DEFAULTS_FILENAME = "meetsdk-android.json";
-const MEETSDK_CONFIG_DIR = "config";
+const DEFAULT_GROUP_ID = "com.sino.topsdk";
+const DEFAULT_ANDROID_SDK_PACKAGE_TYPE = "native";
 
-const defaultConfigPath = fileURLToPath(
-  new URL(`../../${MEETSDK_CONFIG_DIR}/${MEETSDK_ANDROID_DEFAULTS_FILENAME}`, import.meta.url)
-);
+type JsonRecord = Record<string, unknown>;
 
-export function resolveMeetSdkAndroidConfigPath(packageRoot?: string): string {
-  return packageRoot ? path.join(packageRoot, MEETSDK_CONFIG_DIR, MEETSDK_ANDROID_DEFAULTS_FILENAME) : defaultConfigPath;
+function isRecord(value: unknown): value is JsonRecord {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-export function loadBuiltInMeetSdkDefaultConfig(options: { packageRoot?: string } = {}): MeetSdkDefaultConfig {
-  const configPath = resolveMeetSdkAndroidConfigPath(options.packageRoot);
-  if (!fs.existsSync(configPath)) {
-    throw new Error(
-      `built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} not found at ${configPath}; reinstall @leonxin/meetgames or run from a complete package install`
-    );
+function cloneDefaultConfig(value: MeetSdkDefaultConfig): MeetSdkDefaultConfig {
+  return JSON.parse(JSON.stringify(value)) as MeetSdkDefaultConfig;
+}
+
+function resolveSdkHomeApiBaseUrl(baseUrl?: string): string {
+  return baseUrl || process.env.MEETGAMES_SDK_HOME_API_BASE_URL?.trim() || defaultSdkHomeApiBaseUrl;
+}
+
+function parseJsonResponseEnvelope(body: unknown, label: string): unknown {
+  if (!isRecord(body)) throw new Error(`${label} response is not an object`);
+  const code = body.code;
+  if (code !== undefined && Number(code) !== 200) {
+    const message = typeof body.message === "string" ? body.message : JSON.stringify(body);
+    throw new Error(`${label} API error (code=${String(code)}): ${message}`);
   }
-  const raw = JSON.parse(fs.readFileSync(configPath, "utf8")) as unknown;
-  const parsed = tryParseAsMeetSdkDefaultConfig(raw);
+  return "data" in body ? body.data : body;
+}
+
+async function fetchJson(url: string, signal?: AbortSignal): Promise<unknown> {
+  let res: Response;
+  try {
+    res = await fetch(url, { redirect: "follow", signal, headers: { Accept: "application/json" } });
+  } catch (e) {
+    const cause = e instanceof Error && "cause" in e && e.cause instanceof Error ? e.cause.message : null;
+    const detail = cause && cause !== (e instanceof Error ? e.message : String(e)) ? ` (${cause})` : "";
+    throw new Error(`GET ${url} failed: ${e instanceof Error ? e.message : String(e)}${detail}`);
+  }
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    const detail = text.trim() ? `: ${text.trim().slice(0, 1000)}` : "";
+    throw new Error(`GET ${url} failed: HTTP ${res.status}${detail}`);
+  }
+  const text = await res.text();
+  try {
+    return JSON.parse(text) as unknown;
+  } catch {
+    throw new Error(`GET ${url} did not return valid JSON`);
+  }
+}
+
+export function resolveMeetSdkAndroidConfigPath(cacheRoot?: string): string {
+  return resolveMeetSdkAndroidConfigCachePath(cacheRoot);
+}
+
+function readMeetSdkDefaultConfigFromPath(configPath: string): MeetSdkDefaultConfig {
+  const parsed = tryParseAsMeetSdkDefaultConfig(JSON.parse(fs.readFileSync(configPath, "utf8")) as unknown);
   if (!parsed) {
-    throw new Error(`built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} is not a valid MeetSdk default config`);
+    throw new Error(`${MEETSDK_ANDROID_CONFIG_FILENAME} is not a valid MeetSdk default config: ${configPath}`);
   }
   return parsed;
 }
 
-function cloneDefaultConfig(value: MeetSdkDefaultConfig): MeetSdkDefaultConfig {
-  return JSON.parse(JSON.stringify(value)) as MeetSdkDefaultConfig;
+export function loadBuiltInMeetSdkDefaultConfig(options: { cacheRoot?: string; packageRoot?: string } = {}): MeetSdkDefaultConfig {
+  const cachePath = resolveMeetSdkAndroidConfigPath(options.cacheRoot);
+  if (fs.existsSync(cachePath)) return readMeetSdkDefaultConfigFromPath(cachePath);
+  return compatibilityDefaultConfig();
 }
 
-function resolveSdkHomeApiBaseUrl(baseUrl?: string): string {
-  return baseUrl || process.env.MEETGAMES_SDK_HOME_API_BASE_URL?.trim() || defaultSdkHomeApiBaseUrl;
+function compatibilityDefaultConfig(): MeetSdkDefaultConfig {
+  const raw = {
+    topsdk: {
+      version: "",
+      groupId: DEFAULT_GROUP_ID,
+      repositories: ["https://storage-sdk-gameplus.meetsocial.com/repository/TopSdk/"],
+    },
+    sdkModules: {
+      login: {
+        guest: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.guest] },
+        email: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.email] },
+        apple: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.apple] },
+        facebook: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.facebook] },
+        google: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.google] },
+        twitter: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.twitter] },
+        snapchat: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.snapchat] },
+        line: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.line] },
+        naver: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.naver] },
+        kakao: {
+          repositories: ["https://devrepo.kakao.com/nexus/content/groups/public/"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.kakao],
+        },
+        tiktok: {
+          repositories: ["https://artifact.bytedance.com/repository/AwemeOpenSDK"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.tiktok],
+        },
+        discord: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.discord] },
+      },
+      payment: {
+        googleIap: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.googleIap] },
+        appleIap: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.appleIap] },
+        onestoreIap: {
+          repositories: ["https://repo.onestore.co.kr/repository/onestore-sdk-public/"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.onestoreIap],
+        },
+        huaweiIap: {
+          repositories: ["https://developer.huawei.com/repo/"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.huaweiIap],
+        },
+        xiaomiIap: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.xiaomiIap] },
+      },
+      analytics: {
+        appsflyer: {
+          repositories: ["mavenCentral"],
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.analytics.appsflyer],
+        },
+        facebookdata: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.analytics.facebookdata] },
+        firebase: {
+          repositories: ["google"],
+          classpath: "com.google.gms:google-services:4.4.4",
+          applyplugin: "com.google.gms.google-services",
+          dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.analytics.firebase],
+        },
+        adjust: { dependencies: [...DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.analytics.adjust] },
+      },
+    },
+  };
+  const parsed = tryParseAsMeetSdkDefaultConfig(raw);
+  if (!parsed) throw new Error("embedded compatibility meetsdk-android defaults are invalid");
+  return parsed;
+}
+
+function writeMeetSdkAndroidConfigCache(config: MeetSdkDefaultConfig, cacheRoot?: string): string {
+  const configPath = resolveMeetSdkAndroidConfigPath(cacheRoot);
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+  return configPath;
 }
 
 const latestAndroidVersionCache = new Map<string, Promise<SdkHomePlatformVersion>>();
@@ -51,50 +168,117 @@ async function fetchLatestAndroidSdkVersion(baseUrl?: string): Promise<SdkHomePl
   return cached;
 }
 
-export function syncMeetSdkAndroidVersionToConfig(params: {
-  version: string;
-  date?: string;
-  packageRoot?: string;
-}): string {
-  const version = params.version.trim();
-  if (!version) throw new Error("Android SDK version is empty");
+function androidChannelPlugin(channelType?: string): string {
+  const normalized = (channelType ?? "").trim().toUpperCase();
+  const map: Record<string, string> = {
+    GOOGLE: "google_channel",
+    ONESTORE: "onestore_channel",
+    XIAOMI: "xiaomi_channel",
+    HUAWEI: "huawei_channel",
+  };
+  return map[normalized] ?? "google_channel";
+}
 
-  const configPath = resolveMeetSdkAndroidConfigPath(params.packageRoot);
-  if (!fs.existsSync(configPath)) {
-    throw new Error(`built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} not found at ${configPath}`);
-  }
-  const raw = JSON.parse(fs.readFileSync(configPath, "utf8")) as unknown;
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    throw new Error(`built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} is not a JSON object`);
+function findMeetSdkAndroidConfigFile(root: string): string | null {
+  if (!fs.existsSync(root)) return null;
+  const stack = [root];
+  while (stack.length) {
+    const dir = stack.pop()!;
+    for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+      if (ent.name.startsWith("__MACOSX") || ent.name.startsWith("._")) continue;
+      const abs = path.join(dir, ent.name);
+      if (ent.isDirectory()) {
+        stack.push(abs);
+      } else if (ent.isFile() && ent.name === MEETSDK_ANDROID_CONFIG_FILENAME) {
+        return abs;
+      }
+    }
   }
-  const record = raw as Record<string, unknown>;
-  if (typeof record.topsdk !== "object" || record.topsdk === null || Array.isArray(record.topsdk)) {
-    throw new Error(`built-in ${MEETSDK_ANDROID_DEFAULTS_FILENAME} does not contain topsdk object`);
-  }
-  const topsdk = record.topsdk as Record<string, unknown>;
-  topsdk.version = version;
-  if (params.date?.trim()) topsdk.date = params.date.trim();
-  fs.writeFileSync(configPath, `${JSON.stringify(record, null, 2)}\n`, "utf8");
-  return configPath;
+  return null;
 }
 
+function loadMeetSdkAndroidConfigFromExtracted(root: string, version: string, date?: string): MeetSdkDefaultConfig {
+  const configPath = findMeetSdkAndroidConfigFile(root);
+  if (!configPath) throw new Error(`${MEETSDK_ANDROID_CONFIG_FILENAME} not found under downloaded Android SDK: ${root}`);
+  const config = readMeetSdkDefaultConfigFromPath(configPath);
+  config.topsdk.version = config.topsdk.version || version;
+  config.topsdk.date = config.topsdk.date || date;
+  return config;
+}
+
+async function fetchSdkHomeAndroidConfig(params: {
+  baseUrl?: string;
+  version: string;
+  date?: string;
+  channelType?: string;
+  packageType?: string;
+  cacheRoot?: string;
+  signal?: AbortSignal;
+}): Promise<{ url?: string; config: MeetSdkDefaultConfig }> {
+  const baseUrl = resolveSdkHomeApiBaseUrl(params.baseUrl);
+  const packageType = params.packageType || DEFAULT_ANDROID_SDK_PACKAGE_TYPE;
+  const plugins = [androidChannelPlugin(params.channelType)];
+  const layout = resolveAndroidSdkCacheLayout({
+    version: params.version,
+    packageType,
+    plugins,
+    cacheRoot: params.cacheRoot,
+  });
+  let downloadApiUrl: string | undefined;
+  const downloadAndExtract = async (): Promise<void> => {
+    if (findMeetSdkAndroidConfigFile(layout.extractDir)) return;
+    downloadApiUrl = buildSdkHomeDownloadUrl({
+      baseUrl,
+      version: params.version,
+      platform: "android",
+      packageType,
+      plugins,
+    });
+    const body = parseJsonResponseEnvelope(await fetchJson(downloadApiUrl, params.signal), "sdk-home Android download");
+    if (typeof body !== "string" || !body.trim()) {
+      throw new Error("sdk-home Android getDownLoadUrl response does not contain a download URL in data");
+    }
+    await downloadBinaryFile(body, layout.zipPath, params.signal);
+    fs.rmSync(layout.extractDir, { recursive: true, force: true });
+    await extractZip(layout.zipPath, layout.extractDir);
+  };
+  await withCacheLock(layout.lockDir, downloadAndExtract);
+  return {
+    url: downloadApiUrl,
+    config: loadMeetSdkAndroidConfigFromExtracted(layout.extractDir, params.version, params.date),
+  };
+}
+
+const androidConfigCache = new Map<string, Promise<MeetSdkDefaultConfig>>();
+
 /**
- * Built-in Android SDK defaults with the SDK version resolved at runtime from sdk-home.
- * The version is also persisted to `config/meetsdk-android.json` so the package config
- * reflects the latest SDK version discovered from the download center.
+ * Android SDK defaults resolved from sdk-home and persisted under ~/.cache/meet-sdk-tool.
+ * The package config/ directory is no longer written at runtime.
  */
 export async function loadMeetSdkDefaultConfigWithLatestAndroidVersion(options: {
   sdkHomeApiBaseUrl?: string;
+  cacheRoot?: string;
   packageRoot?: string;
+  channelType?: string;
+  packageType?: string;
 } = {}): Promise<MeetSdkDefaultConfig> {
-  const defaults = cloneDefaultConfig(loadBuiltInMeetSdkDefaultConfig({ packageRoot: options.packageRoot }));
   const latest = await fetchLatestAndroidSdkVersion(options.sdkHomeApiBaseUrl);
-  syncMeetSdkAndroidVersionToConfig({
-    version: latest.ver,
-    date: latest.date,
-    packageRoot: options.packageRoot,
-  });
-  defaults.topsdk.version = latest.ver;
-  defaults.topsdk.date = latest.date;
-  return defaults;
+  const baseUrl = resolveSdkHomeApiBaseUrl(options.sdkHomeApiBaseUrl);
+  const key = `${baseUrl}\n${latest.ver}\n${options.cacheRoot ?? ""}\n${options.channelType ?? ""}\n${options.packageType ?? ""}`;
+  let cached = androidConfigCache.get(key);
+  if (!cached) {
+    cached = fetchSdkHomeAndroidConfig({
+      baseUrl,
+      version: latest.ver,
+      date: latest.date,
+      channelType: options.channelType,
+      packageType: options.packageType,
+      cacheRoot: options.cacheRoot,
+    }).then(({ config }) => {
+      writeMeetSdkAndroidConfigCache(config, options.cacheRoot);
+      return cloneDefaultConfig(config);
+    });
+    androidConfigCache.set(key, cached);
+  }
+  return cloneDefaultConfig(await cached);
 }

package/src/config/meetSdkIosConfig.ts

@@ -1,8 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-
-export const MEETSDK_IOS_CONFIG_FILENAME = "meetsdk-ios.json";
-const MEETSDK_CONFIG_DIR = "config";
+import { MEETSDK_IOS_CONFIG_FILENAME, resolveMeetSdkIosConfigCachePath } from "../cache.js";
 
 export interface MeetSdkIosConfig {
   topsdk: {
@@ -27,8 +25,8 @@ function normalizePlugins(value: unknown): string[] | undefined {
   return plugins.length ? plugins : undefined;
 }
 
-export function resolveMeetSdkIosConfigPath(packageRoot: string): string {
-  return path.join(packageRoot, MEETSDK_CONFIG_DIR, MEETSDK_IOS_CONFIG_FILENAME);
+export function resolveMeetSdkIosConfigPath(cacheRoot?: string): string {
+  return resolveMeetSdkIosConfigCachePath(cacheRoot);
 }
 
 export function tryParseAsMeetSdkIosConfig(raw: unknown): MeetSdkIosConfig | null {
@@ -44,8 +42,8 @@ export function tryParseAsMeetSdkIosConfig(raw: unknown): MeetSdkIosConfig | nul
   };
 }
 
-export function loadMeetSdkIosConfig(packageRoot: string): MeetSdkIosConfig {
-  const configPath = resolveMeetSdkIosConfigPath(packageRoot);
+export function loadMeetSdkIosConfig(cacheRoot?: string): MeetSdkIosConfig {
+  const configPath = resolveMeetSdkIosConfigPath(cacheRoot);
   if (!fs.existsSync(configPath)) {
     return { topsdk: { version: "" } };
   }
@@ -56,15 +54,15 @@ export function loadMeetSdkIosConfig(packageRoot: string): MeetSdkIosConfig {
   return parsed;
 }
 
-export function writeMeetSdkIosConfig(packageRoot: string, config: MeetSdkIosConfig): string {
-  const configPath = resolveMeetSdkIosConfigPath(packageRoot);
+export function writeMeetSdkIosConfig(config: MeetSdkIosConfig, cacheRoot?: string): string {
+  const configPath = resolveMeetSdkIosConfigPath(cacheRoot);
   fs.mkdirSync(path.dirname(configPath), { recursive: true });
   fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
   return configPath;
 }
 
 export function syncMeetSdkIosVersionToConfig(params: {
-  packageRoot: string;
+  cacheRoot?: string;
   version: string;
   date?: string;
   packageType?: string;
@@ -73,17 +71,15 @@ export function syncMeetSdkIosVersionToConfig(params: {
   const version = params.version.trim();
   if (!version) throw new Error("iOS SDK version is empty");
 
-  const current = loadMeetSdkIosConfig(params.packageRoot);
-  const nextDate = params.date === undefined ? current.topsdk.date : params.date.trim() || undefined;
+  const topsdk: MeetSdkIosConfig["topsdk"] = { version };
+  const date = params.date?.trim();
+  const packageType = params.packageType?.trim();
+  const plugins = params.plugins?.map((x) => x.trim()).filter(Boolean);
+  if (date) topsdk.date = date;
+  if (packageType) topsdk.packageType = packageType;
+  if (plugins?.length) topsdk.plugins = plugins;
   const next: MeetSdkIosConfig = {
-    ...current,
-    topsdk: {
-      ...current.topsdk,
-      version,
-      date: nextDate,
-      packageType: params.packageType?.trim() || current.topsdk.packageType,
-      plugins: params.plugins?.map((x) => x.trim()).filter(Boolean) || current.topsdk.plugins,
-    },
+    topsdk,
   };
-  return writeMeetSdkIosConfig(params.packageRoot, next);
+  return writeMeetSdkIosConfig(next, params.cacheRoot);
 }

package/src/contracts/types.ts

@@ -57,6 +57,8 @@ export interface WorkspaceContext {
   remoteConfigPath?: string;
   /** Cached iOS SDK root used as the source for integration resources. */
   iosSdkRoot?: string;
+  /** Optional cache root override, primarily used by tests. */
+  cacheRoot?: string;
   android?: AndroidDetectResult;
   /** Reserved: populated via placeholder until iOS tooling ships. */
   ios?: IOSDetectResult;
@@ -72,6 +74,8 @@ export interface WorkspaceContextOptions {
   remoteConfigPath?: string;
   /** Override the iOS SDK source root. */
   iosSdkRoot?: string;
+  /** Override meet-sdk-tool cache root. */
+  cacheRoot?: string;
 }
 
 export interface ManifestStep {

package/src/core/doctor.ts

@@ -198,6 +198,8 @@ async function checkAndroid(ctx: WorkspaceContext, report: DoctorReport, config:
     await loadMeetSdkDefaultConfigWithLatestAndroidVersion({
       sdkHomeApiBaseUrl: ctx.sdkHomeApiBaseUrl,
       packageRoot: ctx.packageRoot,
+      cacheRoot: ctx.cacheRoot,
+      channelType: config.channel,
     })
   );
   const moduleGradleAbs = moduleBuildGradlePath(ctx);
@@ -355,7 +357,7 @@ async function checkIos(ctx: WorkspaceContext, report: DoctorReport, config: Mee
   for (const folder of enabledIosPluginFolders(config)) {
     const plugin = findPluginByFolder(sdkRoot, folder);
     if (plugin) pluginConfigs.push(plugin);
-    else report.warnings.push(`iOS plugin folder not in SDK package: plugins/${folder}`);
+    else report.warnings.push(`iOS config enables ${folder}, but current SDK package does not include plugins/${folder}; skipped`);
   }
   const loadedConfigs = [...coreConfigs, ...pluginConfigs];
   const resourceErrors = loadedConfigs.flatMap(validateLoadedPluginResourcesForDoctor);

package/src/core/previewPatches.ts

@@ -1,13 +1,13 @@
 import fs from "node:fs";
 import path from "node:path";
 
-/** Default directory for `pipeline.patch` / `cli-preview.patch` (gitignored). */
+/** Default directory for expected dry-run patch artifacts. */
 export function resolveDefaultPreviewPatchDir(packageRoot: string): string {
-  return path.join(packageRoot, "preview-patches");
+  return path.join(packageRoot, "fixtures", "expected-patches");
 }
 
 /**
- * Before writing a new patch under `preview-patches/`, remove all existing files there
+ * Before writing a new patch under `fixtures/expected-patches/`, remove all existing files there
  * so only the latest command output remains.
  */
 export function clearPreviewPatchFilesIfTargetInside(packageRoot: string, patchFileAbs: string): void {

package/src/core/workspace.ts

@@ -24,6 +24,7 @@ export function buildWorkspaceContext(
     sdkHomeApiBaseUrl: options.sdkHomeApiBaseUrl,
     remoteConfigPath: options.remoteConfigPath,
     iosSdkRoot: options.iosSdkRoot,
+    cacheRoot: options.cacheRoot,
     android: detectAndroid(root, { appTarget: options.appTarget }),
     ios: detectIOS(root, { appTarget: options.appTarget }),
     iosReserved: iosToolingReserved,

package/src/index.ts

@@ -61,10 +61,8 @@ export {
   loadBuiltInMeetSdkDefaultConfig,
   loadMeetSdkDefaultConfigWithLatestAndroidVersion,
   resolveMeetSdkAndroidConfigPath,
-  syncMeetSdkAndroidVersionToConfig,
 } from "./config/meetSdkDefaultConfig.js";
 export {
-  MEETSDK_IOS_CONFIG_FILENAME,
   loadMeetSdkIosConfig,
   resolveMeetSdkIosConfigPath,
   syncMeetSdkIosVersionToConfig,
@@ -81,9 +79,13 @@ export {
 } from "./config/topsdkFeatureModules.js";
 export { clearPreviewPatchFilesIfTargetInside, resolveDefaultPreviewPatchDir } from "./core/previewPatches.js";
 export {
+  MEETSDK_ANDROID_CONFIG_FILENAME,
+  MEETSDK_IOS_CONFIG_FILENAME,
   MEET_SDK_TOOL_CACHE_ROOT,
   ensureCacheRoot,
   resolveIosSdkCacheLayout,
+  resolveMeetSdkAndroidConfigCachePath,
+  resolveMeetSdkIosConfigCachePath,
   resolveRemoteConfigCachePath,
   writeRemoteConfigCache,
 } from "./cache.js";
@@ -108,7 +110,6 @@ export {
 } from "./remote/topsdkDownloadSdkConfig.js";
 export {
   DEFAULT_IOS_SDK_PACKAGE_TYPE,
-  DEFAULT_IOS_SDK_PLUGINS,
   buildSdkHomeDownloadUrl,
   buildSdkHomeVersionUrl,
   defaultSdkHomeApiBaseUrl,
@@ -118,6 +119,7 @@ export {
   fetchSdkHomeIosDownloadUrl,
   fetchSdkHomeIosVersion,
   fetchSdkHomeVersions,
+  resolveIosSdkDownloadPluginsFromRemoteConfig,
   resolveIosSdkRootFromDirectory,
   resolveIosSdkZipFileName,
   type DownloadIosSdkOptions,