@leonxin/meetgames 0.1.8 → 0.1.11

package/src/android/meetSdkRemoteGradle.ts

@@ -0,0 +1,837 @@
+/**
+ * Gradle edits from `meetsdk-remote-config.json`, aligned with sdk-integration-agent
+ * `src/lib/gradleEditor.js` (TOPSDK marker blocks).
+ */
+import type { MeetSdkGradlePluginDslSpec, MeetSdkRemoteConfig } from "../config/meetSdkRemoteConfig.js";
+import { buildTopSdkFeatureImplementationLines } from "../config/topsdkFeatureModules.js";
+import { findBlockRange, replaceOrInsertManaged } from "./gradle.js";
+
+/** Same markers as sdk-integration-agent / topsdk-agent */
+export const TOPSDK_AUTO_START = "// >>> TOPSDK AUTO START";
+export const TOPSDK_AUTO_END = "// >>> TOPSDK AUTO END";
+export const TOPSDK_REPO_AUTO_START = "// >>> TOPSDK REPO AUTO START";
+export const TOPSDK_REPO_AUTO_END = "// >>> TOPSDK REPO AUTO END";
+export const TOPSDK_PLUGIN_AUTO_START = "// >>> TOPSDK PLUGIN AUTO START";
+export const TOPSDK_PLUGIN_AUTO_END = "// >>> TOPSDK PLUGIN AUTO END";
+
+/** resValue keys managed by TOPSDK (includes legacy keys removed on re-integrate). */
+const TOPSDK_MANAGED_RESVALUE_KEYS = [
+  "top_channel_id",
+  "top_app_id",
+  "facebook_app_id",
+  "fb_login_protocol_scheme",
+  "facebook_client_token",
+  "google_client_id",
+  "twitter_client_id",
+  "twitter_client_secret",
+  "twitter_redirect_uri",
+  "twitter_redirect_url",
+  "snapchat_client_id",
+  "snapchat_redirect_uri",
+  "snapchat_client_secret",
+  "tiktok_client_id",
+  "tiktok_client_key",
+  "tiktok_client_secret",
+  "tiktok_redirect_uri",
+  "discord_client_id",
+  "discord_client_secret",
+  "discord_redirect_uri",
+  "line_channel_id",
+  "kakao_app_id",
+  "kakao_scheme",
+  "kakao_native_app_key",
+  "kakao_uri_scheme",
+  "naver_client_id",
+  "naver_client_secret",
+  "naver_client_name",
+  "appsflyer_enable_debug_log",
+  "af_dev_key",
+  "adjust_enable_sandbox",
+  "adjust_app_token",
+  "adjust_app_id",
+  "facebook_data_app_id",
+  "facebook_data_client_token",
+  "firebase_google_services_json_url",
+] as const;
+
+/** Escape for values embedded in Gradle single-quoted strings */
+export function escapeGradleSingleQuotedString(value: string): string {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
+
+/** For Groovy `"${...}"` string templates in def assignments */
+export function escapeGroovyDoubleQuotedInner(value: string): string {
+  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+
+const RES_VALUE_KEY_RE = /resValue\s*\(\s*'[^']+'\s*,\s*'([^']+)'/;
+const IMPLEMENTATION_COORD_RE = /implementation\s+["']([^"']+)["']/;
+const APPLY_PLUGIN_ID_RE = /apply\s+plugin:\s*['"]([^'"]+)['"]/;
+const PLUGINS_DSL_ID_RE = /^\s*id\s+(?:\(\s*)?['"]([^'"]+)['"](?:\s*\))?/;
+const CLASSPATH_COORD_RE = /classpath\s+['"]([^'"]+)['"]/;
+const DEF_GROUP_ID_RE = /def\s+groupId\s*=\s*["']([^"']+)["']/;
+
+function fullBlockTextMerge(
+  blockText: string,
+  startMarker: string,
+  endMarker: string,
+  snippet: string
+): string {
+  return replaceOrInsertManaged(
+    blockText,
+    { start: 0, openBrace: 0, end: blockText.length },
+    startMarker,
+    endMarker,
+    snippet
+  );
+}
+
+function lineDeclaresRepository(line: string, repo: string): boolean {
+  const t = line.trim();
+  if (repo === "google") return /\bgoogle\s*\(\s*\)/.test(t);
+  if (repo === "mavenCentral") return /\bmavenCentral\s*\(\s*\)/.test(t);
+  if (!t.includes("maven")) return false;
+  return t.includes(repo);
+}
+
+export function extractResValueKey(line: string): string | null {
+  const m = line.trim().match(RES_VALUE_KEY_RE);
+  return m?.[1] ?? null;
+}
+
+/** Maven coordinate key for upsert: `group:artifact` (version ignored). */
+export function mavenGroupArtifactKey(coordinate: string): string {
+  const parts = coordinate.split(":");
+  return parts.length >= 2 ? `${parts[0]}:${parts[1]}` : coordinate;
+}
+
+/** @deprecated Use {@link mavenGroupArtifactKey}. */
+export const classpathCoordinateKey = mavenGroupArtifactKey;
+
+export function extractImplementationCoordContent(line: string): string | null {
+  const m = line.trim().match(IMPLEMENTATION_COORD_RE);
+  return m?.[1] ?? null;
+}
+
+function resolveGroupIdFromBlock(blockText: string, fallbackGroupId: string): string {
+  const m = blockText.match(DEF_GROUP_ID_RE);
+  return m?.[1] ?? fallbackGroupId;
+}
+
+/** Resolve `group:artifact` from implementation coord (`$groupId:ui:…` or literal `com.sino.topsdk:ui:1.0`). */
+export function implementationGroupArtifactKey(
+  coordContent: string,
+  blockText: string,
+  fallbackGroupId: string
+): string | null {
+  const parts = coordContent.split(":");
+  if (parts.length < 2) return null;
+  let group = parts[0].trim();
+  const artifact = parts[1].trim();
+  if (!artifact || artifact.includes("$")) return null;
+  if (group === "$groupId") {
+    group = resolveGroupIdFromBlock(blockText, fallbackGroupId);
+  }
+  if (!group || group.includes("$")) return null;
+  return `${group}:${artifact}`;
+}
+
+export function extractImplementationKey(
+  line: string,
+  blockText: string,
+  fallbackGroupId: string
+): string | null {
+  const content = extractImplementationCoordContent(line);
+  if (!content) return null;
+  return implementationGroupArtifactKey(content, blockText, fallbackGroupId);
+}
+
+/** Remove resValue lines whose resource name (2nd arg) is in `keys`. */
+export function removeResValueLinesByKeys(blockText: string, keys: ReadonlySet<string>): string {
+  return blockText
+    .split("\n")
+    .filter((line) => {
+      const key = extractResValueKey(line);
+      return !key || !keys.has(key);
+    })
+    .join("\n");
+}
+
+export function extractApplyPluginId(line: string): string | null {
+  const m = line.trim().match(APPLY_PLUGIN_ID_RE);
+  return m?.[1] ?? null;
+}
+
+export function extractPluginsDslId(line: string): string | null {
+  const m = line.trim().match(PLUGINS_DSL_ID_RE);
+  return m?.[1] ?? null;
+}
+
+export type ModuleGradlePluginStyle = "plugins-dsl" | "apply-plugin";
+
+/**
+ * Module uses `plugins { }` for the Android application plugin (no `apply plugin: com.android.application`).
+ */
+export function detectModuleGradlePluginStyle(content: string): ModuleGradlePluginStyle {
+  if (/apply\s+plugin:\s*['"]com\.android\.application['"]/m.test(content)) {
+    return "apply-plugin";
+  }
+  const pluginsBlock = findBlockRange(content, "plugins");
+  const androidBlock = findBlockRange(content, "android");
+  if (!pluginsBlock || (androidBlock && pluginsBlock.start > androidBlock.start)) {
+    return "apply-plugin";
+  }
+  const blockText = content.slice(pluginsBlock.openBrace + 1, pluginsBlock.end);
+  if (
+    /alias\s*\(\s*libs\.plugins\.android\.application\s*\)/.test(blockText) ||
+    /\bid\s+['"]com\.android\.application['"]/.test(blockText) ||
+    /\bid\s*\(\s*['"]com\.android\.application['"]\s*\)/.test(blockText)
+  ) {
+    return "plugins-dsl";
+  }
+  return "apply-plugin";
+}
+
+/** Remove `plugins { id '…' }` lines for the same plugin id (managed block or not). */
+export function removePluginsDslLinesByIds(text: string, pluginIds: ReadonlySet<string>): string {
+  return text
+    .split("\n")
+    .filter((line) => {
+      const id = extractPluginsDslId(line);
+      return !id || !pluginIds.has(id);
+    })
+    .join("\n");
+}
+
+export function extractClasspathCoordinate(line: string): string | null {
+  const m = line.trim().match(CLASSPATH_COORD_RE);
+  return m?.[1] ?? null;
+}
+
+/** Remove `apply plugin` lines for the same plugin id (managed block or not). */
+export function removeApplyPluginLinesByIds(text: string, pluginIds: ReadonlySet<string>): string {
+  return text
+    .split("\n")
+    .filter((line) => {
+      const id = extractApplyPluginId(line);
+      return !id || !pluginIds.has(id);
+    })
+    .join("\n");
+}
+
+/** Remove `classpath` lines with the same group:artifact as any target coordinate. */
+export function removeClasspathLinesByCoordinates(text: string, coordinates: ReadonlySet<string>): string {
+  const keys = new Set([...coordinates].map(mavenGroupArtifactKey));
+  return text
+    .split("\n")
+    .filter((line) => {
+      const coord = extractClasspathCoordinate(line);
+      if (!coord) return true;
+      return !keys.has(mavenGroupArtifactKey(coord));
+    })
+    .join("\n");
+}
+
+/** Remove repository declarations that match keys in `repositories` (google / mavenCentral / URL). */
+export function removeRepositoryLinesByKeys(blockText: string, repositories: readonly string[]): string {
+  if (!repositories.length) return blockText;
+  return blockText
+    .split("\n")
+    .filter((line) => !repositories.some((repo) => lineDeclaresRepository(line, repo)))
+    .join("\n");
+}
+
+/**
+ * Upsert repository declarations: drop existing lines for the same repo keys, then write TOPSDK REPO block.
+ */
+function repositoryToGradleLine(repo: string): string {
+  if (repo === "google") return "        google()";
+  if (repo === "mavenCentral") return "        mavenCentral()";
+  return `        maven { url '${escapeGradleSingleQuotedString(repo)}' }`;
+}
+
+export function mergeRepositoriesInBlock(blockText: string, repositories: readonly string[]): string {
+  let cleaned = removeRepositoryLinesByKeys(blockText, repositories);
+  cleaned = stripManagedBlocks(cleaned, TOPSDK_REPO_AUTO_START, TOPSDK_REPO_AUTO_END);
+  if (!repositories.length) return cleaned;
+  const snippet = [
+    TOPSDK_REPO_AUTO_START,
+    ...repositories.map(repositoryToGradleLine),
+    TOPSDK_REPO_AUTO_END,
+  ].join("\n");
+  return fullBlockTextMerge(cleaned, TOPSDK_REPO_AUTO_START, TOPSDK_REPO_AUTO_END, snippet);
+}
+
+/**
+ * Upsert buildscript classpaths: drop existing lines with same coordinate, then write TOPSDK AUTO block.
+ */
+export function mergeClasspathsInBlock(blockText: string, classpaths: readonly string[]): string {
+  const coords = new Set(classpaths);
+  let cleaned = removeClasspathLinesByCoordinates(blockText, coords);
+  cleaned = stripManagedBlocks(cleaned, TOPSDK_AUTO_START, TOPSDK_AUTO_END);
+  if (!classpaths.length) return cleaned;
+  return fullBlockTextMerge(cleaned, TOPSDK_AUTO_START, TOPSDK_AUTO_END, buildTopSdkBuildscriptClasspathSnippet(classpaths));
+}
+
+/**
+ * Insert PLUGIN block immediately after the leading `apply plugin:` lines (e.g. right below
+ * `com.android.application`), not before `android { }` / `dependencies { }`.
+ */
+function insertAfterLeadingApplyPlugins(content: string, snippet: string): string {
+  const eol = content.includes("\r\n") ? "\r\n" : "\n";
+  const lines = content.split(/\r?\n/);
+  let lastApplyIdx = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const trimmed = lines[i].trim();
+    if (/^apply\s+plugin\s*:/.test(trimmed)) {
+      lastApplyIdx = i;
+      continue;
+    }
+    if (lastApplyIdx >= 0) {
+      if (trimmed === "") continue;
+      break;
+    }
+  }
+  if (lastApplyIdx < 0) {
+    return replaceOrInsertTopLevelManaged(
+      content,
+      TOPSDK_PLUGIN_AUTO_START,
+      TOPSDK_PLUGIN_AUTO_END,
+      snippet,
+      "android"
+    );
+  }
+  const before = lines.slice(0, lastApplyIdx + 1).join(eol);
+  const after = lines.slice(lastApplyIdx + 1).join(eol);
+  if (!after) return `${before}${eol}${eol}${snippet}${eol}`;
+  return `${before}${eol}${eol}${snippet}${eol}${after}`;
+}
+
+/**
+ * Upsert module-level apply plugins on the full file: drop duplicate plugin ids, then write PLUGIN block.
+ */
+export function mergeApplyPluginsInContent(content: string, applyPlugins: readonly string[]): string {
+  if (!applyPlugins.length) return content;
+  const ids = new Set(applyPlugins);
+  let cleaned = removeApplyPluginLinesByIds(content, ids);
+  cleaned = stripManagedBlocks(cleaned, TOPSDK_PLUGIN_AUTO_START, TOPSDK_PLUGIN_AUTO_END);
+  return insertAfterLeadingApplyPlugins(cleaned, buildApplyPluginsSnippet(applyPlugins));
+}
+
+/** Remove implementation lines with the same `group:artifact` as any target key. */
+export function removeImplementationLinesByGroupArtifact(
+  blockText: string,
+  keys: ReadonlySet<string>,
+  fallbackGroupId: string
+): string {
+  return blockText
+    .split("\n")
+    .filter((line) => {
+      const key = extractImplementationKey(line, blockText, fallbackGroupId);
+      return !key || !keys.has(key);
+    })
+    .join("\n");
+}
+
+/**
+ * Before inserting TOPSDK managed resValue block: drop any existing lines with the same
+ * resValue keys (inside or outside markers), then insert/update the managed block.
+ */
+export function mergeResValuesInDefaultConfigBlock(blockText: string, managedSnippet: string): string {
+  const desiredLines = managedSnippet
+    .split("\n")
+    .map((l) => l.trimEnd())
+    .filter((l) => l.includes("resValue("));
+  const keys = new Set(
+    [...desiredLines.map((l) => extractResValueKey(l)).filter((k): k is string => Boolean(k)), ...TOPSDK_MANAGED_RESVALUE_KEYS]
+  );
+  let cleaned = removeResValueLinesByKeys(blockText, keys);
+  cleaned = stripManagedBlocks(cleaned, TOPSDK_AUTO_START, TOPSDK_AUTO_END);
+  return replaceOrInsertManaged(
+    cleaned,
+    { start: 0, openBrace: 0, end: cleaned.length },
+    TOPSDK_AUTO_START,
+    TOPSDK_AUTO_END,
+    managedSnippet
+  );
+}
+
+function mergeDependenciesInBlock(
+  blockText: string,
+  managedSnippet: string,
+  fallbackGroupId: string
+): string {
+  const lookupText = `${blockText}\n${managedSnippet}`;
+  const desiredLines = managedSnippet
+    .split("\n")
+    .map((l) => l.trimEnd())
+    .filter((l) => l.includes("implementation "));
+  const keys = new Set(
+    desiredLines
+      .map((l) => extractImplementationKey(l, lookupText, fallbackGroupId))
+      .filter((k): k is string => Boolean(k))
+  );
+  const alsoStrip = (line: string) =>
+    /^\s*def\s+topsdk_version\s*=/.test(line) || /^\s*def\s+groupId\s*=/.test(line);
+  let cleaned = blockText
+    .split("\n")
+    .filter((line) => !alsoStrip(line))
+    .join("\n");
+  cleaned = removeImplementationLinesByGroupArtifact(cleaned, keys, fallbackGroupId);
+  cleaned = stripManagedBlocks(cleaned, TOPSDK_AUTO_START, TOPSDK_AUTO_END);
+  return replaceOrInsertManaged(
+    cleaned,
+    { start: 0, openBrace: 0, end: cleaned.length },
+    TOPSDK_AUTO_START,
+    TOPSDK_AUTO_END,
+    managedSnippet
+  );
+}
+
+function stripManagedBlocks(text: string, startMarker: string, endMarker: string): string {
+  const start = text.indexOf(startMarker);
+  const end = text.indexOf(endMarker);
+  if (start >= 0 && end > start) {
+    return text.slice(0, start) + text.slice(end + endMarker.length);
+  }
+  return text;
+}
+
+function findNestedBlockRange(content: string, keywords: readonly string[]): { start: number; openBrace: number; end: number } | null {
+  let parentStart = 0;
+  let parentEnd = content.length;
+  let current: { start: number; openBrace: number; end: number } | null = null;
+  for (const keyword of keywords) {
+    current = findBlockRange(content, keyword, parentStart);
+    if (!current || current.end > parentEnd) return null;
+    parentStart = current.start;
+    parentEnd = current.end;
+  }
+  return current;
+}
+
+function buildTopSdkBuildscriptClasspathSnippet(classpaths: readonly string[]): string {
+  const lines = [TOPSDK_AUTO_START];
+  for (const classpath of classpaths) {
+    lines.push(`        classpath '${escapeGradleSingleQuotedString(classpath)}'`);
+  }
+  lines.push(TOPSDK_AUTO_END);
+  return lines.join("\n");
+}
+
+function ensureBuildscriptBlock(content: string): string {
+  if (findBlockRange(content, "buildscript")) return content;
+  return `buildscript {\n    repositories {\n    }\n    dependencies {\n    }\n}\n\n${content}`;
+}
+
+export function updateRootBuildGradleMeetSdkRemote(
+  content: string,
+  params:
+    | readonly string[]
+    | {
+        repositories: readonly string[];
+        buildscriptRepositories?: readonly string[];
+        buildscriptClasspaths?: readonly string[];
+        rootPluginsDsl?: readonly MeetSdkGradlePluginDslSpec[];
+        stripPluginsDslIds?: readonly string[];
+        stripBuildscriptClasspaths?: readonly string[];
+      }
+): { ok: true; content: string; changed: boolean; warnings: string[] } | { ok: false; error: string } {
+  const warnings: string[] = [];
+  const options = Array.isArray(params)
+    ? {
+        repositories: params,
+        buildscriptRepositories: [] as readonly string[],
+        buildscriptClasspaths: [] as readonly string[],
+        rootPluginsDsl: [] as readonly MeetSdkGradlePluginDslSpec[],
+        stripPluginsDslIds: [] as readonly string[],
+        stripBuildscriptClasspaths: [] as readonly string[],
+      }
+    : (params as {
+        repositories: readonly string[];
+        buildscriptRepositories?: readonly string[];
+        buildscriptClasspaths?: readonly string[];
+        rootPluginsDsl?: readonly MeetSdkGradlePluginDslSpec[];
+        stripPluginsDslIds?: readonly string[];
+        stripBuildscriptClasspaths?: readonly string[];
+      });
+  const repositories = options.repositories;
+  const buildscriptRepositories = options.buildscriptRepositories ?? [];
+  const buildscriptClasspaths = options.buildscriptClasspaths ?? [];
+  const rootPluginsDsl = options.rootPluginsDsl ?? [];
+  const stripPluginsDslIds = options.stripPluginsDslIds ?? [];
+  const stripBuildscriptClasspathCoords = options.stripBuildscriptClasspaths ?? [];
+
+  let current = content;
+  if (rootPluginsDsl.length > 0) {
+    current = mergePluginsDslInContent(current, rootPluginsDsl);
+    if (stripBuildscriptClasspathCoords.length > 0) {
+      current = stripBuildscriptClasspaths(current, stripBuildscriptClasspathCoords);
+    }
+  }
+  if (stripPluginsDslIds.length > 0) {
+    current = removePluginsDslLinesByIds(current, new Set(stripPluginsDslIds));
+    current = stripManagedBlocks(current, TOPSDK_PLUGIN_AUTO_START, TOPSDK_PLUGIN_AUTO_END);
+  }
+  if (buildscriptRepositories.length > 0 || buildscriptClasspaths.length > 0) {
+    current = ensureBuildscriptBlock(current);
+    const buildscript = findBlockRange(current, "buildscript");
+    if (!buildscript) return { ok: false, error: "buildscript block not found in root build.gradle" };
+    const repositoriesBlock = findBlockRange(current, "repositories", buildscript.start);
+    if (!repositoriesBlock || repositoriesBlock.end > buildscript.end) {
+      return { ok: false, error: "repositories block under buildscript not found" };
+    }
+    const buildscriptReposText = current.slice(repositoriesBlock.openBrace + 1, repositoriesBlock.end);
+    const mergedBuildscriptRepos = mergeRepositoriesInBlock(buildscriptReposText, buildscriptRepositories);
+    current =
+      current.slice(0, repositoriesBlock.openBrace + 1) +
+      mergedBuildscriptRepos +
+      current.slice(repositoriesBlock.end);
+
+    const refreshedBuildscript = findBlockRange(current, "buildscript");
+    if (!refreshedBuildscript) return { ok: false, error: "buildscript block not found in root build.gradle" };
+    const dependenciesBlock = findBlockRange(current, "dependencies", refreshedBuildscript.start);
+    if (!dependenciesBlock || dependenciesBlock.end > refreshedBuildscript.end) {
+      return { ok: false, error: "dependencies block under buildscript not found" };
+    }
+    const buildscriptDepsText = current.slice(dependenciesBlock.openBrace + 1, dependenciesBlock.end);
+    const mergedClasspaths = mergeClasspathsInBlock(buildscriptDepsText, buildscriptClasspaths);
+    current =
+      current.slice(0, dependenciesBlock.openBrace + 1) +
+      mergedClasspaths +
+      current.slice(dependenciesBlock.end);
+  }
+
+  let updated = current;
+  if (repositories.length > 0) {
+    const allprojects = findBlockRange(current, "allprojects");
+    if (!allprojects) {
+      return { ok: false, error: "allprojects block not found in root build.gradle" };
+    }
+    const repositoriesBlock = findBlockRange(current, "repositories", allprojects.start);
+    if (!repositoriesBlock || repositoriesBlock.end > allprojects.end) {
+      return { ok: false, error: "repositories block under allprojects not found" };
+    }
+    const allprojectsReposText = current.slice(repositoriesBlock.openBrace + 1, repositoriesBlock.end);
+    const mergedAllprojectsRepos = mergeRepositoriesInBlock(allprojectsReposText, repositories);
+    updated =
+      current.slice(0, repositoriesBlock.openBrace + 1) +
+      mergedAllprojectsRepos +
+      current.slice(repositoriesBlock.end);
+  }
+  if (updated === content) warnings.push("root build.gradle TOPSDK repositories block unchanged");
+  return { ok: true, content: updated, changed: updated !== content, warnings };
+}
+
+export function updateSettingsGradleMeetSdkRemote(
+  content: string,
+  repositories: readonly string[]
+): { ok: true; content: string; changed: boolean; warnings: string[] } | { ok: false; error: string } {
+  const warnings: string[] = [];
+  const repositoriesBlock = findNestedBlockRange(content, ["dependencyResolutionManagement", "repositories"]);
+  if (!repositoriesBlock) {
+    return { ok: false, error: "dependencyResolutionManagement.repositories block not found in settings.gradle" };
+  }
+  const settingsReposText = content.slice(repositoriesBlock.openBrace + 1, repositoriesBlock.end);
+  const mergedSettingsRepos = mergeRepositoriesInBlock(settingsReposText, repositories);
+  const updated =
+    content.slice(0, repositoriesBlock.openBrace + 1) +
+    mergedSettingsRepos +
+    content.slice(repositoriesBlock.end);
+  if (updated === content) warnings.push("settings.gradle TOPSDK repositories block unchanged");
+  return { ok: true, content: updated, changed: updated !== content, warnings };
+}
+
+function buildApplyPluginsSnippet(applyPlugins: readonly string[]): string {
+  const lines = [TOPSDK_PLUGIN_AUTO_START];
+  for (const plugin of applyPlugins) {
+    lines.push(`apply plugin: '${escapeGradleSingleQuotedString(plugin)}'`);
+  }
+  lines.push(TOPSDK_PLUGIN_AUTO_END);
+  return lines.join("\n");
+}
+
+function buildPluginsDslSnippet(specs: readonly MeetSdkGradlePluginDslSpec[], indent = "    "): string {
+  const lines = [`${indent}${TOPSDK_PLUGIN_AUTO_START}`];
+  for (const spec of specs) {
+    let line = `${indent}id '${escapeGradleSingleQuotedString(spec.id)}'`;
+    if (spec.version) line += ` version '${escapeGradleSingleQuotedString(spec.version)}'`;
+    if (spec.applyFalse) line += " apply false";
+    lines.push(line);
+  }
+  lines.push(`${indent}${TOPSDK_PLUGIN_AUTO_END}`);
+  return lines.join("\n");
+}
+
+function mergePluginsDslInBlock(blockText: string, specs: readonly MeetSdkGradlePluginDslSpec[]): string {
+  const ids = new Set(specs.map((s) => s.id));
+  let cleaned = removePluginsDslLinesByIds(blockText, ids);
+  cleaned = stripManagedBlocks(cleaned, TOPSDK_PLUGIN_AUTO_START, TOPSDK_PLUGIN_AUTO_END);
+  if (!specs.length) return cleaned;
+  return fullBlockTextMerge(cleaned, TOPSDK_PLUGIN_AUTO_START, TOPSDK_PLUGIN_AUTO_END, buildPluginsDslSnippet(specs));
+}
+
+/**
+ * Upsert module/root `plugins { id '…' }` entries inside the existing `plugins { }` block.
+ */
+export function mergePluginsDslInContent(content: string, specs: readonly MeetSdkGradlePluginDslSpec[]): string {
+  if (!specs.length) return content;
+  const ids = new Set(specs.map((s) => s.id));
+  let cleaned = removePluginsDslLinesByIds(content, ids);
+  cleaned = removeApplyPluginLinesByIds(cleaned, ids);
+  cleaned = stripManagedBlocks(cleaned, TOPSDK_PLUGIN_AUTO_START, TOPSDK_PLUGIN_AUTO_END);
+  const pluginsBlock = findBlockRange(cleaned, "plugins");
+  if (!pluginsBlock) {
+    return `plugins {\n${buildPluginsDslSnippet(specs)}\n}\n\n${cleaned}`;
+  }
+  const blockText = cleaned.slice(pluginsBlock.openBrace + 1, pluginsBlock.end);
+  const merged = mergePluginsDslInBlock(blockText, specs);
+  return cleaned.slice(0, pluginsBlock.openBrace + 1) + merged + cleaned.slice(pluginsBlock.end);
+}
+
+function stripBuildscriptClasspaths(content: string, classpaths: readonly string[]): string {
+  if (!classpaths.length) return content;
+  const buildscript = findBlockRange(content, "buildscript");
+  if (!buildscript) return content;
+  const dependenciesBlock = findBlockRange(content, "dependencies", buildscript.start);
+  if (!dependenciesBlock || dependenciesBlock.end > buildscript.end) return content;
+  const depsText = content.slice(dependenciesBlock.openBrace + 1, dependenciesBlock.end);
+  const coords = new Set(classpaths);
+  let cleaned = removeClasspathLinesByCoordinates(depsText, coords);
+  cleaned = stripManagedBlocks(cleaned, TOPSDK_AUTO_START, TOPSDK_AUTO_END);
+  return (
+    content.slice(0, dependenciesBlock.openBrace + 1) + cleaned + content.slice(dependenciesBlock.end)
+  );
+}
+
+function replaceOrInsertTopLevelManaged(
+  content: string,
+  startMarker: string,
+  endMarker: string,
+  snippet: string,
+  insertBeforeKeyword: string
+): string {
+  const start = content.indexOf(startMarker);
+  const end = content.indexOf(endMarker);
+  if (start >= 0 && end > start) {
+    const before = content.slice(0, start).replace(/\s*$/, "\n");
+    const after = content.slice(end + endMarker.length).replace(/^\s*/, "\n");
+    return `${before}${snippet}${after}`;
+  }
+
+  const insertion = `${snippet}\n\n`;
+  const keywordPattern = new RegExp(`^\\s*${insertBeforeKeyword}\\b`, "m");
+  const match = keywordPattern.exec(content);
+  if (match?.index !== undefined) {
+    return content.slice(0, match.index).replace(/\s*$/, "\n\n") + insertion + content.slice(match.index);
+  }
+  return insertion + content;
+}
+
+function buildResValuesSnippet(config: MeetSdkRemoteConfig): string {
+  const lines = [
+    TOPSDK_AUTO_START,
+    `        resValue('string', 'top_channel_id', '${escapeGradleSingleQuotedString(config.channel)}')`,
+    `        resValue('string', 'top_app_id', '${escapeGradleSingleQuotedString(config.topsdk.appId)}')`,
+  ];
+  const loginFb = config.sdkModules.login.facebook;
+  if (typeof loginFb === "object" && loginFb !== null) {
+    lines.push(
+      `        resValue('string', 'facebook_app_id', '${escapeGradleSingleQuotedString(loginFb.facebookAppId)}')`,
+      `        resValue('string', 'fb_login_protocol_scheme', '${escapeGradleSingleQuotedString(loginFb.fbLoginProtocolScheme)}')`,
+      `        resValue('string', 'facebook_client_token', '${escapeGradleSingleQuotedString(loginFb.facebookClientToken)}')`
+    );
+  }
+  const loginGoogle = config.sdkModules.login.google;
+  if (typeof loginGoogle === "object" && loginGoogle !== null && loginGoogle.googleClientId) {
+    lines.push(
+      `        resValue('string', 'google_client_id', '${escapeGradleSingleQuotedString(loginGoogle.googleClientId)}')`
+    );
+  }
+  const loginTwitter = config.sdkModules.login.twitter;
+  if (typeof loginTwitter === "object" && loginTwitter !== null) {
+    lines.push(
+      `        resValue('string', 'twitter_client_id', '${escapeGradleSingleQuotedString(loginTwitter.clientId)}')`,
+      `        resValue('string', 'twitter_client_secret', '${escapeGradleSingleQuotedString(loginTwitter.secret)}')`,
+      `        resValue('string', 'twitter_redirect_url', '${escapeGradleSingleQuotedString(loginTwitter.redirect)}')`
+    );
+  }
+  const loginSnapchat = config.sdkModules.login.snapchat;
+  if (typeof loginSnapchat === "object" && loginSnapchat !== null) {
+    lines.push(
+      `        resValue('string', 'snapchat_client_id', '${escapeGradleSingleQuotedString(loginSnapchat.clientId)}')`,
+      `        resValue('string', 'snapchat_redirect_uri', '${escapeGradleSingleQuotedString(loginSnapchat.redirect)}')`
+    );
+  }
+  const loginTiktok = config.sdkModules.login.tiktok;
+  if (typeof loginTiktok === "object" && loginTiktok !== null) {
+    lines.push(
+      `        resValue('string', 'tiktok_client_id', '${escapeGradleSingleQuotedString(loginTiktok.clientId)}')`,
+      `        resValue('string', 'tiktok_client_secret', '${escapeGradleSingleQuotedString(loginTiktok.secret)}')`,
+      `        resValue('string', 'tiktok_redirect_uri', '${escapeGradleSingleQuotedString(loginTiktok.redirect)}')`
+    );
+  }
+  const loginDiscord = config.sdkModules.login.discord;
+  if (typeof loginDiscord === "object" && loginDiscord !== null) {
+    lines.push(
+      `        resValue('string', 'discord_client_id', '${escapeGradleSingleQuotedString(loginDiscord.clientId)}')`,
+      `        resValue('string', 'discord_client_secret', '${escapeGradleSingleQuotedString(loginDiscord.secret)}')`,
+      `        resValue('string', 'discord_redirect_uri', '${escapeGradleSingleQuotedString(loginDiscord.redirect)}')`
+    );
+  }
+  const loginLine = config.sdkModules.login.line;
+  if (typeof loginLine === "object" && loginLine !== null) {
+    lines.push(`        resValue('string', 'line_channel_id', '${escapeGradleSingleQuotedString(loginLine.clientId)}')`);
+  }
+  const loginKakao = config.sdkModules.login.kakao;
+  if (typeof loginKakao === "object" && loginKakao !== null) {
+    lines.push(
+      `        resValue('string', 'kakao_app_id', '${escapeGradleSingleQuotedString(loginKakao.clientId)}')`,
+      `        resValue('string', 'kakao_scheme', '${escapeGradleSingleQuotedString(loginKakao.scheme)}')`
+    );
+  }
+  const loginNaver = config.sdkModules.login.naver;
+  if (typeof loginNaver === "object" && loginNaver !== null) {
+    lines.push(
+      `        resValue('string', 'naver_client_id', '${escapeGradleSingleQuotedString(loginNaver.clientId)}')`,
+      `        resValue('string', 'naver_client_secret', '${escapeGradleSingleQuotedString(loginNaver.secret)}')`,
+      `        resValue('string', 'naver_client_name', '${escapeGradleSingleQuotedString(loginNaver.name)}')`
+    );
+  }
+  const af = config.sdkModules.analytics.appsflyer;
+  if (typeof af === "object" && af !== null) {
+    lines.push(
+      `        resValue('bool', 'appsflyer_enable_debug_log', "${String(Boolean(af.enableDebugLog))}")`,
+      `        resValue('string', 'af_dev_key', '${escapeGradleSingleQuotedString(af.devKey)}')`
+    );
+  }
+  const analyticsAdjust = config.sdkModules.analytics.adjust;
+  if (typeof analyticsAdjust === "object" && analyticsAdjust !== null) {
+    lines.push(
+      `        resValue('bool', 'adjust_enable_sandbox', "${String(Boolean(analyticsAdjust.enableSandbox))}")`,
+      `        resValue('string', 'adjust_app_token', '${escapeGradleSingleQuotedString(analyticsAdjust.appId)}')`
+    );
+  }
+  const fbData = config.sdkModules.analytics.facebookdata;
+  if (typeof fbData === "object" && fbData !== null) {
+    const dataAppId = fbData.facebookAppId ?? (typeof loginFb === "object" && loginFb !== null ? loginFb.facebookAppId : "");
+    const dataClientToken =
+      fbData.facebookClientToken ?? (typeof loginFb === "object" && loginFb !== null ? loginFb.facebookClientToken : "");
+    if (dataAppId) {
+      lines.push(`        resValue('string', 'facebook_data_app_id', '${escapeGradleSingleQuotedString(dataAppId)}')`);
+    }
+    if (dataClientToken) {
+      lines.push(
+        `        resValue('string', 'facebook_data_client_token', '${escapeGradleSingleQuotedString(dataClientToken)}')`
+      );
+    }
+  }
+  lines.push(TOPSDK_AUTO_END);
+  return lines.join("\n");
+}
+
+function buildRemoteDependenciesSnippet(config: MeetSdkRemoteConfig): string {
+  const lines = [
+    TOPSDK_AUTO_START,
+    `    def topsdk_version = "${escapeGroovyDoubleQuotedInner(config.topsdk.version)}"`,
+    `    def groupId = "${escapeGroovyDoubleQuotedInner(config.topsdk.groupId)}"`,
+    "",
+    `    implementation "$groupId:ui:$topsdk_version"`,
+    ...buildTopSdkFeatureImplementationLines(config),
+  ];
+  lines.push(TOPSDK_AUTO_END);
+  return lines.join("\n");
+}
+
+function updateDefaultConfigApplicationId(content: string, defaultConfigBlock: { openBrace: number; end: number }, applicationId: string): string {
+  const escaped = escapeGroovyDoubleQuotedInner(applicationId);
+  const blockText = content.slice(defaultConfigBlock.openBrace + 1, defaultConfigBlock.end);
+  const existing = /(^[ \t]*)applicationId\s+(?:=+\s*)?["'][^"']*["']/m;
+  if (existing.test(blockText)) {
+    const updatedBlockText = blockText.replace(existing, `$1applicationId "${escaped}"`);
+    return content.slice(0, defaultConfigBlock.openBrace + 1) + updatedBlockText + content.slice(defaultConfigBlock.end);
+  }
+
+  const newlineMatch = blockText.match(/\n([ \t]*)\S/);
+  const indent = newlineMatch ? newlineMatch[1] : "        ";
+  const insertion = `\n${indent}applicationId "${escaped}"`;
+  return content.slice(0, defaultConfigBlock.openBrace + 1) + insertion + blockText + content.slice(defaultConfigBlock.end);
+}
+
+export type MeetSdkModulePluginConfig = {
+  style: ModuleGradlePluginStyle;
+  applyPlugins?: readonly string[];
+  pluginsDsl?: readonly MeetSdkGradlePluginDslSpec[];
+};
+
+export function updateModuleBuildGradleMeetSdkRemote(
+  content: string,
+  config: MeetSdkRemoteConfig,
+  plugins?: readonly string[] | MeetSdkModulePluginConfig
+): { ok: true; content: string; changed: boolean; warnings: string[] } | { ok: false; error: string } {
+  const warnings: string[] = [];
+  let pluginConfig: MeetSdkModulePluginConfig;
+  if (typeof plugins === "object" && plugins !== null && !Array.isArray(plugins) && "style" in plugins) {
+    pluginConfig = plugins;
+  } else {
+    pluginConfig = {
+      style: detectModuleGradlePluginStyle(content),
+      applyPlugins: Array.isArray(plugins) ? plugins : [],
+      pluginsDsl: [],
+    };
+  }
+  const withPlugins =
+    pluginConfig.style === "plugins-dsl" && (pluginConfig.pluginsDsl?.length ?? 0) > 0
+      ? mergePluginsDslInContent(content, pluginConfig.pluginsDsl!)
+      : (pluginConfig.applyPlugins?.length ?? 0) > 0
+        ? mergeApplyPluginsInContent(content, pluginConfig.applyPlugins!)
+        : content;
+
+  const androidBlock = findBlockRange(withPlugins, "android");
+  if (!androidBlock) {
+    return { ok: false, error: "android block not found in module build.gradle" };
+  }
+  const defaultConfigBlock = findBlockRange(withPlugins, "defaultConfig", androidBlock.start);
+  if (!defaultConfigBlock || defaultConfigBlock.end > androidBlock.end) {
+    return { ok: false, error: "defaultConfig block not found under android" };
+  }
+  const withApplicationId = updateDefaultConfigApplicationId(withPlugins, defaultConfigBlock, config.packageName);
+  const refreshedAndroidBlock = findBlockRange(withApplicationId, "android");
+  if (!refreshedAndroidBlock) {
+    return { ok: false, error: "android block not found in module build.gradle" };
+  }
+  const refreshedDefaultConfigBlock = findBlockRange(withApplicationId, "defaultConfig", refreshedAndroidBlock.start);
+  if (!refreshedDefaultConfigBlock || refreshedDefaultConfigBlock.end > refreshedAndroidBlock.end) {
+    return { ok: false, error: "defaultConfig block not found under android" };
+  }
+  const defaultConfigText = withApplicationId.slice(
+    refreshedDefaultConfigBlock.openBrace + 1,
+    refreshedDefaultConfigBlock.end
+  );
+  const mergedDefaultConfigText = mergeResValuesInDefaultConfigBlock(
+    defaultConfigText,
+    buildResValuesSnippet(config)
+  );
+  const withResValues =
+    withApplicationId.slice(0, refreshedDefaultConfigBlock.openBrace + 1) +
+    mergedDefaultConfigText +
+    withApplicationId.slice(refreshedDefaultConfigBlock.end);
+
+  const dependenciesBlock = findBlockRange(withResValues, "dependencies");
+  if (!dependenciesBlock) {
+    return { ok: false, error: "dependencies block not found in module build.gradle" };
+  }
+  const dependenciesText = withResValues.slice(dependenciesBlock.openBrace + 1, dependenciesBlock.end);
+  const mergedDependenciesText = mergeDependenciesInBlock(
+    dependenciesText,
+    buildRemoteDependenciesSnippet(config),
+    config.topsdk.groupId
+  );
+  const withDependencies =
+    withResValues.slice(0, dependenciesBlock.openBrace + 1) +
+    mergedDependenciesText +
+    withResValues.slice(dependenciesBlock.end);
+
+  if (withDependencies === content) warnings.push("module build.gradle TOPSDK blocks unchanged");
+  return { ok: true, content: withDependencies, changed: withDependencies !== content, warnings };
+}