@leonxin/meetgames 0.1.11 → 0.1.12

package/docs/archive/api/downloadSDKConfig.md

@@ -38,7 +38,7 @@ meetgames fetch-config --app-id 791251136341225472 --app-secret YOUR_APP_SECRET
 
 - **Content-Type**：`application/json`（附件下载头 `Content-Disposition: meetsdk-remote-config.json`）
 - **Body**：即为 `meetsdk-remote-config.json` 全文（pretty JSON），**不是** `{ code, result }` 包装
-- **落盘**：`fetch-config` / MCP `meetgames_fetch_config` 将响应 **bytes 原样写入** `<project-root>/meetsdk-remote-config.json`，不注入 `dependencies`/`repositories`/`topsdk.version` 等字段；这些固定 SDK 配置仅在 `integrate` 时从内置 [`meetsdk-android.json`](../meetsdk-android.json) 合并。
+- **落盘**：`fetch-config` / MCP `meetgames_fetch_config` 将响应 **bytes 原样写入** `~/.cache/meet-sdk-tool`，不注入 `dependencies`/`repositories`/`topsdk.version` 等字段；这些固定 SDK 配置仅在 `integrate` 时从内置 [`config/meetsdk-android.json`](../../config/meetsdk-android.json) 合并。
 
 ### 服务端数据来源（gp-sdk MySQL）
 
@@ -56,7 +56,7 @@ meetgames fetch-config --app-id 791251136341225472 --app-secret YOUR_APP_SECRET
 
 详见 gp-sdk `SdkConfigDownloadServiceImpl`；**不包含** `topsdk.version`（integrate 时用 `meetsdk-android.json` 兜底）。
 
-**子模块写入**：只要库表里有对应配置参数即写入子键，value 为对象（或 `{}`）；无配置**不写该键**（不出现 `false`）。插件对象内只写有值字段，不写空字符串占位。`channel_auth` 输出字段为 `clientId` / `secret` / `redirect` / `scheme` / `name`；`channel_third_data_platform` 输出字段保持 `devKey` / `appleAppId` / `firebaseUrl` / `firebaseName` / `appCode` 等实体字段名。**不**再根据 `channel_auth.enable` / `channel_payment.enable` 过滤。`analytics.facebookdata` 等独立开关字段预留，待 meetgames-business 配置后再接。
+**子模块写入**：只要库表里有对应配置参数即写入子键，value 为对象（或 `{}`）；无配置**不写该键**（不出现 `false`）。插件对象内只写有值字段，不写空字符串占位。`channel_auth` 输出字段为 `clientId` / `secret` / `redirect` / `scheme` / `name`；`channel_third_data_platform` 输出字段保持 `devKey` / `appleAppId` / `firebaseUrl` / `firebaseName` / `appCode` / `eventUrl` 等实体字段名，其中 `eventUrl` 属于 `analytics.adjust`，不属于 `analytics.appsflyer`。**不**再根据 `channel_auth.enable` / `channel_payment.enable` 过滤。`analytics.facebookdata` 等独立开关字段预留，待 meetgames-business 配置后再接。
 
 `meet-sdk-tool` 按上述 DTO/entity 原字段名读取配置；旧字段名不再作为兼容输入。
 

package/docs/archive/api/getChannelConfig-meetgames.md

@@ -93,7 +93,7 @@ GET https://test-business-api.meetgames.com/customer/topsdk/console/meetgames/ch
 | `thirdDataPlatform.firebaseUrl` | Firebase / `firebaseUrl` 字段 |
 | `parameterConfig` | 支付 / Google Play 服务账号等，与 `channel_payment`、parameter 表相关 |
 
-完整 Gradle 集成仍依赖工具侧 [`meetsdk-android.json`](../../meetsdk-android.json) 合并版本与依赖。
+完整 Gradle 集成仍依赖工具侧 [`config/meetsdk-android.json`](../../config/meetsdk-android.json) 合并版本与依赖。
 
 ## 脱敏样例
 

package/docs/archive/product//351/234/200/346/261/202/346/226/207/346/241/243.md

