@leonxin/meetgames 0.1.8 → 0.1.12

package/src/config/meetSdkRemoteConfig.ts

@@ -0,0 +1,1215 @@
+/**
+ * TOPSDK 能力：开关与参数均在 `sdkModules` 下。
+ * **integrate 是否接入某插件**：只看 JSON 是否写了对应子键（如 `kakao`、`appsflyer`、`facebookdata`）；有键则 value 必为 `{…}` / `{}`，无配置则不写该键。
+ * **登录 Facebook**（`login.facebook`）与 **埋点 Facebook Data**（`analytics.facebookdata`）子键名可区分。
+ * 不再使用顶层 `facebook` / `google` / `appsflyer` / `parameterConfig`，也不再用扁平 `features` / `featuresByCategory`。
+ *
+ * `console/openSDK/getSDKConfig` 服务端：gp-sdk `SDKDownloadController`（`VOSDKConfig` 仅含 `channelAuthConfig`）；
+ * `VOChannelAuthConfig` 使用 `clientId` / `scheme` / `secret` 等。`openSDK/downloadSDKConfig`（gp-sdk）从 DB 组装 `meetsdk-remote-config.json`；
+ * `sdk-home` 负责 SDK 最新版本发现和 iOS SDK 包下载。
+ */
+import { collectTopSdkFeatureRepositories } from "./topsdkFeatureModules.js";
+
+/** integrate / Gradle 依赖：写了子键且 value 为对象（gp-sdk 有键则必为 `{…}` / `{}`）。 */
+export function hasSdkModuleKey(scope: Record<string, unknown>, subKey: string): boolean {
+  if (!Object.prototype.hasOwnProperty.call(scope, subKey)) return false;
+  const v = scope[subKey];
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+
+/** 子模块带凭证对象（用于 default 合并、校验等）；`false` / 缺失视为无凭证。 */
+export function isSdkModuleToggleOn(value: unknown): boolean {
+  if (value === true) return true;
+  if (typeof value === "object" && value !== null && !Array.isArray(value)) return true;
+  return false;
+}
+
+/** `login.facebook`：为 `false` / 未写表示关闭；对象表示开启并写入 Gradle resValue。 */
+export interface MeetSdkLoginFacebookCredentials {
+  facebookAppId: string;
+  fbLoginProtocolScheme: string;
+  facebookClientToken: string;
+  name?: string;
+  openMessenger?: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+
+export type MeetSdkLoginFacebookModule = false | MeetSdkLoginFacebookCredentials;
+
+/** `login.google` */
+export interface MeetSdkLoginGoogleCredentials {
+  googleClientId: string;
+  scheme?: string;
+  reversedClientId?: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+
+export type MeetSdkLoginGoogleModule = false | MeetSdkLoginGoogleCredentials;
+
+/** `login.twitter`（与控制台 `authType: TWITTER` 字段对齐：`clientId` / `secret` / `redirect`） */
+export interface MeetSdkLoginTwitterCredentials {
+  clientId: string;
+  secret: string;
+  redirect: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+export type MeetSdkLoginTwitterModule = false | MeetSdkLoginTwitterCredentials;
+
+/** `login.snapchat` */
+export interface MeetSdkLoginSnapchatCredentials {
+  clientId: string;
+  redirect: string;
+  scheme?: string;
+  /** 控制台可能无此项 */
+  secret?: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+export type MeetSdkLoginSnapchatModule = false | MeetSdkLoginSnapchatCredentials;
+
+/** `login.line` */
+export interface MeetSdkLoginLineCredentials {
+  clientId: string;
+  scheme?: string;
+  redirect?: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+export type MeetSdkLoginLineModule = false | MeetSdkLoginLineCredentials;
+
+/** `login.naver` */
+export interface MeetSdkLoginNaverCredentials {
+  clientId: string;
+  secret: string;
+  name: string;
+  scheme?: string;
+  redirect?: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+export type MeetSdkLoginNaverModule = false | MeetSdkLoginNaverCredentials;
+
+/** `login.kakao`（`scheme` 对应 Kakao 自定义 URL scheme） */
+export interface MeetSdkLoginKakaoCredentials {
+  clientId: string;
+  scheme: string;
+  repositories?: string[];
+  dependencies?: MeetSdkGradleDependency[];
+}
+export type MeetSdkLoginKakaoModule = false | MeetSdkLoginKakaoCredentials;
+
+/** `login.tiktok` */
+export interface MeetSdkLoginTiktokCredentials {
+  clientId: string;
+  secret: string;
+  redirect: string;
+  repositories?: string[];
+  dependencies?: MeetSdkGradleDependency[];
+}
+export type MeetSdkLoginTiktokModule = false | MeetSdkLoginTiktokCredentials;
+
+/** `login.discord` */
+export interface MeetSdkLoginDiscordCredentials {
+  clientId: string;
+  secret: string;
+  redirect: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+export type MeetSdkLoginDiscordModule = false | MeetSdkLoginDiscordCredentials;
+
+export interface MeetSdkGradleDependency {
+  implementation: string;
+}
+
+export interface MeetSdkSimplePluginConfig {
+  repositories?: string[];
+  dependencies?: MeetSdkGradleDependency[];
+}
+
+export type MeetSdkSimpleModule = false | MeetSdkSimplePluginConfig;
+
+/** `analytics.appsflyer` */
+export interface MeetSdkAnalyticsAppsflyerCredentials {
+  devKey: string;
+  clientId?: string;
+  appleAppId?: string;
+  enableDebugLog: boolean;
+  repositories?: string[];
+  dependencies?: MeetSdkGradleDependency[];
+}
+
+export type MeetSdkAnalyticsAppsflyerModule = false | MeetSdkAnalyticsAppsflyerCredentials;
+
+/** `analytics.firebase`：配置文件远程地址；落盘目录由 meet-sdk-tool 检测 app module，文件名为 `firebase_file_name`（DB `firebase_name`）。 */
+export interface MeetSdkAnalyticsFirebaseCredentials {
+  firebase_file_url: string;
+  /** 落盘文件名（含后缀），来自 DB `firebase_name`；缺省为 `google-services.json` */
+  firebase_file_name?: string;
+  repositories?: string[];
+  classpath?: string;
+  applyplugin?: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+
+export type MeetSdkAnalyticsFirebaseModule = false | MeetSdkAnalyticsFirebaseCredentials;
+
+/** `analytics.adjust` */
+export interface MeetSdkAnalyticsAdjustCredentials {
+  appId: string;
+  clientId?: string;
+  eventUrl?: string;
+  enableSandbox: boolean;
+  dependencies?: MeetSdkGradleDependency[];
+}
+
+export type MeetSdkAnalyticsAdjustModule = false | MeetSdkAnalyticsAdjustCredentials;
+
+/** `analytics.facebookdata` */
+export interface MeetSdkAnalyticsFacebookDataCredentials {
+  facebookAppId?: string;
+  facebookClientToken?: string;
+  fbLoginProtocolScheme?: string;
+  name?: string;
+  dependencies?: MeetSdkGradleDependency[];
+}
+
+export type MeetSdkAnalyticsFacebookDataModule = false | MeetSdkAnalyticsFacebookDataCredentials;
+
+export interface MeetSdkLoginModules {
+  guest: MeetSdkSimpleModule;
+  email: MeetSdkSimpleModule;
+  apple: MeetSdkSimpleModule;
+  facebook: MeetSdkLoginFacebookModule;
+  google: MeetSdkLoginGoogleModule;
+  twitter: MeetSdkLoginTwitterModule;
+  snapchat: MeetSdkLoginSnapchatModule;
+  line: MeetSdkLoginLineModule;
+  naver: MeetSdkLoginNaverModule;
+  kakao: MeetSdkLoginKakaoModule;
+  tiktok: MeetSdkLoginTiktokModule;
+  discord: MeetSdkLoginDiscordModule;
+}
+
+export interface MeetSdkPaymentModules {
+  googleIap: MeetSdkSimpleModule;
+  onestoreIap: MeetSdkSimpleModule;
+  huaweiIap: MeetSdkSimpleModule;
+  xiaomiIap: MeetSdkSimpleModule;
+}
+
+export interface MeetSdkAnalyticsModules {
+  appsflyer: MeetSdkAnalyticsAppsflyerModule;
+  facebookdata: MeetSdkAnalyticsFacebookDataModule;
+  firebase: MeetSdkAnalyticsFirebaseModule;
+  adjust: MeetSdkAnalyticsAdjustModule;
+}
+
+export interface MeetSdkModuleToggles {
+  login: MeetSdkLoginModules;
+  payment: MeetSdkPaymentModules;
+  analytics: MeetSdkAnalyticsModules;
+}
+
+export type MeetSdkFeatureScope = keyof MeetSdkModuleToggles;
+
+/**
+ * TOPSDK 宿主与控制台侧标识（与 `sdkModules` 内的登录/埋点凭证分离）。
+ */
+export interface MeetSdkRemoteTopsdkBlock {
+  appId: string;
+  /** 用于 `getSDKConfig` 签名等；落盘于本地缓存，请勿提交到公开仓库。 */
+  appSecret: string;
+  version: string;
+  groupId: string;
+  repositories: string[];
+}
+
+/**
+ * Normalized remote config (local file `meetsdk-remote-config.json`).
+ * 凭证均在 `sdkModules` 内；商店渠道在根级 `channel`，app 凭证在 `topsdk`。
+ */
+export interface MeetSdkRemoteConfig {
+  /** Android `applicationId`（或与 manifest package 对齐的标识），供 resValue 等使用。 */
+  packageName: string;
+  /** 商店渠道类型，如 `GOOGLE` / `APPLE`（与 fetch-config 的 `--channel-type` 一致，大写落盘）。 */
+  channel: string;
+  /** 设备平台：`android` / `ios`（小写，来自 `channel.device_platform`）。 */
+  devicePlatform?: string;
+  topsdk: MeetSdkRemoteTopsdkBlock;
+  sdkModules: MeetSdkModuleToggles;
+}
+
+/** 读取根级渠道字段。 */
+export function readMeetSdkRemoteChannel(config: MeetSdkRemoteConfig): string {
+  const root = config.channel?.trim();
+  return root || "";
+}
+
+export interface MeetSdkDefaultConfig {
+  topsdk: {
+    version?: string;
+    date?: string;
+    groupId?: string;
+    repositories: string[];
+  };
+  sdkModules: MeetSdkModuleToggles;
+}
+
+/** 缓存文件名；`fetch-config` 固定写入 `<project-root>/` + 此文件名（不可通过 --out 修改）。 */
+export const MEETSDK_REMOTE_CONFIG_FILENAME = "meetsdk-remote-config.json";
+
+export function defaultSdkModules(): MeetSdkModuleToggles {
+  return {
+    login: {
+      guest: false,
+      email: false,
+      apple: false,
+      facebook: false,
+      google: false,
+      twitter: false,
+      snapchat: false,
+      line: false,
+      naver: false,
+      kakao: false,
+      tiktok: false,
+      discord: false,
+    },
+    payment: { googleIap: false, onestoreIap: false, huaweiIap: false, xiaomiIap: false },
+    analytics: { appsflyer: false, facebookdata: false, firebase: false, adjust: false },
+  };
+}
+
+/** 解析 downloadSDKConfig / 本地 JSON：仅保留 JSON 里出现的子键（不写则视为未配置）。 */
+export function emptySdkModules(): MeetSdkModuleToggles {
+  return {
+    login: {} as MeetSdkLoginModules,
+    payment: {} as MeetSdkPaymentModules,
+    analytics: {} as MeetSdkAnalyticsModules,
+  };
+}
+
+function isRecord(v: unknown): v is Record<string, unknown> {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+
+function str(v: unknown): string {
+  if (v === undefined || v === null) return "";
+  return String(v);
+}
+
+function optionalStr(v: unknown): string | undefined {
+  if (v === undefined || v === null) return undefined;
+  const s = String(v).trim();
+  return s.length ? s : undefined;
+}
+
+function bool(v: unknown): boolean {
+  if (typeof v === "boolean") return v;
+  if (typeof v === "string") return v === "true" || v === "1";
+  return Boolean(v);
+}
+
+function dependency(artifact: string): MeetSdkGradleDependency[] {
+  return [{ implementation: `$groupId:${artifact}:$topsdk_version` }];
+}
+
+export const DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES = {
+  login: {
+    guest: dependency("guest"),
+    email: dependency("email"),
+    apple: dependency("apple"),
+    facebook: dependency("facebook"),
+    google: dependency("google"),
+    twitter: dependency("twitter"),
+    snapchat: dependency("snapchat"),
+    line: dependency("line"),
+    naver: dependency("naver"),
+    kakao: dependency("kakao"),
+    tiktok: dependency("tiktok"),
+    discord: dependency("discord"),
+  },
+  analytics: {
+    appsflyer: dependency("appsflyer"),
+    firebase: dependency("firebase"),
+    adjust: dependency("adjust"),
+    facebookdata: dependency("facebook-data"),
+  },
+  payment: {
+    googleIap: dependency("google-iap"),
+    onestoreIap: dependency("onestore-iap"),
+    huaweiIap: dependency("huawei-iap"),
+    xiaomiIap: dependency("xiaomi-iap"),
+  },
+} as const;
+
+function parseDependencies(v: unknown, fallback: readonly MeetSdkGradleDependency[] = []): MeetSdkGradleDependency[] | undefined {
+  if (!Array.isArray(v)) return fallback.length > 0 ? [...fallback] : undefined;
+  const out: MeetSdkGradleDependency[] = [];
+  for (const raw of v) {
+    if (typeof raw === "string") {
+      out.push({ implementation: raw });
+    } else if (isRecord(raw)) {
+      out.push({ implementation: str(raw.implementation ?? raw.value ?? raw.artifact) });
+    }
+  }
+  if (out.length > 0) return out;
+  return fallback.length > 0 ? [...fallback] : undefined;
+}
+
+function parseSimpleModule(v: unknown, fallback: readonly MeetSdkGradleDependency[]): MeetSdkSimpleModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return {};
+  if (!isRecord(v)) return null;
+  const dependencies = parseDependencies(v.dependencies);
+  const repositories = Array.isArray(v.repositories) ? v.repositories.map((x) => String(x)) : undefined;
+  if (!dependencies && !repositories) return {};
+  return { ...(repositories ? { repositories } : {}), ...(dependencies ? { dependencies } : {}) };
+}
+
+/**
+ * gp-sdk `getSDKConfig` 的 `data` 往往只有 `channelAuthConfig`；版本 / groupId 可能由网关合并或嵌在 `topsdk` 中。
+ */
+function readTopSdkVersionFromData(data: Record<string, unknown> | null): string {
+  if (!data) return "0.0.0";
+  if (isRecord(data.topsdk)) {
+    const nested = str((data.topsdk as Record<string, unknown>).version);
+    if (nested) return nested;
+  }
+  const flat = str(
+    data.topsdkVersion ??
+      data.sdkVersion ??
+      data.version ??
+      data.sdkFullVersion ??
+      (data as { topSdkVersion?: unknown }).topSdkVersion
+  );
+  return flat || "0.0.0";
+}
+
+function readGroupIdFromData(data: Record<string, unknown> | null): string {
+  if (!data) return "com.sino.topsdk";
+  if (isRecord(data.topsdk)) {
+    const nested = str((data.topsdk as Record<string, unknown>).groupId);
+    if (nested) return nested;
+  }
+  const flat = str(data.groupId ?? (data as { mavenGroupId?: unknown }).mavenGroupId ?? (data as { group_id?: unknown }).group_id);
+  return flat || "com.sino.topsdk";
+}
+
+function readRepositoriesFromData(data: Record<string, unknown> | null): string[] {
+  if (!data) return [];
+  const raw = data.repositories ?? (data as { mavenRepositories?: unknown }).mavenRepositories;
+  if (Array.isArray(raw)) return raw.map((x) => String(x));
+  return [];
+}
+
+function parseLoginFacebookModule(v: unknown): MeetSdkLoginFacebookModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    facebookAppId: str(v.clientId),
+    fbLoginProtocolScheme: str(v.scheme),
+    facebookClientToken: str(v.secret),
+    name: optionalStr(v.name),
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseLoginGoogleModule(v: unknown): MeetSdkLoginGoogleModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    googleClientId: str(v.clientId),
+    scheme: optionalStr(v.scheme),
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseLoginTwitterModule(v: unknown): MeetSdkLoginTwitterModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    clientId: str(v.clientId),
+    secret: str(v.secret),
+    redirect: str(v.redirect),
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseLoginSnapchatModule(v: unknown): MeetSdkLoginSnapchatModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  const secret = str(v.secret);
+  const base: MeetSdkLoginSnapchatCredentials = {
+    clientId: str(v.clientId),
+    redirect: str(v.redirect),
+    scheme: optionalStr(v.scheme),
+    dependencies: parseDependencies(v.dependencies),
+  };
+  if (secret) base.secret = secret;
+  return base;
+}
+
+function parseLoginLineModule(v: unknown): MeetSdkLoginLineModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    clientId: str(v.clientId),
+    scheme: optionalStr(v.scheme),
+    redirect: optionalStr(v.redirect),
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseLoginNaverModule(v: unknown): MeetSdkLoginNaverModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    clientId: str(v.clientId),
+    secret: str(v.secret),
+    name: str(v.name),
+    scheme: optionalStr(v.scheme),
+    redirect: optionalStr(v.redirect),
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseLoginKakaoModule(v: unknown): MeetSdkLoginKakaoModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    clientId: str(v.clientId),
+    scheme: str(v.scheme),
+    repositories: Array.isArray(v.repositories) ? v.repositories.map((x) => String(x)) : undefined,
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseLoginTiktokModule(v: unknown): MeetSdkLoginTiktokModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    clientId: str(v.clientId),
+    secret: str(v.secret),
+    redirect: str(v.redirect),
+    repositories: Array.isArray(v.repositories) ? v.repositories.map((x) => String(x)) : undefined,
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseLoginDiscordModule(v: unknown): MeetSdkLoginDiscordModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    clientId: str(v.clientId),
+    secret: str(v.secret),
+    redirect: str(v.redirect),
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseAnalyticsFirebaseModule(v: unknown): MeetSdkAnalyticsFirebaseModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    firebase_file_url: str(v.firebaseUrl),
+    firebase_file_name: optionalStr(v.firebaseName),
+    repositories: Array.isArray(v.repositories) ? v.repositories.map((x) => String(x)) : undefined,
+    classpath: str(v.classpath),
+    applyplugin: str(v.applyplugin ?? v.applyPlugin),
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseAnalyticsAdjustModule(v: unknown): MeetSdkAnalyticsAdjustModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  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),
+  };
+}
+
+function parseAnalyticsFacebookDataModule(v: unknown): MeetSdkAnalyticsFacebookDataModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    facebookAppId: optionalStr(v.clientId),
+    facebookClientToken: optionalStr(v.secret),
+    fbLoginProtocolScheme: optionalStr(v.scheme),
+    name: optionalStr(v.name),
+    dependencies: parseDependencies(v.dependencies),
+  };
+}
+
+function parseAnalyticsAppsflyerModule(v: unknown): MeetSdkAnalyticsAppsflyerModule | null {
+  if (v === undefined || v === false || v === null) return false;
+  if (v === true) return null;
+  if (!isRecord(v)) return null;
+  return {
+    devKey: str(v.devKey),
+    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),
+  };
+}
+
+/** downloadSDKConfig：子键存在时 value 必须为 JSON 对象（含 `{}`）。 */
+function isSdkModuleJsonObject(v: unknown): v is Record<string, unknown> {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+
+/**
+ * 从 JSON 提取 `sdkModules`：仅保留出现的子键；有键则 value 须为对象。
+ * @returns `null` 表示形状非法（例如 `"kakao": false` 或 `true`）。
+ */
+export function normalizeSdkModulesFromUnknown(raw: unknown): MeetSdkModuleToggles | null {
+  const d = emptySdkModules();
+  if (!isRecord(raw)) return d;
+
+  if (isRecord(raw.login)) {
+    const L = raw.login;
+    if ("parameterConfig" in L || "parameter" in L) return null;
+    if ("guest" in L) {
+      if (!isSdkModuleJsonObject(L.guest)) return null;
+      const x = parseSimpleModule(L.guest, DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.guest);
+      if (x === null || x === false) return null;
+      d.login.guest = x;
+    }
+    if ("email" in L) {
+      if (!isSdkModuleJsonObject(L.email)) return null;
+      const x = parseSimpleModule(L.email, DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.email);
+      if (x === null || x === false) return null;
+      d.login.email = x;
+    }
+    if ("apple" in L) {
+      if (!isSdkModuleJsonObject(L.apple)) return null;
+      const x = parseSimpleModule(L.apple, DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.login.apple);
+      if (x === null || x === false) return null;
+      d.login.apple = x;
+    }
+    if ("facebook" in L) {
+      if (!isSdkModuleJsonObject(L.facebook)) return null;
+      const fb = parseLoginFacebookModule(L.facebook);
+      if (fb === null || fb === false) return null;
+      d.login.facebook = fb;
+    }
+    if ("google" in L) {
+      if (!isSdkModuleJsonObject(L.google)) return null;
+      const g = parseLoginGoogleModule(L.google);
+      if (g === null || g === false) return null;
+      d.login.google = g;
+    }
+    if ("twitter" in L) {
+      if (!isSdkModuleJsonObject(L.twitter)) return null;
+      const x = parseLoginTwitterModule(L.twitter);
+      if (x === null || x === false) return null;
+      d.login.twitter = x;
+    }
+    if ("snapchat" in L) {
+      if (!isSdkModuleJsonObject(L.snapchat)) return null;
+      const x = parseLoginSnapchatModule(L.snapchat);
+      if (x === null || x === false) return null;
+      d.login.snapchat = x;
+    }
+    if ("line" in L) {
+      if (!isSdkModuleJsonObject(L.line)) return null;
+      const x = parseLoginLineModule(L.line);
+      if (x === null || x === false) return null;
+      d.login.line = x;
+    }
+    if ("naver" in L) {
+      if (!isSdkModuleJsonObject(L.naver)) return null;
+      const x = parseLoginNaverModule(L.naver);
+      if (x === null || x === false) return null;
+      d.login.naver = x;
+    }
+    if ("kakao" in L) {
+      if (!isSdkModuleJsonObject(L.kakao)) return null;
+      const x = parseLoginKakaoModule(L.kakao);
+      if (x === null || x === false) return null;
+      d.login.kakao = x;
+    }
+    if ("tiktok" in L) {
+      if (!isSdkModuleJsonObject(L.tiktok)) return null;
+      const x = parseLoginTiktokModule(L.tiktok);
+      if (x === null || x === false) return null;
+      d.login.tiktok = x;
+    }
+    if ("discord" in L) {
+      if (!isSdkModuleJsonObject(L.discord)) return null;
+      const x = parseLoginDiscordModule(L.discord);
+      if (x === null || x === false) return null;
+      d.login.discord = x;
+    }
+  }
+  if (isRecord(raw.payment)) {
+    const P = raw.payment;
+    if ("googleIap" in P) {
+      if (!isSdkModuleJsonObject(P.googleIap)) return null;
+      const x = parseSimpleModule(P.googleIap, DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.googleIap);
+      if (x === null || x === false) return null;
+      d.payment.googleIap = x;
+    }
+    if ("onestoreIap" in P) {
+      if (!isSdkModuleJsonObject(P.onestoreIap)) return null;
+      const x = parseSimpleModule(P.onestoreIap, DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.onestoreIap);
+      if (x === null || x === false) return null;
+      d.payment.onestoreIap = x;
+    }
+    if ("huaweiIap" in P) {
+      if (!isSdkModuleJsonObject(P.huaweiIap)) return null;
+      const x = parseSimpleModule(P.huaweiIap, DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.huaweiIap);
+      if (x === null || x === false) return null;
+      d.payment.huaweiIap = x;
+    }
+    if ("xiaomiIap" in P) {
+      if (!isSdkModuleJsonObject(P.xiaomiIap)) return null;
+      const x = parseSimpleModule(P.xiaomiIap, DEFAULT_TOPSDK_PLUGIN_DEPENDENCIES.payment.xiaomiIap);
+      if (x === null || x === false) return null;
+      d.payment.xiaomiIap = x;
+    }
+  }
+  if (isRecord(raw.analytics)) {
+    const A = raw.analytics;
+    if ("appsflyer" in A) {
+      if (!isSdkModuleJsonObject(A.appsflyer)) return null;
+      const af = parseAnalyticsAppsflyerModule(A.appsflyer);
+      if (af === null || af === false) return null;
+      d.analytics.appsflyer = af;
+    }
+    if ("facebookdata" in A) {
+      if (!isSdkModuleJsonObject(A.facebookdata)) return null;
+      const x = parseAnalyticsFacebookDataModule(A.facebookdata);
+      if (x === null || x === false) return null;
+      d.analytics.facebookdata = x;
+    } else if ("facebook" in A) {
+      if (!isSdkModuleJsonObject(A.facebook)) return null;
+      const x = parseAnalyticsFacebookDataModule(A.facebook);
+      if (x === null || x === false) return null;
+      d.analytics.facebookdata = x;
+    }
+    if ("firebase" in A) {
+      if (!isSdkModuleJsonObject(A.firebase)) return null;
+      const f = parseAnalyticsFirebaseModule(A.firebase);
+      if (f === null || f === false) return null;
+      d.analytics.firebase = f;
+    }
+    if ("adjust" in A) {
+      if (!isSdkModuleJsonObject(A.adjust)) return null;
+      const adj = parseAnalyticsAdjustModule(A.adjust);
+      if (adj === null || adj === false) return null;
+      d.analytics.adjust = adj;
+    }
+  }
+  return d;
+}
+
+/**
+ * Maps TOPSDK `getSDKConfig` JSON (`code` / `data` / `data.channelAuthConfig`) into MeetSdkRemoteConfig.
+ * Applies the same MESSENGER→FACEBOOK naming tweak as topsdk-tool-ios `ChannelConfigManager.getSdkConfig`.
+ */
+export function mapTopSdkGetSdkConfigToMeetSdkRemoteConfig(
+  body: unknown,
+  ctx: { appId: string; appSecret: string; channelType: string; packageName: string }
+): MeetSdkRemoteConfig {
+  const channel = ctx.channelType.trim().toUpperCase() || "UNKNOWN";
+
+  const base = (data: Record<string, unknown> | null): MeetSdkRemoteConfig => ({
+    packageName: str(isRecord(data) ? data.packageName : undefined) || ctx.packageName || "",
+    channel,
+    topsdk: {
+      appId: str(data?.appId ?? ctx.appId),
+      appSecret: ctx.appSecret,
+      version: readTopSdkVersionFromData(data),
+      groupId: readGroupIdFromData(data),
+      repositories: readRepositoriesFromData(data),
+    },
+    sdkModules: emptySdkModules(),
+  });
+
+  if (!isRecord(body)) {
+    return base(null);
+  }
+
+  const code = body.code;
+  if (code !== 200 && code !== "200") {
+    throw new Error(`TOPSDK getSDKConfig returned code=${String(code)}`);
+  }
+
+  const data = isRecord(body.data) ? body.data : null;
+  if (!data) {
+    return base(null);
+  }
+
+  const out = base(data);
+  out.topsdk.appId = str(data.appId ?? ctx.appId);
+  out.topsdk.appSecret = ctx.appSecret;
+
+  const list = data.channelAuthConfig;
+  if (!Array.isArray(list)) {
+    return out;
+  }
+
+  for (const raw of list) {
+    if (!isRecord(raw)) continue;
+    const item: Record<string, unknown> = { ...raw };
+    let name = str(item.authType).toUpperCase();
+    if (name === "MESSENGER") {
+      name = "FACEBOOK";
+      item.openMessenger = "1";
+    }
+    if (name === "FACEBOOK") {
+      if (item.openMessenger === undefined || item.openMessenger === null) {
+        item.openMessenger = "0";
+      }
+    }
+
+    switch (name) {
+      case "FACEBOOK":
+        out.sdkModules.login.facebook = {
+          facebookAppId: str(item.clientId),
+          fbLoginProtocolScheme: str(item.scheme),
+          facebookClientToken: str(item.clientToken ?? item.facebookClientToken ?? item.secret),
+          name: optionalStr(item.name ?? item.facebookDisplayName ?? item.displayName),
+          openMessenger: optionalStr(item.openMessenger),
+        };
+        break;
+      case "GOOGLE":
+        out.sdkModules.login.google = {
+          googleClientId: str(item.clientId),
+          scheme: optionalStr(item.scheme ?? item.reversedClientId ?? item.reversed_client_id),
+          reversedClientId: optionalStr(item.reversedClientId ?? item.reversed_client_id),
+        };
+        break;
+      case "APPSFLYER":
+        out.sdkModules.analytics.appsflyer = {
+          enableDebugLog: bool(item.enableDebugLog ?? item.appsflyerEnableDebugLog),
+          devKey: str(item.devKey ?? item.secret ?? item.clientId),
+          clientId: optionalStr(item.clientId),
+          appleAppId: optionalStr(item.appleAppId ?? item.appId),
+        };
+        break;
+      case "FIREBASE":
+        out.sdkModules.analytics.firebase = {
+          firebase_file_url: str(
+            item.firebase_file_url ?? item.googleServicesUrl ?? item.configUrl ?? item.clientId ?? item.url
+          ),
+        };
+        break;
+      case "ADJUST":
+        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;
+      case "GUEST":
+        out.sdkModules.login.guest = {};
+        break;
+      case "EMAIL":
+        out.sdkModules.login.email = {};
+        break;
+      case "APPLE":
+      case "APPLESIGNIN":
+      case "APPLE_SIGNIN":
+        out.sdkModules.login.apple = {};
+        break;
+      case "TWITTER":
+        out.sdkModules.login.twitter = {
+          clientId: str(item.clientId),
+          secret: str(item.secret),
+          redirect: str(item.redirect),
+        };
+        break;
+      case "SNAPCHAT":
+        out.sdkModules.login.snapchat = {
+          clientId: str(item.clientId),
+          redirect: str(item.redirect),
+          scheme: optionalStr(item.scheme),
+          ...(str(item.secret) ? { secret: str(item.secret) } : {}),
+        };
+        break;
+      case "LINE":
+        out.sdkModules.login.line = {
+          clientId: str(item.clientId),
+          scheme: optionalStr(item.scheme),
+          redirect: optionalStr(item.redirect),
+        };
+        break;
+      case "NAVER":
+        out.sdkModules.login.naver = {
+          clientId: str(item.clientId),
+          secret: str(item.secret),
+          name: str(item.name),
+          scheme: optionalStr(item.scheme),
+          redirect: optionalStr(item.redirect),
+        };
+        break;
+      case "KAKAO":
+        out.sdkModules.login.kakao = {
+          clientId: str(item.clientId),
+          scheme: str(item.scheme),
+        };
+        break;
+      case "TIKTOK":
+        out.sdkModules.login.tiktok = {
+          clientId: str(item.clientId),
+          secret: str(item.secret),
+          redirect: str(item.redirect),
+        };
+        break;
+      case "DISCORD":
+        out.sdkModules.login.discord = {
+          clientId: str(item.clientId),
+          secret: str(item.secret),
+          redirect: str(item.redirect),
+        };
+        break;
+      case "GOOGLEIAP":
+      case "GOOGLE_IAP":
+        out.sdkModules.payment.googleIap = {};
+        break;
+      case "ONESTOREIAP":
+      case "ONESTORE_IAP":
+        out.sdkModules.payment.onestoreIap = {};
+        break;
+      case "HUAWEIIAP":
+      case "HUAWEI_IAP":
+        out.sdkModules.payment.huaweiIap = {};
+        break;
+      case "XIAOMIIAP":
+      case "XIAOMI_IAP":
+        out.sdkModules.payment.xiaomiIap = {};
+        break;
+      default:
+        break;
+    }
+  }
+
+  return out;
+}
+
+export function getValueByPath(obj: unknown, dotPath: string): unknown {
+  if (!isRecord(obj)) return undefined;
+  const keys = dotPath.split(".");
+  let current: unknown = obj;
+  for (const key of keys) {
+    if (!isRecord(current)) return undefined;
+    current = current[key];
+  }
+  return current;
+}
+
+function isMissingValue(value: unknown): boolean {
+  if (value === undefined || value === null) return true;
+  if (typeof value === "string" && value.trim() === "") return true;
+  return false;
+}
+
+export function tryParseAsMeetSdkRemoteConfig(raw: unknown): MeetSdkRemoteConfig | null {
+  if (!isRecord(raw)) return null;
+  if (typeof raw.packageName !== "string" || !isRecord(raw.topsdk)) return null;
+  const topsdk = raw.topsdk as Record<string, unknown>;
+  const channel = str(raw.channel);
+  if (!channel || typeof topsdk.appId !== "string" || typeof topsdk.appSecret !== "string") {
+    return null;
+  }
+  if ("features" in raw || "featuresByCategory" in raw) return null;
+  if ("facebook" in raw || "google" in raw || "appsflyer" in raw) return null;
+  if ("parameterConfig" in raw) return null;
+  if ("repositories" in raw) return null;
+  if (!("sdkModules" in raw) || !isRecord(raw.sdkModules)) return null;
+  const sdkModules = normalizeSdkModulesFromUnknown(raw.sdkModules);
+  if (sdkModules === null) return null;
+  const normalizedTopsdk: MeetSdkRemoteTopsdkBlock = {
+    appId: topsdk.appId,
+    appSecret: topsdk.appSecret,
+    version: str(topsdk.version),
+    groupId: str(topsdk.groupId),
+    repositories: Array.isArray(topsdk.repositories) ? topsdk.repositories.map((x) => String(x)) : [],
+  };
+  const devicePlatform = str(raw.devicePlatform).toLowerCase();
+  return {
+    packageName: String(raw.packageName),
+    channel,
+    devicePlatform: devicePlatform || undefined,
+    topsdk: normalizedTopsdk,
+    sdkModules,
+  };
+}
+
+export function tryParseAsMeetSdkDefaultConfig(raw: unknown): MeetSdkDefaultConfig | null {
+  if (!isRecord(raw)) return null;
+  const topsdkRaw = isRecord(raw.topsdk) ? raw.topsdk : {};
+  const sdkModules = normalizeSdkModulesFromUnknown(isRecord(raw.sdkModules) ? raw.sdkModules : {});
+  if (sdkModules === null) return null;
+  return {
+    topsdk: {
+      version: str(topsdkRaw.version) || undefined,
+      date: str(topsdkRaw.date) || undefined,
+      groupId: str(topsdkRaw.groupId) || undefined,
+      repositories: Array.isArray(topsdkRaw.repositories) ? topsdkRaw.repositories.map((x) => String(x)) : [],
+    },
+    sdkModules,
+  };
+}
+
+function cloneConfig<T>(value: T): T {
+  if (value === undefined) return value;
+  return JSON.parse(JSON.stringify(value, (_k, v) => (v === undefined ? null : v))) as T;
+}
+
+function mergeSdkModuleValue(remoteValue: unknown, defaultValue: unknown): unknown {
+  if (!isSdkModuleToggleOn(remoteValue)) return remoteValue;
+  if (!isRecord(defaultValue)) return remoteValue;
+  if (!isRecord(remoteValue)) return cloneConfig(defaultValue);
+
+  const merged: Record<string, unknown> = { ...cloneConfig(defaultValue), ...cloneConfig(remoteValue) };
+  for (const [key, value] of Object.entries(defaultValue)) {
+    if (value === undefined) continue;
+    if (merged[key] === undefined || merged[key] === null || merged[key] === "") {
+      merged[key] = cloneConfig(value);
+    }
+  }
+  return merged;
+}
+
+function mergeSdkModuleScope(
+  remoteScope: Record<string, unknown>,
+  defaultScope: Record<string, unknown>
+): Record<string, unknown> {
+  const out: Record<string, unknown> = { ...remoteScope };
+  for (const key of Object.keys(remoteScope)) {
+    out[key] = mergeSdkModuleValue(remoteScope[key], defaultScope[key]);
+  }
+  return out;
+}
+
+export function applyMeetSdkDefaultConfig(
+  remote: MeetSdkRemoteConfig,
+  defaults: MeetSdkDefaultConfig
+): MeetSdkRemoteConfig {
+  const out = cloneConfig(remote);
+  out.topsdk = {
+    ...out.topsdk,
+    version: out.topsdk.version || defaults.topsdk.version || "",
+    groupId: out.topsdk.groupId || defaults.topsdk.groupId || "",
+    repositories: out.topsdk.repositories.length > 0 ? out.topsdk.repositories : defaults.topsdk.repositories,
+  };
+
+  out.sdkModules = {
+    login: mergeSdkModuleScope(
+      out.sdkModules.login as unknown as Record<string, unknown>,
+      defaults.sdkModules.login as unknown as Record<string, unknown>
+    ) as unknown as MeetSdkLoginModules,
+    payment: mergeSdkModuleScope(
+      out.sdkModules.payment as unknown as Record<string, unknown>,
+      defaults.sdkModules.payment as unknown as Record<string, unknown>
+    ) as unknown as MeetSdkPaymentModules,
+    analytics: mergeSdkModuleScope(
+      out.sdkModules.analytics as unknown as Record<string, unknown>,
+      defaults.sdkModules.analytics as unknown as Record<string, unknown>
+    ) as unknown as MeetSdkAnalyticsModules,
+  };
+
+  return out;
+}
+
+function appendRepositories(out: string[], repositories: readonly string[] | undefined): void {
+  if (!repositories) return;
+  for (const repo of repositories) {
+    if (!out.includes(repo)) out.push(repo);
+  }
+}
+
+/** Repositories for enabled `sdkModules` keys (from remote JSON) plus TopSdk host repos. */
+export function collectMeetSdkRemoteRepositories(data: MeetSdkRemoteConfig): string[] {
+  const out = collectTopSdkFeatureRepositories(data);
+  appendRepositories(out, data.topsdk.repositories);
+  return out;
+}
+
+export function collectMeetSdkRemoteBuildscriptRepositories(data: MeetSdkRemoteConfig): string[] {
+  const analytics = data.sdkModules.analytics as unknown as Record<string, unknown>;
+  if (!hasSdkModuleKey(analytics, "firebase")) return [];
+  const firebase = data.sdkModules.analytics.firebase;
+  if (typeof firebase !== "object" || firebase === null || !firebase.classpath) return [];
+  const out: string[] = [];
+  appendRepositories(out, firebase.repositories);
+  return out;
+}
+
+export function collectMeetSdkRemoteBuildscriptClasspaths(data: MeetSdkRemoteConfig): string[] {
+  const analytics = data.sdkModules.analytics as unknown as Record<string, unknown>;
+  if (!hasSdkModuleKey(analytics, "firebase")) return [];
+  const firebase = data.sdkModules.analytics.firebase;
+  if (typeof firebase !== "object" || firebase === null || !firebase.classpath) return [];
+  return [firebase.classpath];
+}
+
+export function collectMeetSdkRemoteApplyPlugins(data: MeetSdkRemoteConfig): string[] {
+  const analytics = data.sdkModules.analytics as unknown as Record<string, unknown>;
+  if (!hasSdkModuleKey(analytics, "firebase")) return [];
+  const firebase = data.sdkModules.analytics.firebase;
+  if (typeof firebase !== "object" || firebase === null || !firebase.applyplugin) return [];
+  return [firebase.applyplugin];
+}
+
+/** Gradle `plugins { id '…' }` entry (Firebase google-services). */
+export interface MeetSdkGradlePluginDslSpec {
+  id: string;
+  version?: string;
+  applyFalse?: boolean;
+}
+
+function firebaseGradlePluginVersion(classpath: string | undefined): string | undefined {
+  if (!classpath) return undefined;
+  const parts = classpath.split(":");
+  return parts.length >= 3 ? parts[2] : undefined;
+}
+
+/** Module-level `plugins { id 'com.google.gms.google-services' }` (version declared on root). */
+export function collectMeetSdkRemotePluginsDslForModule(data: MeetSdkRemoteConfig): MeetSdkGradlePluginDslSpec[] {
+  const analytics = data.sdkModules.analytics as unknown as Record<string, unknown>;
+  if (!hasSdkModuleKey(analytics, "firebase")) return [];
+  const firebase = data.sdkModules.analytics.firebase;
+  if (typeof firebase !== "object" || firebase === null || !firebase.applyplugin) return [];
+  return [{ id: firebase.applyplugin }];
+}
+
+/** Root-level `plugins { id '…' version '…' apply false }` for Firebase. */
+export function collectMeetSdkRemotePluginsDslForRoot(data: MeetSdkRemoteConfig): MeetSdkGradlePluginDslSpec[] {
+  const analytics = data.sdkModules.analytics as unknown as Record<string, unknown>;
+  if (!hasSdkModuleKey(analytics, "firebase")) return [];
+  const firebase = data.sdkModules.analytics.firebase;
+  if (typeof firebase !== "object" || firebase === null || !firebase.applyplugin) return [];
+  const version = firebaseGradlePluginVersion(firebase.classpath);
+  if (!version) return [];
+  return [{ id: firebase.applyplugin, version, applyFalse: true }];
+}
+
+/**
+ * Validates populated sections (same spirit as sdk-integration-agent `validateRequiredConfig`):
+ * 仅当子模块为参数对象时校验其字段；缺失键或 `false` 表示关闭。
+ */
+/** CLI overrides applied after `downloadSDKConfig` (appId/channelType only; secret & packageName come from server JSON). */
+export function applyFetchConfigCliOverrides(
+  config: MeetSdkRemoteConfig,
+  overrides: {
+    appId?: string;
+    channelType?: string;
+  }
+): MeetSdkRemoteConfig {
+  const out = cloneConfig(config);
+  if (overrides.appId?.trim()) {
+    out.topsdk.appId = overrides.appId.trim();
+  }
+  if (overrides.channelType?.trim()) {
+    out.channel = overrides.channelType.trim().toUpperCase();
+  }
+  return out;
+}
+
+export function validateMeetSdkRemoteConfig(data: MeetSdkRemoteConfig): { ok: boolean; missing: string[] } {
+  const missing: string[] = [];
+  const need = (path: string, reportPath = path) => {
+    if (isMissingValue(getValueByPath(data, path))) missing.push(reportPath);
+  };
+
+  need("packageName");
+  need("channel");
+  need("topsdk.appId");
+  need("topsdk.appSecret");
+
+  const login = data.sdkModules.login as unknown as Record<string, unknown>;
+  const payment = data.sdkModules.payment as unknown as Record<string, unknown>;
+  const analytics = data.sdkModules.analytics as unknown as Record<string, unknown>;
+
+  if (hasSdkModuleKey(login, "facebook")) {
+    need("sdkModules.login.facebook.facebookAppId", "sdkModules.login.facebook.clientId");
+    need("sdkModules.login.facebook.fbLoginProtocolScheme", "sdkModules.login.facebook.scheme");
+    need("sdkModules.login.facebook.facebookClientToken", "sdkModules.login.facebook.secret");
+  }
+
+  if (hasSdkModuleKey(login, "google")) {
+    need("sdkModules.login.google.googleClientId", "sdkModules.login.google.clientId");
+  }
+
+  if (hasSdkModuleKey(analytics, "appsflyer")) {
+    const af = data.sdkModules.analytics.appsflyer;
+    if (typeof af === "object" && af !== null) {
+      need("sdkModules.analytics.appsflyer.devKey");
+      if (af.enableDebugLog === undefined || af.enableDebugLog === null) {
+        missing.push("sdkModules.analytics.appsflyer.enableDebugLog");
+      }
+    }
+  }
+
+  if (hasSdkModuleKey(login, "twitter")) {
+    need("sdkModules.login.twitter.clientId");
+    need("sdkModules.login.twitter.secret");
+    need("sdkModules.login.twitter.redirect");
+  }
+
+  if (hasSdkModuleKey(login, "snapchat")) {
+    need("sdkModules.login.snapchat.clientId");
+    need("sdkModules.login.snapchat.redirect");
+  }
+
+  if (hasSdkModuleKey(login, "line")) {
+    need("sdkModules.login.line.clientId");
+  }
+
+  if (hasSdkModuleKey(login, "naver")) {
+    need("sdkModules.login.naver.clientId");
+    need("sdkModules.login.naver.secret");
+    need("sdkModules.login.naver.name");
+  }
+
+  if (hasSdkModuleKey(login, "kakao")) {
+    need("sdkModules.login.kakao.clientId");
+    need("sdkModules.login.kakao.scheme");
+  }
+
+  if (hasSdkModuleKey(login, "tiktok")) {
+    need("sdkModules.login.tiktok.clientId");
+    need("sdkModules.login.tiktok.secret");
+    need("sdkModules.login.tiktok.redirect");
+  }
+
+  if (hasSdkModuleKey(login, "discord")) {
+    need("sdkModules.login.discord.clientId");
+    need("sdkModules.login.discord.secret");
+    need("sdkModules.login.discord.redirect");
+  }
+
+  if (hasSdkModuleKey(analytics, "firebase")) {
+    need("sdkModules.analytics.firebase.firebase_file_url", "sdkModules.analytics.firebase.firebaseUrl");
+  }
+
+  if (hasSdkModuleKey(analytics, "adjust")) {
+    const adj = data.sdkModules.analytics.adjust;
+    if (typeof adj === "object" && adj !== null) {
+      need("sdkModules.analytics.adjust.appId", "sdkModules.analytics.adjust.appCode");
+      if (adj.enableSandbox === undefined || adj.enableSandbox === null) {
+        missing.push("sdkModules.analytics.adjust.enableSandbox");
+      }
+    }
+  }
+
+  return { ok: missing.length === 0, missing };
+}