@@ -77,7 +77,7 @@ addManifestPlaceholders([
 #### 新方式
 
 - 远程 JSON 决定**接入哪些可选模块**（guest、email、facebook、google-iap、appsflyer 等）。  
-- 工具内置 [`meetsdk-android.json`](../meetsdk-android.json) 提供**固定** SDK 版本、仓库 URL、`classpath`、Firebase plugin、各模块 `dependencies`。  
+- 工具内置 [`config/meetsdk-android.json`](../../config/meetsdk-android.json) 提供**固定** SDK 版本、仓库 URL、`classpath`、Firebase plugin、各模块 `dependencies`。  
 - `integrate` 合并后写入根工程与 App Module 的 Gradle（标记块 upsert，避免重复插入）。
 
 **示例（由工具生成，非人工维护）**

package/package.json

@@ -1,17 +1,14 @@
 {
   "name": "@leonxin/meetgames",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "license": "MIT",
   "type": "module",
   "bin": {
     "meetgames": "dist/entry.js",
-    "meetgames-mcp": "dist/mcp-entry.js",
-    "meetgames-aab": "dist/aab-converter/aab-entry.js"
+    "meetgames-mcp": "dist/mcp-entry.js"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "build:aab": "tsc -p tsconfig.json",
-    "package:aab-win-zip": "node scripts/package-aab-cli-win.mjs",
     "test": "vitest run",
     "test:mcp": "npm run build && npm run test:mcp:run",
     "test:mcp:run": "vitest run --config vitest.mcp.config.ts",

package/recipes/android-default.yaml

@@ -8,8 +8,3 @@ steps:
     args:
       permissions:
         - android.permission.ACCESS_NETWORK_STATE
-  - op: files.copyBundled
-    platform: android
-    args:
-      from: android/sample.txt
-      to: vendor/meet-integrate/sample.txt

package/recipes/integrate-default.yaml

@@ -6,11 +6,6 @@ steps:
   - op: files.downloadGoogleServicesJson
     platform: android
     args: {}
-  - op: files.copyBundled
-    platform: android
-    args:
-      from: android/sample.txt
-      to: vendor/meet-integrate/sample.txt
   - op: ios.integrateTopSdk
     platform: ios
     args: {}

package/src/cache.ts

@@ -0,0 +1,164 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { MEETSDK_REMOTE_CONFIG_FILENAME } from "./config/meetSdkRemoteConfig.js";
+
+export const MEET_SDK_TOOL_CACHE_ROOT = path.join(os.homedir(), ".cache", "meet-sdk-tool");
+
+function iosSdkZipFileName(version: string): string {
+  return `topSDK-ios--V${version}.zip`;
+}
+
+function safeSegment(value: string): string {
+  const cleaned = value.trim().replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^_+|_+$/g, "");
+  return cleaned || "unknown";
+}
+
+function sha256Hex(value: string, length = 16): string {
+  return crypto.createHash("sha256").update(value).digest("hex").slice(0, length);
+}
+
+function writeFileAtomic(absPath: string, content: string | Buffer): void {
+  ensureCacheRoot();
+  fs.mkdirSync(path.dirname(absPath), { recursive: true });
+  const tmp = path.join(path.dirname(absPath), `.${path.basename(absPath)}.${process.pid}.${Date.now()}.tmp`);
+  fs.writeFileSync(tmp, content);
+  fs.renameSync(tmp, absPath);
+}
+
+export function ensureCacheRoot(): string {
+  fs.mkdirSync(MEET_SDK_TOOL_CACHE_ROOT, { recursive: true, mode: 0o700 });
+  try {
+    fs.chmodSync(MEET_SDK_TOOL_CACHE_ROOT, 0o700);
+  } catch {
+    // Best-effort on filesystems that do not support POSIX modes.
+  }
+  return MEET_SDK_TOOL_CACHE_ROOT;
+}
+
+export function resolveRemoteConfigCachePath(params: {
+  env: string;
+  appId: string;
+  channelType: string;
+}): string {
+  return path.join(
+    MEET_SDK_TOOL_CACHE_ROOT,
+    "configs",
+    safeSegment(params.env),
+    safeSegment(params.appId),
+    safeSegment(params.channelType),
+    MEETSDK_REMOTE_CONFIG_FILENAME
+  );
+}
+
+export function writeRemoteConfigCache(params: {
+  env: string;
+  appId: string;
+  channelType: string;
+  requestUrl: string;
+  rawText: string;
+  warnings?: readonly string[];
+}): { configPath: string; metadataPath: string } {
+  const fetchedAt = new Date().toISOString();
+  const metadata = `${JSON.stringify(
+    {
+      fetchedAt,
+      env: params.env,
+      appId: params.appId,
+      channelType: params.channelType,
+      requestUrl: params.requestUrl,
+      sha256: crypto.createHash("sha256").update(params.rawText).digest("hex"),
+      warnings: params.warnings ?? [],
+    },
+    null,
+    2
+  )}\n`;
+  const configPath = resolveRemoteConfigCachePath(params);
+  const metadataPath = path.join(path.dirname(configPath), "metadata.json");
+
+  writeFileAtomic(configPath, params.rawText);
+  writeFileAtomic(metadataPath, metadata);
+
+  return { configPath, metadataPath };
+}
+
+function pluginsHash(plugins: readonly string[]): string {
+  return sha256Hex(plugins.join(","), 12);
+}
+
+export function resolveIosSdkCacheLayout(params: {
+  version: string;
+  packageType: string;
+  plugins: readonly string[];
+}): { baseDir: string; zipPath: string; extractDir: string; metadataPath: string; lockDir: string } {
+  const baseDir = path.join(
+    MEET_SDK_TOOL_CACHE_ROOT,
+    "sdk",
+    "ios",
+    safeSegment(params.packageType),
+    safeSegment(params.version),
+    pluginsHash(params.plugins)
+  );
+  return {
+    baseDir,
+    zipPath: path.join(baseDir, iosSdkZipFileName(params.version)),
+    extractDir: path.join(baseDir, "extracted"),
+    metadataPath: path.join(baseDir, "metadata.json"),
+    lockDir: path.join(baseDir, ".lock"),
+  };
+}
+
+export function writeIosSdkCacheMetadata(params: {
+  metadataPath: string;
+  version: string;
+  date?: string;
+  packageType: string;
+  plugins: readonly string[];
+  versionUrl: string;
+  downloadApiUrl: string;
+  sdkZipUrl: string;
+  zipPath: string;
+  extractDir: string;
+  resolvedSdkRoot: string;
+}): void {
+  const zipSha256 = fs.existsSync(params.zipPath)
+    ? crypto.createHash("sha256").update(fs.readFileSync(params.zipPath)).digest("hex")
+    : "";
+  writeFileAtomic(
+    params.metadataPath,
+    `${JSON.stringify(
+      {
+        fetchedAt: new Date().toISOString(),
+        version: params.version,
+        date: params.date,
+        packageType: params.packageType,
+        plugins: params.plugins,
+        versionUrl: params.versionUrl,
+        downloadApiUrl: params.downloadApiUrl,
+        sdkZipUrl: params.sdkZipUrl,
+        zipPath: params.zipPath,
+        extractDir: params.extractDir,
+        resolvedSdkRoot: params.resolvedSdkRoot,
+        zipSha256,
+      },
+      null,
+      2
+    )}\n`
+  );
+}
+
+export function withCacheLock<T>(lockDir: string, fn: () => Promise<T>): Promise<T> {
+  fs.mkdirSync(path.dirname(lockDir), { recursive: true });
+  try {
+    fs.mkdirSync(lockDir);
+  } catch (e) {
+    if ((e as NodeJS.ErrnoException).code === "EEXIST") {
+      throw new Error(`cache path is locked by another meet-sdk-tool process: ${lockDir}`);
+    }
+    throw e;
+  }
+  return fn().finally(() => {
+    fs.rmSync(lockDir, { recursive: true, force: true });
+  });
+}

package/src/cli.ts

@@ -20,7 +20,6 @@ import {
 import type { Manifest } from "./contracts/types.js";
 import {
   validateDownloadSdkConfigForWrite,
-  writeDownloadSdkConfigRaw,
 } from "./config/fetchConfigWrite.js";
 import {
   MEETSDK_REMOTE_CONFIG_FILENAME,
@@ -28,6 +27,11 @@ import {
   tryParseAsMeetSdkRemoteConfig,
   type MeetSdkRemoteConfig,
 } from "./config/meetSdkRemoteConfig.js";
+import {
+  MEET_SDK_TOOL_CACHE_ROOT,
+  resolveRemoteConfigCachePath,
+  writeRemoteConfigCache,
+} from "./cache.js";
 
 const EXIT = {
   OK: 0,
@@ -62,7 +66,6 @@ interface Parsed {
   iosSdkVersion: string;
   iosSdkPlugins: string;
   iosSdkPackageType: string;
-  iosSdkOutputDir: string;
 }
 
 function printHelp(): void {
@@ -70,35 +73,35 @@ function printHelp(): void {
 meetgames — Android-first integration CLI (TypeScript)
 
 Usage:
-  meetgames integrate [--project-root <path>] [--app-target <target>] [--dry-run] [--verbose] [--patch-file <path>]
+  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 [--version VERSION] [--plugins csv] [--package-type native|unity|cocos] [--sdk-api-base-url URL] [--output-dir <path>] [--verbose]
+  meetgames download-ios-sdk [--version VERSION] [--plugins csv] [--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]
 
 Notes:
   - Source code is TypeScript only; published bin runs compiled output under dist/.
   - iOS: copies frameworks to topSDK/, edits project.pbxproj & Info.plist, injects AppDelegate (.m/.mm) when present (topsdk-tool-ios parity).
-  - fetch-config calls TOPSDK downloadSDKConfig and writes the response body unchanged to <project-root>/meetsdk-remote-config.json.
-  - setup runs fetch-config then integrate in one process (same flags as both subcommands).
+  - fetch-config calls TOPSDK downloadSDKConfig and writes the response body unchanged under ${MEET_SDK_TOOL_CACHE_ROOT}.
+  - setup runs fetch-config, then download-ios-sdk for iOS projects, then integrate in one process.
   - doctor / setup / integrate require --project-root and auto-select exactly one platform from that root.
-  - doctor first fetches downloadSDKConfig to <project-root>/meetsdk-remote-config.json, then validates the detected platform integration.
+  - 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 bundled/ios-sdk/ in the tool package (native iOS only).
-  - Android integrate/doctor reads the latest SDK version from sdk-home and stores it in meetsdk-android.json.
-  - download-ios-sdk calls sdk-home getDownLoadUrl, saves the iOS SDK zip under bundled/ios-sdk/, extracts it there, and stores the resolved version in meetsdk-ios.json.
+  - 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/.
   - 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 <project-root>/meetsdk-remote-config.json.
-  - fetch-config requires --channel-type (or channel in local meetsdk-remote-config.json / TOPSDK_CHANNEL_TYPE); not inferred from Android/iOS detection.
-  - Recipe op gradle.applyMeetSdkRemoteConfig reads meetsdk-remote-config.json and writes TOPSDK marker blocks to root + app build.gradle (same idea as sdk-integration-agent gradleEditor).
+  - fetch-config writes to ${MEET_SDK_TOOL_CACHE_ROOT}/configs/<env>/<appId>/<channelType>/meetsdk-remote-config.json.
+  - integrate/doctor read the cache entry selected by --env, --app-id, and --channel-type; without those flags they only read an existing project-root meetsdk-remote-config.json for compatibility.
+  - Recipe op gradle.applyMeetSdkRemoteConfig reads cached meetsdk-remote-config.json and writes TOPSDK marker blocks to root + app build.gradle (same idea as sdk-integration-agent gradleEditor).
 
 Options (global where noted):
   --project-root        Host project directory (default: cwd); for iOS it may point to the project root or directly to a .xcodeproj directory
   --app-target          App target to integrate/check: Android application Gradle module (e.g. :app or launcher) or iOS App target name
-  --app-id              fetch-config override; default reads topsdk.appId from meetsdk-remote-config.json
+  --app-id              fetch-config/integrate/doctor cache selector; default TOPSDK_APP_ID
   --app-secret          fetch-config: required appSecret for downloadSDKConfig sign (or env TOPSDK_APP_SECRET)
-  --channel-type        fetch-config: channelType query param for downloadSDKConfig (required unless channel in local file or TOPSDK_CHANNEL_TYPE)
+  --channel-type        fetch-config/integrate/doctor cache selector; default TOPSDK_CHANNEL_TYPE
   --env                 fetch-config: prod（正式服，默认）| pre | test（开发调试）
   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 下载
@@ -106,10 +109,9 @@ Options (global where noted):
   --version             download-ios-sdk: 指定 iOS SDK 版本；不传时从 /sdk/home/version 读取最新 iOS 版本
   --plugins             download-ios-sdk: 逗号分隔插件列表；默认与下载页 iOS 默认选择一致
   --package-type        download-ios-sdk: native（默认）| unity | cocos
-  --output-dir          download-ios-sdk: 解压目标目录；默认 <package-root>/bundled/ios-sdk
   --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>/test-projects/_preview/, 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>/preview-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:
@@ -139,7 +141,6 @@ function parseArgv(argv: string[]): Parsed {
     iosSdkVersion: "",
     iosSdkPlugins: "",
     iosSdkPackageType: "",
-    iosSdkOutputDir: "",
   };
   const rest = argv.slice(2);
   if (!rest.length || (rest[0]?.startsWith("-") ?? false)) {
@@ -201,12 +202,6 @@ function parseArgv(argv: string[]): Parsed {
       i += 1;
       continue;
     }
-    if (t === "--output-dir") {
-      out.iosSdkOutputDir = path.resolve(rest[i + 1] ?? "");
-      if (!out.iosSdkOutputDir || rest[i + 1]?.startsWith("-")) fail("--output-dir requires a directory path", EXIT.INVALID_ARGS);
-      i += 1;
-      continue;
-    }
     if (t === "--env") {
       const v = (rest[i + 1] ?? "").toLowerCase();
       i += 1;
@@ -254,6 +249,13 @@ function resolvedAppTarget(parsed: Parsed): string {
   return parsed.appTarget;
 }
 
+function cachedRemoteConfigPathFromArgs(parsed: Parsed): string {
+  const appId = parsed.topsdkAppId || process.env.TOPSDK_APP_ID || "";
+  const channelType = parsed.topsdkChannelType || process.env.TOPSDK_CHANNEL_TYPE || "";
+  if (!appId || !channelType) return "";
+  return resolveRemoteConfigCachePath({ env: parsed.topsdkEnv, appId, channelType });
+}
+
 function selectedPlatformContext(parsed: Parsed): {
   platform: "android" | "ios";
   ctx: ReturnType<typeof buildWorkspaceContext>;
@@ -262,6 +264,7 @@ function selectedPlatformContext(parsed: Parsed): {
   const ctx = buildWorkspaceContext(parsed.projectRoot, resolvePackageRoot(), {
     appTarget: resolvedAppTarget(parsed),
     sdkHomeApiBaseUrl: parsed.sdkHomeApiBaseUrl || undefined,
+    remoteConfigPath: cachedRemoteConfigPathFromArgs(parsed) || undefined,
   });
   const detected = detectSinglePlatform(ctx);
   if (!detected.ok) fail(detected.error, EXIT.PROJECT_ERROR);
@@ -282,13 +285,7 @@ async function cmdDoctor(parsed: Parsed): Promise<void> {
   if (!report.ok) process.exit(EXIT.CONFIG_ERROR);
 }
 
-/** 固定缓存路径：宿主工程根目录下的 meetsdk-remote-config.json */
-function meetSdkRemoteConfigCachePath(projectRoot: string): string {
-  return path.join(projectRoot, MEETSDK_REMOTE_CONFIG_FILENAME);
-}
-
-function readLocalMeetSdkRemoteConfig(projectRoot: string): MeetSdkRemoteConfig | null {
-  const configPath = meetSdkRemoteConfigCachePath(projectRoot);
+function readLocalMeetSdkRemoteConfig(configPath: string): MeetSdkRemoteConfig | null {
   if (!fs.existsSync(configPath)) return null;
   try {
     return tryParseAsMeetSdkRemoteConfig(JSON.parse(fs.readFileSync(configPath, "utf8")) as unknown);
@@ -298,8 +295,8 @@ function readLocalMeetSdkRemoteConfig(projectRoot: string): MeetSdkRemoteConfig
 }
 
 async function cmdFetchConfig(parsed: Parsed): Promise<void> {
-  const out = meetSdkRemoteConfigCachePath(parsed.projectRoot);
-  const localConfig = readLocalMeetSdkRemoteConfig(parsed.projectRoot);
+  const selectedConfigPath = cachedRemoteConfigPathFromArgs(parsed);
+  const localConfig = selectedConfigPath ? readLocalMeetSdkRemoteConfig(selectedConfigPath) : null;
 
   const appId = parsed.topsdkAppId || localConfig?.topsdk.appId || process.env.TOPSDK_APP_ID || "";
   const appSecret = parsed.topsdkAppSecret || process.env.TOPSDK_APP_SECRET || "";
@@ -347,10 +344,18 @@ async function cmdFetchConfig(parsed: Parsed): Promise<void> {
     console.warn(`[meetgames] warning: ${warning}`);
   }
 
-  writeDownloadSdkConfigRaw(out, rawText);
-  console.log(`[meetgames] wrote ${MEETSDK_REMOTE_CONFIG_FILENAME} (downloadSDKConfig response, unmodified): ${out}`);
+  const written = writeRemoteConfigCache({
+    env: parsed.topsdkEnv,
+    appId,
+    channelType,
+    requestUrl,
+    rawText,
+    warnings: validation.warnings,
+  });
+  console.log(`[meetgames] wrote ${MEETSDK_REMOTE_CONFIG_FILENAME} (downloadSDKConfig response, unmodified): ${written.configPath}`);
   if (parsed.verbose) {
     console.log(`[meetgames] GET ${requestUrl}`);
+    console.log(`[meetgames] metadata: ${written.metadataPath}`);
   }
 }
 
@@ -396,9 +401,13 @@ async function cmdIntegrate(parsed: Parsed): Promise<void> {
 }
 
 async function cmdSetup(parsed: Parsed): Promise<void> {
-  selectedPlatformContext(parsed);
+  const { platform } = selectedPlatformContext(parsed);
   console.log("[meetgames] setup: fetching remote config…");
   await cmdFetchConfig(parsed);
+  if (platform === "ios") {
+    console.log("[meetgames] setup: downloading iOS SDK…");
+    await cmdDownloadIosSdk(parsed);
+  }
   console.log("[meetgames] setup: integrating project…");
   await cmdIntegrate(parsed);
 }
@@ -428,7 +437,6 @@ async function cmdDownloadIosSdk(parsed: Parsed): Promise<void> {
       version: parsed.iosSdkVersion || undefined,
       plugins,
       packageType,
-      outputDir: parsed.iosSdkOutputDir || undefined,
     });
   } catch (e) {
     fail(e instanceof Error ? e.message : String(e), EXIT.NETWORK_ERROR);
@@ -437,7 +445,7 @@ async function cmdDownloadIosSdk(parsed: Parsed): Promise<void> {
   console.log(`[meetgames] downloaded iOS SDK ${result.version} zip: ${result.zipPath}`);
   console.log(`[meetgames] extracted iOS SDK to: ${result.extractDir}`);
   console.log(`[meetgames] resolved iOS SDK root: ${result.resolvedSdkRoot}`);
-  console.log(`[meetgames] updated iOS SDK config: ${result.iosConfigPath}`);
+  console.log(`[meetgames] wrote iOS SDK metadata: ${result.cacheMetadataPath}`);
   if (parsed.verbose) {
     console.log(`[meetgames] GET ${result.versionUrl}`);
     console.log(`[meetgames] GET ${result.downloadApiUrl}`);

package/src/config/meetSdkDefaultConfig.ts

@@ -6,13 +6,14 @@ import { defaultSdkHomeApiBaseUrl, fetchSdkHomeVersions, type SdkHomePlatformVer
 
 /** 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 defaultConfigPath = fileURLToPath(
-  new URL(`../../${MEETSDK_ANDROID_DEFAULTS_FILENAME}`, import.meta.url)
+  new URL(`../../${MEETSDK_CONFIG_DIR}/${MEETSDK_ANDROID_DEFAULTS_FILENAME}`, import.meta.url)
 );
 
 export function resolveMeetSdkAndroidConfigPath(packageRoot?: string): string {
-  return packageRoot ? path.join(packageRoot, MEETSDK_ANDROID_DEFAULTS_FILENAME) : defaultConfigPath;
+  return packageRoot ? path.join(packageRoot, MEETSDK_CONFIG_DIR, MEETSDK_ANDROID_DEFAULTS_FILENAME) : defaultConfigPath;
 }
 
 export function loadBuiltInMeetSdkDefaultConfig(options: { packageRoot?: string } = {}): MeetSdkDefaultConfig {
@@ -79,7 +80,7 @@ export function syncMeetSdkAndroidVersionToConfig(params: {
 
 /**
  * Built-in Android SDK defaults with the SDK version resolved at runtime from sdk-home.
- * The version is also persisted to `meetsdk-android.json` so the package config
+ * The version is also persisted to `config/meetsdk-android.json` so the package config
  * reflects the latest SDK version discovered from the download center.
  */
 export async function loadMeetSdkDefaultConfigWithLatestAndroidVersion(options: {

package/src/config/meetSdkIosConfig.ts

@@ -2,6 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 
 export const MEETSDK_IOS_CONFIG_FILENAME = "meetsdk-ios.json";
+const MEETSDK_CONFIG_DIR = "config";
 
 export interface MeetSdkIosConfig {
   topsdk: {
@@ -27,7 +28,7 @@ function normalizePlugins(value: unknown): string[] | undefined {
 }
 
 export function resolveMeetSdkIosConfigPath(packageRoot: string): string {
-  return path.join(packageRoot, MEETSDK_IOS_CONFIG_FILENAME);
+  return path.join(packageRoot, MEETSDK_CONFIG_DIR, MEETSDK_IOS_CONFIG_FILENAME);
 }
 
 export function tryParseAsMeetSdkIosConfig(raw: unknown): MeetSdkIosConfig | null {
@@ -57,6 +58,7 @@ export function loadMeetSdkIosConfig(packageRoot: string): MeetSdkIosConfig {
 
 export function writeMeetSdkIosConfig(packageRoot: string, config: MeetSdkIosConfig): string {
   const configPath = resolveMeetSdkIosConfigPath(packageRoot);
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
   fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
   return configPath;
 }

package/src/config/meetSdkRemoteConfig.ts

@@ -154,6 +154,7 @@ export type MeetSdkAnalyticsFirebaseModule = false | MeetSdkAnalyticsFirebaseCre
 export interface MeetSdkAnalyticsAdjustCredentials {
   appId: string;
   clientId?: string;
+  eventUrl?: string;
   enableSandbox: boolean;
   dependencies?: MeetSdkGradleDependency[];
 }
@@ -532,6 +533,7 @@ function parseAnalyticsAdjustModule(v: unknown): MeetSdkAnalyticsAdjustModule |
   if (!isRecord(v)) return null;
   return {
     appId: str(v.appCode),
+    eventUrl: optionalStr(v.eventUrl),
     enableSandbox: "enableSandbox" in v ? bool(v.enableSandbox) : false,
     dependencies: parseDependencies(v.dependencies),
   };
@@ -556,7 +558,8 @@ function parseAnalyticsAppsflyerModule(v: unknown): MeetSdkAnalyticsAppsflyerMod
   if (!isRecord(v)) return null;
   return {
     devKey: str(v.devKey),
-    appleAppId: optionalStr(v.appleAppId),
+    clientId: optionalStr(v.clientId),
+    appleAppId: optionalStr(v.appleAppId ?? v.appId),
     enableDebugLog: "enableDebugLog" in v ? bool(v.enableDebugLog) : false,
     repositories: Array.isArray(v.repositories) ? v.repositories.map((x) => String(x)) : undefined,
     dependencies: parseDependencies(v.dependencies),
@@ -810,6 +813,7 @@ export function mapTopSdkGetSdkConfigToMeetSdkRemoteConfig(
         out.sdkModules.analytics.adjust = {
           appId: str(item.appId ?? item.appToken ?? item.clientId),
           clientId: optionalStr(item.clientId),
+          eventUrl: optionalStr(item.eventUrl ?? item.event_url),
           enableSandbox: bool(item.enableSandbox ?? item.adjustEnableSandbox),
         };
         break;

package/src/contracts/types.ts

@@ -53,6 +53,10 @@ export interface WorkspaceContext {
   packageRoot: string;
   /** sdk-home API root used for latest Android/iOS SDK version discovery. */
   sdkHomeApiBaseUrl?: string;
+  /** Cached meetsdk-remote-config.json path for this project. */
+  remoteConfigPath?: string;
+  /** Cached iOS SDK root used as the source for integration resources. */
+  iosSdkRoot?: string;
   android?: AndroidDetectResult;
   /** Reserved: populated via placeholder until iOS tooling ships. */
   ios?: IOSDetectResult;
@@ -64,6 +68,10 @@ export interface WorkspaceContextOptions {
   appTarget?: string;
   /** sdk-home API root; defaults to the production MeetGames business API. */
   sdkHomeApiBaseUrl?: string;
+  /** Override the cached remote config path. */
+  remoteConfigPath?: string;
+  /** Override the iOS SDK source root. */
+  iosSdkRoot?: string;
 }
 
 export interface ManifestStep {

package/src/core/doctor.ts

@@ -58,8 +58,8 @@ function addCheck(report: DoctorReport, name: string, ok: boolean, details?: str
   if (!ok) report.errors.push(details ? `${name}: ${details}` : name);
 }
 
-function readJsonConfig(projectRoot: string): MeetSdkRemoteConfig | null {
-  const abs = path.join(projectRoot, MEETSDK_REMOTE_CONFIG_FILENAME);
+function readJsonConfig(configPath: string): MeetSdkRemoteConfig | null {
+  const abs = configPath;
   if (!fs.existsSync(abs)) return null;
   try {
     return tryParseAsMeetSdkRemoteConfig(JSON.parse(fs.readFileSync(abs, "utf8")) as unknown);
@@ -345,7 +345,7 @@ async function checkIos(ctx: WorkspaceContext, report: DoctorReport, config: Mee
     addCheck(report, "ios.detect", false, "iOS project not detected");
     return;
   }
-  const sdkRoot = resolveIosSdkRoot(ctx.packageRoot);
+  const sdkRoot = ctx.iosSdkRoot ?? resolveIosSdkRoot(ctx.packageRoot);
   const channelConfig = buildChannelConfigMap(config);
   const coreConfigs = listSdkCoreConfigs(sdkRoot);
   const pluginConfigs: LoadedPluginConfig[] = [];
@@ -359,7 +359,7 @@ async function checkIos(ctx: WorkspaceContext, report: DoctorReport, config: Mee
   }
   const loadedConfigs = [...coreConfigs, ...pluginConfigs];
   const resourceErrors = loadedConfigs.flatMap(validateLoadedPluginResourcesForDoctor);
-  addCheck(report, "ios.bundledSdkResources", resourceErrors.length === 0, resourceErrors.join(", ") || "bundled SDK resources complete");
+  addCheck(report, "ios.sdkResources", resourceErrors.length === 0, resourceErrors.join(", ") || "SDK resources complete");
   const missingRequired = validateRequiredChannelConfigs(pluginConfigs, channelConfig);
   addCheck(report, "ios.remoteParams", missingRequired.length === 0, missingRequired.join(", ") || "all required plugin params present");
 
@@ -460,7 +460,7 @@ async function checkIos(ctx: WorkspaceContext, report: DoctorReport, config: Mee
 }
 
 export async function runDoctor(ctx: WorkspaceContext, platform: "android" | "ios"): Promise<DoctorReport> {
-  const configPath = path.join(ctx.projectRoot, MEETSDK_REMOTE_CONFIG_FILENAME);
+  const configPath = ctx.remoteConfigPath ?? path.join(ctx.projectRoot, MEETSDK_REMOTE_CONFIG_FILENAME);
   const report: DoctorReport = {
     projectRoot: ctx.projectRoot,
     platform,
@@ -470,8 +470,8 @@ export async function runDoctor(ctx: WorkspaceContext, platform: "android" | "io
     warnings: [],
     errors: [],
   };
-  const config = readJsonConfig(ctx.projectRoot);
-  addCheck(report, "remoteConfig.existsAndParses", Boolean(config), MEETSDK_REMOTE_CONFIG_FILENAME);
+  const config = readJsonConfig(configPath);
+  addCheck(report, "remoteConfig.existsAndParses", Boolean(config), configPath);
   if (!config) {
     report.ok = false;
     return report;

package/src/core/previewPatches.ts

@@ -3,11 +3,11 @@ import path from "node:path";
 
 /** Default directory for `pipeline.patch` / `cli-preview.patch` (gitignored). */
 export function resolveDefaultPreviewPatchDir(packageRoot: string): string {
-  return path.join(packageRoot, "test-projects", "_preview");
+  return path.join(packageRoot, "preview-patches");
 }
 
 /**
- * Before writing a new patch under `test-projects/_preview/`, remove all existing files there
+ * Before writing a new patch under `preview-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

@@ -22,6 +22,8 @@ export function buildWorkspaceContext(
     projectRoot: root,
     packageRoot: pkg,
     sdkHomeApiBaseUrl: options.sdkHomeApiBaseUrl,
+    remoteConfigPath: options.remoteConfigPath,
+    iosSdkRoot: options.iosSdkRoot,
     android: detectAndroid(root, { appTarget: options.appTarget }),
     ios: detectIOS(root, { appTarget: options.appTarget }),
     iosReserved: iosToolingReserved,

package/src/index.ts

@@ -80,6 +80,13 @@ export {
   isTopSdkFeatureModuleEnabled,
 } from "./config/topsdkFeatureModules.js";
 export { clearPreviewPatchFilesIfTargetInside, resolveDefaultPreviewPatchDir } from "./core/previewPatches.js";
+export {
+  MEET_SDK_TOOL_CACHE_ROOT,
+  ensureCacheRoot,
+  resolveIosSdkCacheLayout,
+  resolveRemoteConfigCachePath,
+  writeRemoteConfigCache,
+} from "./cache.js";
 export { buildWorkspaceContext, resolvePackageRoot } from "./core/workspace.js";
 export { runPipeline } from "./core/pipeline.js";
 export { generatePatchForFile } from "./core/patch.js";