codeplay-common 4.7.9 → 4.8.0

package/files/buildCodeplay/codeplayBeforeBuild-6.4.js

@@ -44,15 +44,15 @@ const ONESIGNAL_PLUGIN_NAME = "onesignal-cordova-plugin";
 const ADMOB_NEXTGEN_PLUGIN_NAME = "admob-emi-nextgen";
 const ADMOB_NEXTGEN_FILE_PATTERN = new RegExp(`^${ADMOB_NEXTGEN_PLUGIN_NAME}-\\d+(?:\\.\\d+)*\\.js$`);
 const ADMOB_NEXTGEN_CONFIG = "admob-ad-configuration-nextgen.json";
-const ADMOB_OLD_CONFIG = "admob-ad-configuration.json";
-const AGENT_INSTRUCTIONS_VERSION_KEY = "agents";
-const AGENT_INSTRUCTIONS_ZIP_PREFIX = "agents";
-const AGENT_INSTRUCTIONS_FILE = "AGENTS.md";
-const AGENT_INSTRUCTIONS_DIR = "AGENTS";
+const ADMOB_OLD_CONFIG = "admob-ad-configuration.json";
+const AGENT_INSTRUCTIONS_VERSION_KEY = "agents";
+const AGENT_INSTRUCTIONS_ZIP_PREFIX = "agents";
+const AGENT_INSTRUCTIONS_FILE = "AGENTS.md";
+const AGENT_INSTRUCTIONS_DIR = "AGENTS";
 const AGENT_INSTRUCTIONS_VERSION_FILE = ".codeplay-version";
 
 // Remove the retired plugin before any validation, patching or package updates.
-removeOneSignalPlugin();
+removeOneSignalPlugin();
 
 const parseVersionParts = (version) => String(version || "0")
   .trim()
@@ -531,107 +531,107 @@ checkAppUniqueId();
 
 
 
-// ======================================================
-// ENSURE IAP STARTS FROM THE HOME PAGE
-// ======================================================
-
-const getHomePagePath = () => {
-  const pagesDir = path.join(ROOT_DIR, "pages");
-  if (!fs.existsSync(pagesDir)) return null;
-
-  const exactHomePath = path.join(pagesDir, "home.f7");
-  if (fs.existsSync(exactHomePath)) return exactHomePath;
-
-  const pageFiles = fs.readdirSync(pagesDir)
-    .filter(fileName => fileName.endsWith(".f7"));
-
-  return pageFiles
-    .map(fileName => path.join(pagesDir, fileName))
-    .find(filePath => /data-name\s*=\s*['"]home['"]/.test(fs.readFileSync(filePath, "utf8"))) || null;
-};
-
-const getRelativeModuleImport = (sourceFile, targetFile) => {
-  let relativePath = path.relative(path.dirname(sourceFile), targetFile).replace(/\\/g, "/");
-  if (!relativePath.startsWith(".")) relativePath = `./${relativePath}`;
-  return relativePath;
-};
-
-const addInitIapToExistingImport = (content) => {
-  const iapImportRegex = /import\s*\{([^}]*)\}\s*from\s*(['"])([^'"]*\/IAP-\d+(?:\.\d+)*\/IAP-check-And-LoadAd\.js)\2\s*;?/;
-  const match = content.match(iapImportRegex);
-  if (!match || /\binitIAP\b/.test(match[1])) return content;
-
-  const importNames = match[1].trim();
-  const nextImportNames = importNames ? `initIAP, ${importNames}` : "initIAP";
-  return content.replace(iapImportRegex, `import { ${nextImportNames} } from ${match[2]}${match[3]}${match[2]};`);
-};
-
-const addInitIapCall = (content) => {
-  if (/\binitIAP\s*\(/.test(content)) return content;
-
-  const pageInitRegex = /(\$on\(\s*(['"])pageInit\2\s*,\s*(?:async\s*)?\(\)\s*=>\s*\{\s*\r?\n)/;
-  if (pageInitRegex.test(content)) {
-    return content.replace(pageInitRegex, "$1    initIAP();\n");
-  }
-
-  const componentStartRegex = /(export\s+default\s*\([^)]*\)\s*=>\s*\{\s*\r?\n)/;
-  if (componentStartRegex.test(content)) {
-    return content.replace(componentStartRegex, "$1  initIAP();\n");
-  }
-
-  throw new Error("Unable to find a Framework7 component or pageInit lifecycle for IAP startup.");
-};
-
-const ensureIapStartupOnHomePage = () => {
-  const iapConfig = getAdmobIapConfig()?.IAP;
-  if (!isAnyIapStoreEnabled(iapConfig)) {
-    console.log("ℹ️ IAP is disabled for every store. AdMob will use direct startup.");
-    return;
-  }
-
-  const latestIapDir = getLatestIapDir();
-  if (!latestIapDir) {
-    throw new Error("IAP is enabled but no IAP-x.x folder was found.");
-  }
-
-  const homePagePath = getHomePagePath();
-  if (!homePagePath) {
-    throw new Error("IAP is enabled but a Framework7 Home page could not be found in src/pages.");
-  }
-
-  const iapModulePath = path.join(latestIapDir, "IAP-check-And-LoadAd.js");
-  if (!fs.existsSync(iapModulePath)) {
-    throw new Error(`IAP startup module is missing: ${iapModulePath}`);
-  }
-
-  let content = fs.readFileSync(homePagePath, "utf8");
-  const originalContent = content;
-  const staticInitImportRegex = /import\s*\{[^}]*\binitIAP\b[^}]*\}\s*from\s*['"][^'"]*\/IAP-\d+(?:\.\d+)*\/IAP-check-And-LoadAd\.js['"]\s*;?/;
-
-  content = addInitIapToExistingImport(content);
-
-  if (!staticInitImportRegex.test(content)) {
-    const relativeImport = getRelativeModuleImport(homePagePath, iapModulePath);
-    const scriptStartRegex = /<script>\s*\r?\n/;
-    if (!scriptStartRegex.test(content)) {
-      throw new Error(`Unable to find the script block in ${homePagePath}`);
-    }
-    content = content.replace(scriptStartRegex, `$&import { initIAP } from '${relativeImport}';\n`);
-  }
-
-  content = addInitIapCall(content);
-
-  if (content !== originalContent) {
-    fs.writeFileSync(homePagePath, content, "utf8");
-    console.log(`✅ Added direct IAP startup to ${path.relative(process.cwd(), homePagePath)}.`);
-  } else {
-    console.log(`ℹ️ Direct IAP startup already configured in ${path.relative(process.cwd(), homePagePath)}.`);
-  }
-};
-
-// ======================================================
-// ENSURE IAP STARTS FROM THE HOME PAGE END
-// ======================================================
+// ======================================================
+// ENSURE IAP STARTS FROM THE HOME PAGE
+// ======================================================
+
+const getHomePagePath = () => {
+  const pagesDir = path.join(ROOT_DIR, "pages");
+  if (!fs.existsSync(pagesDir)) return null;
+
+  const exactHomePath = path.join(pagesDir, "home.f7");
+  if (fs.existsSync(exactHomePath)) return exactHomePath;
+
+  const pageFiles = fs.readdirSync(pagesDir)
+    .filter(fileName => fileName.endsWith(".f7"));
+
+  return pageFiles
+    .map(fileName => path.join(pagesDir, fileName))
+    .find(filePath => /data-name\s*=\s*['"]home['"]/.test(fs.readFileSync(filePath, "utf8"))) || null;
+};
+
+const getRelativeModuleImport = (sourceFile, targetFile) => {
+  let relativePath = path.relative(path.dirname(sourceFile), targetFile).replace(/\\/g, "/");
+  if (!relativePath.startsWith(".")) relativePath = `./${relativePath}`;
+  return relativePath;
+};
+
+const addInitIapToExistingImport = (content) => {
+  const iapImportRegex = /import\s*\{([^}]*)\}\s*from\s*(['"])([^'"]*\/IAP-\d+(?:\.\d+)*\/IAP-check-And-LoadAd\.js)\2\s*;?/;
+  const match = content.match(iapImportRegex);
+  if (!match || /\binitIAP\b/.test(match[1])) return content;
+
+  const importNames = match[1].trim();
+  const nextImportNames = importNames ? `initIAP, ${importNames}` : "initIAP";
+  return content.replace(iapImportRegex, `import { ${nextImportNames} } from ${match[2]}${match[3]}${match[2]};`);
+};
+
+const addInitIapCall = (content) => {
+  if (/\binitIAP\s*\(/.test(content)) return content;
+
+  const pageInitRegex = /(\$on\(\s*(['"])pageInit\2\s*,\s*(?:async\s*)?\(\)\s*=>\s*\{\s*\r?\n)/;
+  if (pageInitRegex.test(content)) {
+    return content.replace(pageInitRegex, "$1    initIAP();\n");
+  }
+
+  const componentStartRegex = /(export\s+default\s*\([^)]*\)\s*=>\s*\{\s*\r?\n)/;
+  if (componentStartRegex.test(content)) {
+    return content.replace(componentStartRegex, "$1  initIAP();\n");
+  }
+
+  throw new Error("Unable to find a Framework7 component or pageInit lifecycle for IAP startup.");
+};
+
+const ensureIapStartupOnHomePage = () => {
+  const iapConfig = getAdmobIapConfig()?.IAP;
+  if (!isAnyIapStoreEnabled(iapConfig)) {
+    console.log("ℹ️ IAP is disabled for every store. AdMob will use direct startup.");
+    return;
+  }
+
+  const latestIapDir = getLatestIapDir();
+  if (!latestIapDir) {
+    throw new Error("IAP is enabled but no IAP-x.x folder was found.");
+  }
+
+  const homePagePath = getHomePagePath();
+  if (!homePagePath) {
+    throw new Error("IAP is enabled but a Framework7 Home page could not be found in src/pages.");
+  }
+
+  const iapModulePath = path.join(latestIapDir, "IAP-check-And-LoadAd.js");
+  if (!fs.existsSync(iapModulePath)) {
+    throw new Error(`IAP startup module is missing: ${iapModulePath}`);
+  }
+
+  let content = fs.readFileSync(homePagePath, "utf8");
+  const originalContent = content;
+  const staticInitImportRegex = /import\s*\{[^}]*\binitIAP\b[^}]*\}\s*from\s*['"][^'"]*\/IAP-\d+(?:\.\d+)*\/IAP-check-And-LoadAd\.js['"]\s*;?/;
+
+  content = addInitIapToExistingImport(content);
+
+  if (!staticInitImportRegex.test(content)) {
+    const relativeImport = getRelativeModuleImport(homePagePath, iapModulePath);
+    const scriptStartRegex = /<script>\s*\r?\n/;
+    if (!scriptStartRegex.test(content)) {
+      throw new Error(`Unable to find the script block in ${homePagePath}`);
+    }
+    content = content.replace(scriptStartRegex, `$&import { initIAP } from '${relativeImport}';\n`);
+  }
+
+  content = addInitIapCall(content);
+
+  if (content !== originalContent) {
+    fs.writeFileSync(homePagePath, content, "utf8");
+    console.log(`✅ Added direct IAP startup to ${path.relative(process.cwd(), homePagePath)}.`);
+  } else {
+    console.log(`ℹ️ Direct IAP startup already configured in ${path.relative(process.cwd(), homePagePath)}.`);
+  }
+};
+
+// ======================================================
+// ENSURE IAP STARTS FROM THE HOME PAGE END
+// ======================================================
 
 
 
@@ -1348,10 +1348,10 @@ let _admobConfig;
 
 const androidPlatformPath = path.join(process.cwd(), 'android');
 const iosPlatformPath = path.join(process.cwd(), 'ios');
-const androidManifestPath = path.join(process.cwd(), 'android', 'app', 'src', 'main', 'AndroidManifest.xml');
-const androidAppBuildGradlePath = path.join(process.cwd(), 'android', 'app', 'build.gradle');
-const AMAZON_WINDOW_EXTENSIONS_DEPENDENCY = 'implementation "androidx.window.extensions.core:core:1.0.0"';
-const AMAZON_WINDOW_EXTENSIONS_DEPENDENCY_PATTERN = /^[ \t]*implementation\s+["']androidx\.window\.extensions\.core:core:[^"']+["'][ \t]*(?:\r?\n)?/gm;
+const androidManifestPath = path.join(process.cwd(), 'android', 'app', 'src', 'main', 'AndroidManifest.xml');
+const androidAppBuildGradlePath = path.join(process.cwd(), 'android', 'app', 'build.gradle');
+const AMAZON_WINDOW_EXTENSIONS_DEPENDENCY = 'implementation "androidx.window.extensions.core:core:1.0.0"';
+const AMAZON_WINDOW_EXTENSIONS_DEPENDENCY_PATTERN = /^[ \t]*implementation\s+["']androidx\.window\.extensions\.core:core:[^"']+["'][ \t]*(?:\r?\n)?/gm;
 const infoPlistPath = path.join(process.cwd(), 'ios', 'App', 'App', 'Info.plist');
 const iosSceneDelegatePath = path.join(process.cwd(), 'ios', 'App', 'App', 'SceneDelegate.swift');
 const resourcesPath = path.join(process.cwd(), 'resources', 'res');
@@ -1623,7 +1623,8 @@ function updateInfoPlist(admobConfig) {
   const plistData = plist.parse(plistContent);
 
   plistData.GADApplicationIdentifier = admobConfig.APP_ID_IOS;
-  plistData.NSUserTrackingUsageDescription = admobConfig.USER_TRACKING_DESCRIPTION;
+  if (isKidsAdmobApp()) delete plistData.NSUserTrackingUsageDescription;
+  else plistData.NSUserTrackingUsageDescription = admobConfig.USER_TRACKING_DESCRIPTION;
   plistData.GADDelayAppMeasurementInit = true;
 
   // https://developers.google.com/admob/ios/quick-start
@@ -1684,25 +1685,7 @@ function updateIOSSceneDelegateForATT() {
   }
 
   let content = fs.readFileSync(iosSceneDelegatePath, 'utf8');
-  if (content.includes('ATTrackingManager.requestTrackingAuthorization')) return;
-
   const newline = content.includes('\r\n') ? '\r\n' : '\n';
-  const sceneClass = /class SceneDelegate\s*:\s*[^\{]+\{/;
-  if (!sceneClass.test(content) || !/import UIKit\r?\n/.test(content) || !content.trimEnd().endsWith('}')) {
-    console.warn('SceneDelegate.swift has an unexpected structure. Skipping the iOS ATT scene update.');
-    return;
-  }
-
-  if (!content.includes('import AppTrackingTransparency')) {
-    content = content.replace(/import UIKit\r?\n/, (match) => `${match}import AppTrackingTransparency${newline}`);
-  }
-
-  if (!content.includes('isTrackingAuthorizationRequestScheduled')) {
-    content = content.replace(sceneClass, (match) =>
-      `${match}${newline}    private var isTrackingAuthorizationRequestScheduled = false`
-    );
-  }
-
   const requestBody = [
     '        if ATTrackingManager.trackingAuthorizationStatus == .notDetermined &&',
     '            !isTrackingAuthorizationRequestScheduled {',
@@ -1719,6 +1702,36 @@ function updateIOSSceneDelegateForATT() {
     '        }',
   ].join(newline);
 
+  if (isKidsAdmobApp()) {
+    const originalContent = content;
+    content = content.split(requestBody).join('');
+    if (content.includes('ATTrackingManager.requestTrackingAuthorization')) {
+      throw new Error('Kids app still contains a custom ATT request in SceneDelegate.swift. Remove that request before building.');
+    }
+    content = content.replace(/^[ \t]*private var isTrackingAuthorizationRequestScheduled = false\r?\n/gm, '');
+    if (!content.includes('ATTrackingManager')) {
+      content = content.replace(/^import AppTrackingTransparency\r?\n/gm, '');
+    }
+    if (content !== originalContent) fs.writeFileSync(iosSceneDelegatePath, content, 'utf8');
+    console.log('iOS ATT scene prompt disabled for this kids app.');
+    return;
+  }
+
+  if (content.includes('ATTrackingManager.requestTrackingAuthorization')) return;
+  const sceneClass = /class SceneDelegate\s*:\s*[^\{]+\{/;
+  if (!sceneClass.test(content) || !/import UIKit\r?\n/.test(content) || !content.trimEnd().endsWith('}')) {
+    console.warn('SceneDelegate.swift has an unexpected structure. Skipping the iOS ATT scene update.');
+    return;
+  }
+  if (!content.includes('import AppTrackingTransparency')) {
+    content = content.replace(/import UIKit\r?\n/, (match) => `${match}import AppTrackingTransparency${newline}`);
+  }
+  if (!content.includes('isTrackingAuthorizationRequestScheduled')) {
+    content = content.replace(sceneClass, (match) =>
+      `${match}${newline}    private var isTrackingAuthorizationRequestScheduled = false`
+    );
+  }
+
   const activeSceneMethod = /func sceneDidBecomeActive\s*\(\s*_ scene:\s*UIScene\s*\)\s*\{/;
   if (activeSceneMethod.test(content)) {
     content = content.replace(activeSceneMethod, (match) => `${match}${newline}${requestBody}`);
@@ -1982,7 +1995,7 @@ function updateImports(oldName, newName) {
 
 
 let _serverVersions = null;
-async function fetchVersions() {
+async function fetchVersions() {
 
   if (_serverVersions) return _serverVersions;
 
@@ -2019,125 +2032,125 @@ async function fetchVersions() {
 
   });
 
-}
-
-function getAgentInstructionsZipLayout(zip) {
-  const entries = zip.getEntries().filter(entry => !entry.isDirectory);
-
-  for (const entry of entries) {
-    const normalizedName = entry.entryName.replace(/\\/g, "/");
-    if (
-      normalizedName.startsWith("/") ||
-      normalizedName.split("/").includes("..") ||
-      path.isAbsolute(entry.entryName)
-    ) {
-      throw new Error(`Unsafe path in agent instructions ZIP: ${entry.entryName}`);
-    }
-  }
-
-  const normalizedEntries = entries.map(entry => ({
-    entry,
-    name: entry.entryName.replace(/\\/g, "/")
-  }));
-  const agentFile = normalizedEntries.find(({ name }) =>
-    name.toLowerCase() === AGENT_INSTRUCTIONS_FILE.toLowerCase()
-  );
-  const supportFiles = normalizedEntries
-    .filter(({ name }) => name.toLowerCase() !== AGENT_INSTRUCTIONS_FILE.toLowerCase())
-    .map(({ entry, name }) => {
-      const agentDirectoryPrefix = `${AGENT_INSTRUCTIONS_DIR.toLowerCase()}/`;
-      const relativePath = name.toLowerCase().startsWith(agentDirectoryPrefix)
-        ? name.slice(name.indexOf("/") + 1)
-        : name;
-
-      return { entry, relativePath };
-    })
-    .filter(({ relativePath }) =>
-      relativePath &&
-      path.basename(relativePath).toLowerCase() !== AGENT_INSTRUCTIONS_VERSION_FILE.toLowerCase()
-    );
-
-  if (!agentFile || !supportFiles.length) {
-    throw new Error(
-      `Agent instructions ZIP must contain ${AGENT_INSTRUCTIONS_FILE} (case-insensitive) and at least one supporting file.`
-    );
-  }
-
-  return { agentFile: agentFile.entry, supportFiles };
-}
-
-function readInstalledAgentInstructionsVersion(projectRoot) {
-  const versionFile = path.join(projectRoot, AGENT_INSTRUCTIONS_DIR, AGENT_INSTRUCTIONS_VERSION_FILE);
-  if (!fs.existsSync(versionFile)) return "0";
-
-  const installedVersion = String(fs.readFileSync(versionFile, "utf8")).trim();
-  return /^\d+(?:\.\d+)*$/.test(installedVersion) ? installedVersion : "0";
-}
-
-async function syncAgentInstructions() {
-  const projectRoot = process.cwd();
-  const targetAgentFile = path.join(projectRoot, AGENT_INSTRUCTIONS_FILE);
-  const targetAgentDir = path.join(projectRoot, AGENT_INSTRUCTIONS_DIR);
-  const localVersion = readInstalledAgentInstructionsVersion(projectRoot);
-
-  const versions = await fetchVersions();
-  const remoteVersion = String(versions?.[AGENT_INSTRUCTIONS_VERSION_KEY] || "").trim();
-
-  if (!/^\d+(?:\.\d+)*$/.test(remoteVersion)) {
-    throw new Error(`Required agent instructions could not be resolved from the server.`);
-  }
-
-  const remoteIsNewer = compareVersionStrings(remoteVersion, localVersion) > 0;
-  if (!remoteIsNewer) {
-    console.log(`✅ Agent instructions do not need an update (local ${localVersion}, online ${remoteVersion}).`);
-    return;
-  }
-
-  const zipName = `${AGENT_INSTRUCTIONS_ZIP_PREFIX}-${remoteVersion}.zip`;
-  const url = `https://htmlcodeplay.com/code-play-plugin/${zipName}`;
-  const tempRoot = fs.mkdtempSync(path.join(require("os").tmpdir(), "codeplay-agents-"));
-  const zipPath = path.join(tempRoot, zipName);
-  const extractPath = path.join(tempRoot, "extracted");
-
-  try {
-    console.log(`🔍 Checking latest agent instructions: ${zipName}`);
-    if (!(await urlExists(url))) {
-      throw new Error(`Required agent instructions archive not found: ${url}`);
-    }
-
-    await downloadFile(url, zipPath);
-    console.log(`⬇️ Downloaded agent instructions archive: ${zipName}`);
-    const zip = new AdmZip(zipPath);
-    const archiveLayout = getAgentInstructionsZipLayout(zip);
-
-    const stagedAgentFile = path.join(extractPath, AGENT_INSTRUCTIONS_FILE);
-    const stagedAgentDir = path.join(extractPath, AGENT_INSTRUCTIONS_DIR);
-    fs.mkdirSync(stagedAgentDir, { recursive: true });
-    fs.writeFileSync(stagedAgentFile, archiveLayout.agentFile.getData());
-    archiveLayout.supportFiles.forEach(({ entry, relativePath }) => {
-      const stagedSupportFile = path.join(stagedAgentDir, relativePath);
-      fs.mkdirSync(path.dirname(stagedSupportFile), { recursive: true });
-      fs.writeFileSync(stagedSupportFile, entry.getData());
-    });
-
-    fs.rmSync(targetAgentDir, { recursive: true, force: true });
-    fs.mkdirSync(targetAgentDir, { recursive: true });
-    fs.copyFileSync(stagedAgentFile, targetAgentFile);
-    fs.cpSync(stagedAgentDir, targetAgentDir, { recursive: true, force: true });
-    fs.writeFileSync(
-      path.join(targetAgentDir, AGENT_INSTRUCTIONS_VERSION_FILE),
-      `${remoteVersion}\n`,
-      "utf8"
-    );
-
-    writeUpdateLine(`Agent instructions ${localVersion} -> ${remoteVersion}`);
-    console.log(`✅ Agent instructions replaced in the project root → v${remoteVersion}.`);
-  } catch (error) {
-    throw new Error(`Required agent instructions installation failed: ${error?.message || error}`);
-  } finally {
-    fs.rmSync(tempRoot, { recursive: true, force: true });
-  }
-}
+}
+
+function getAgentInstructionsZipLayout(zip) {
+  const entries = zip.getEntries().filter(entry => !entry.isDirectory);
+
+  for (const entry of entries) {
+    const normalizedName = entry.entryName.replace(/\\/g, "/");
+    if (
+      normalizedName.startsWith("/") ||
+      normalizedName.split("/").includes("..") ||
+      path.isAbsolute(entry.entryName)
+    ) {
+      throw new Error(`Unsafe path in agent instructions ZIP: ${entry.entryName}`);
+    }
+  }
+
+  const normalizedEntries = entries.map(entry => ({
+    entry,
+    name: entry.entryName.replace(/\\/g, "/")
+  }));
+  const agentFile = normalizedEntries.find(({ name }) =>
+    name.toLowerCase() === AGENT_INSTRUCTIONS_FILE.toLowerCase()
+  );
+  const supportFiles = normalizedEntries
+    .filter(({ name }) => name.toLowerCase() !== AGENT_INSTRUCTIONS_FILE.toLowerCase())
+    .map(({ entry, name }) => {
+      const agentDirectoryPrefix = `${AGENT_INSTRUCTIONS_DIR.toLowerCase()}/`;
+      const relativePath = name.toLowerCase().startsWith(agentDirectoryPrefix)
+        ? name.slice(name.indexOf("/") + 1)
+        : name;
+
+      return { entry, relativePath };
+    })
+    .filter(({ relativePath }) =>
+      relativePath &&
+      path.basename(relativePath).toLowerCase() !== AGENT_INSTRUCTIONS_VERSION_FILE.toLowerCase()
+    );
+
+  if (!agentFile || !supportFiles.length) {
+    throw new Error(
+      `Agent instructions ZIP must contain ${AGENT_INSTRUCTIONS_FILE} (case-insensitive) and at least one supporting file.`
+    );
+  }
+
+  return { agentFile: agentFile.entry, supportFiles };
+}
+
+function readInstalledAgentInstructionsVersion(projectRoot) {
+  const versionFile = path.join(projectRoot, AGENT_INSTRUCTIONS_DIR, AGENT_INSTRUCTIONS_VERSION_FILE);
+  if (!fs.existsSync(versionFile)) return "0";
+
+  const installedVersion = String(fs.readFileSync(versionFile, "utf8")).trim();
+  return /^\d+(?:\.\d+)*$/.test(installedVersion) ? installedVersion : "0";
+}
+
+async function syncAgentInstructions() {
+  const projectRoot = process.cwd();
+  const targetAgentFile = path.join(projectRoot, AGENT_INSTRUCTIONS_FILE);
+  const targetAgentDir = path.join(projectRoot, AGENT_INSTRUCTIONS_DIR);
+  const localVersion = readInstalledAgentInstructionsVersion(projectRoot);
+
+  const versions = await fetchVersions();
+  const remoteVersion = String(versions?.[AGENT_INSTRUCTIONS_VERSION_KEY] || "").trim();
+
+  if (!/^\d+(?:\.\d+)*$/.test(remoteVersion)) {
+    throw new Error(`Required agent instructions could not be resolved from the server.`);
+  }
+
+  const remoteIsNewer = compareVersionStrings(remoteVersion, localVersion) > 0;
+  if (!remoteIsNewer) {
+    console.log(`✅ Agent instructions do not need an update (local ${localVersion}, online ${remoteVersion}).`);
+    return;
+  }
+
+  const zipName = `${AGENT_INSTRUCTIONS_ZIP_PREFIX}-${remoteVersion}.zip`;
+  const url = `https://htmlcodeplay.com/code-play-plugin/${zipName}`;
+  const tempRoot = fs.mkdtempSync(path.join(require("os").tmpdir(), "codeplay-agents-"));
+  const zipPath = path.join(tempRoot, zipName);
+  const extractPath = path.join(tempRoot, "extracted");
+
+  try {
+    console.log(`🔍 Checking latest agent instructions: ${zipName}`);
+    if (!(await urlExists(url))) {
+      throw new Error(`Required agent instructions archive not found: ${url}`);
+    }
+
+    await downloadFile(url, zipPath);
+    console.log(`⬇️ Downloaded agent instructions archive: ${zipName}`);
+    const zip = new AdmZip(zipPath);
+    const archiveLayout = getAgentInstructionsZipLayout(zip);
+
+    const stagedAgentFile = path.join(extractPath, AGENT_INSTRUCTIONS_FILE);
+    const stagedAgentDir = path.join(extractPath, AGENT_INSTRUCTIONS_DIR);
+    fs.mkdirSync(stagedAgentDir, { recursive: true });
+    fs.writeFileSync(stagedAgentFile, archiveLayout.agentFile.getData());
+    archiveLayout.supportFiles.forEach(({ entry, relativePath }) => {
+      const stagedSupportFile = path.join(stagedAgentDir, relativePath);
+      fs.mkdirSync(path.dirname(stagedSupportFile), { recursive: true });
+      fs.writeFileSync(stagedSupportFile, entry.getData());
+    });
+
+    fs.rmSync(targetAgentDir, { recursive: true, force: true });
+    fs.mkdirSync(targetAgentDir, { recursive: true });
+    fs.copyFileSync(stagedAgentFile, targetAgentFile);
+    fs.cpSync(stagedAgentDir, targetAgentDir, { recursive: true, force: true });
+    fs.writeFileSync(
+      path.join(targetAgentDir, AGENT_INSTRUCTIONS_VERSION_FILE),
+      `${remoteVersion}\n`,
+      "utf8"
+    );
+
+    writeUpdateLine(`Agent instructions ${localVersion} -> ${remoteVersion}`);
+    console.log(`✅ Agent instructions replaced in the project root → v${remoteVersion}.`);
+  } catch (error) {
+    throw new Error(`Required agent instructions installation failed: ${error?.message || error}`);
+  } finally {
+    fs.rmSync(tempRoot, { recursive: true, force: true });
+  }
+}
 
 
 
@@ -2918,11 +2931,11 @@ const sourceImportsPackage = (packageName, ignoredFilePath) => {
   });
 };
 
-function runNpmCommand(command) {
-  console.log(`🚀 ${command}`);
-  execSync(command, { stdio: "inherit" });
-};
-
+function runNpmCommand(command) {
+  console.log(`🚀 ${command}`);
+  execSync(command, { stdio: "inherit" });
+};
+
 function removeOneSignalPlugin() {
   if (!isPackageAvailable(ONESIGNAL_PLUGIN_NAME)) {
     console.log('ℹ️ OneSignal is not installed. Skipping removal.');
@@ -2938,8 +2951,8 @@ function removeOneSignalPlugin() {
   console.log(`✅ Uninstalled ${ONESIGNAL_PLUGIN_NAME}.`);
 }
 
-const CODEPLAY_SYSTEM_BARS_PLUGIN = "capacitor-codeplay-system-bars";
-
+const CODEPLAY_SYSTEM_BARS_PLUGIN = "capacitor-codeplay-system-bars";
+
 function ensureMandatoryCapacitorPlugins() {
   const requiredPackages = [
     "@capacitor/device",
@@ -2957,31 +2970,31 @@ function ensureMandatoryCapacitorPlugins() {
   }
 }
 
-const syncCodeplaySystemBarsPackage = () => {
-  if (!fs.existsSync(packageJsonPath)) {
-    console.warn(`⚠️ package.json not found. Skipping ${CODEPLAY_SYSTEM_BARS_PLUGIN} package sync.`);
-    return;
-  }
-
-  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
-  const declaredVersion = packageJson.dependencies?.[CODEPLAY_SYSTEM_BARS_PLUGIN];
-  const usesLocalReference = typeof declaredVersion === "string" && declaredVersion.startsWith("file:");
-
-  if (usesLocalReference) {
-    console.log(`ℹ️ Replacing the local ${CODEPLAY_SYSTEM_BARS_PLUGIN} reference with the npm package.`);
-    runNpmCommand(`npm install ${CODEPLAY_SYSTEM_BARS_PLUGIN}`);
-    return;
-  }
-
-  if (!isPackageAvailable(CODEPLAY_SYSTEM_BARS_PLUGIN)) {
-    runNpmCommand(`npm install ${CODEPLAY_SYSTEM_BARS_PLUGIN}`);
-    return;
-  }
-
-  console.log(`ℹ️ ${CODEPLAY_SYSTEM_BARS_PLUGIN} is already installed.`);
-};
-
-const ADMOB_NEXTGEN_DEFAULTS = {
+const syncCodeplaySystemBarsPackage = () => {
+  if (!fs.existsSync(packageJsonPath)) {
+    console.warn(`⚠️ package.json not found. Skipping ${CODEPLAY_SYSTEM_BARS_PLUGIN} package sync.`);
+    return;
+  }
+
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+  const declaredVersion = packageJson.dependencies?.[CODEPLAY_SYSTEM_BARS_PLUGIN];
+  const usesLocalReference = typeof declaredVersion === "string" && declaredVersion.startsWith("file:");
+
+  if (usesLocalReference) {
+    console.log(`ℹ️ Replacing the local ${CODEPLAY_SYSTEM_BARS_PLUGIN} reference with the npm package.`);
+    runNpmCommand(`npm install ${CODEPLAY_SYSTEM_BARS_PLUGIN}`);
+    return;
+  }
+
+  if (!isPackageAvailable(CODEPLAY_SYSTEM_BARS_PLUGIN)) {
+    runNpmCommand(`npm install ${CODEPLAY_SYSTEM_BARS_PLUGIN}`);
+    return;
+  }
+
+  console.log(`ℹ️ ${CODEPLAY_SYSTEM_BARS_PLUGIN} is already installed.`);
+};
+
+const ADMOB_NEXTGEN_DEFAULTS = {
   VERSION: "1.6",
   ios: { nativeid: "" },
   android: { nativeid: "" },
@@ -3054,6 +3067,10 @@ function readJsonSafe(filePath) {
   }
 }
 
+function isKidsAdmobApp() {
+  return readJsonSafe(getAdmobJsonPath())?.config?.isKidsApp === true;
+}
+
 function pickFirstValue(...values) {
   return values.find(value => typeof value === "string" && value.trim() !== "") || "";
 }
@@ -3127,7 +3144,9 @@ const mergeNextgenConfigWithoutReplacingExisting = (defaultConfig, oldConfig, ex
 const buildNextgenAdmobConfigFromOldConfig = (templateConfig, existingNextgenConfig, oldConfig) => {
   const mergedConfig = mergeNextgenConfigWithoutReplacingExisting(templateConfig, oldConfig, existingNextgenConfig);
 
-  mergedConfig.VERSION = templateConfig.VERSION || ADMOB_NEXTGEN_DEFAULTS.VERSION;
+  const templateVersion = templateConfig.VERSION || ADMOB_NEXTGEN_DEFAULTS.VERSION;
+  mergedConfig.VERSION = compareVersionStrings(existingNextgenConfig?.VERSION || '0', templateVersion) > 0
+    ? existingNextgenConfig.VERSION : templateVersion;
 
   return ensureAdmobNextgenConfigDefaults(mergedConfig);
 };
@@ -3720,19 +3739,19 @@ const getCurrentStoreId = () => {
   if (!fs.existsSync(commonFilePath)) return 1;
 
   const commonFileContent = fs.readFileSync(commonFilePath, "utf8");
-  const environmentStoreIdMatch = commonFileContent.match(
-    /^[ \t]*export\s+let\s+_storeid\s*=\s*import\.meta\.env\.VITE_STORE_ID\s*\|\|\s*(\d+)\s*;/m
-  );
-  if (environmentStoreIdMatch) return Number(environmentStoreIdMatch[1]);
-
-  const directStoreIdMatch = commonFileContent.match(
-    /^[ \t]*export\s+let\s+_storeid\s*=\s*(\d+)\s*;/m
-  );
-
-  return directStoreIdMatch ? Number(directStoreIdMatch[1]) : 1;
-};
-
-const getRevenueCatStoreState = (iapConfig) => {
+  const environmentStoreIdMatch = commonFileContent.match(
+    /^[ \t]*export\s+let\s+_storeid\s*=\s*import\.meta\.env\.VITE_STORE_ID\s*\|\|\s*(\d+)\s*;/m
+  );
+  if (environmentStoreIdMatch) return Number(environmentStoreIdMatch[1]);
+
+  const directStoreIdMatch = commonFileContent.match(
+    /^[ \t]*export\s+let\s+_storeid\s*=\s*(\d+)\s*;/m
+  );
+
+  return directStoreIdMatch ? Number(directStoreIdMatch[1]) : 1;
+};
+
+const getRevenueCatStoreState = (iapConfig) => {
   const storeId = getCurrentStoreId();
   const configuration = iapConfig.configuration || {};
   const storeMap = {
@@ -3762,43 +3781,69 @@ const getRevenueCatStoreState = (iapConfig) => {
   return {
     storeId,
     store: storeMap[storeId] || null
-  };
-};
-
-const syncAmazonFireWebViewDependency = (enabled) => {
-  if (!fs.existsSync(androidAppBuildGradlePath)) {
-    console.error(`❌ Android app build.gradle not found: ${androidAppBuildGradlePath}`);
-    process.exit(1);
-  }
-
-  const currentContent = fs.readFileSync(androidAppBuildGradlePath, "utf8");
-  let nextContent = currentContent.replace(AMAZON_WINDOW_EXTENSIONS_DEPENDENCY_PATTERN, "");
-
-  if (enabled) {
-    const newline = nextContent.includes("\r\n") ? "\r\n" : "\n";
-    const dependenciesHeaderPattern = /(^dependencies[ \t]*\{[ \t]*\r?\n)/m;
-
-    if (!dependenciesHeaderPattern.test(nextContent)) {
-      console.error(`❌ dependencies block not found in ${androidAppBuildGradlePath}`);
-      process.exit(1);
-    }
-
-    nextContent = nextContent.replace(
-      dependenciesHeaderPattern,
-      `$1    ${AMAZON_WINDOW_EXTENSIONS_DEPENDENCY}${newline}`
-    );
-  }
-
-  if (nextContent !== currentContent) {
-    fs.writeFileSync(androidAppBuildGradlePath, nextContent, "utf8");
-  }
-
-  console.log(enabled
-    ? "✅ Amazon Fire WebView compatibility dependency enabled for Store ID 7."
-    : "ℹ️ Amazon Fire WebView compatibility dependency disabled for this store.");
-};
-
-const ensureAndroidPermission = (permission, enabled) => {
+  };
+};
+
+const syncAmazonFireWebViewDependency = (enabled) => {
+  if (!fs.existsSync(androidAppBuildGradlePath)) {
+    console.error(`❌ Android app build.gradle not found: ${androidAppBuildGradlePath}`);
+    process.exit(1);
+  }
+
+  const currentContent = fs.readFileSync(androidAppBuildGradlePath, "utf8");
+  let nextContent = currentContent.replace(AMAZON_WINDOW_EXTENSIONS_DEPENDENCY_PATTERN, "");
+
+  if (enabled) {
+    const newline = nextContent.includes("\r\n") ? "\r\n" : "\n";
+    const dependenciesHeaderPattern = /(^dependencies[ \t]*\{[ \t]*\r?\n)/m;
+
+    if (!dependenciesHeaderPattern.test(nextContent)) {
+      console.error(`❌ dependencies block not found in ${androidAppBuildGradlePath}`);
+      process.exit(1);
+    }
+
+    nextContent = nextContent.replace(
+      dependenciesHeaderPattern,
+      `$1    ${AMAZON_WINDOW_EXTENSIONS_DEPENDENCY}${newline}`
+    );
+  }
+
+  if (nextContent !== currentContent) {
+    fs.writeFileSync(androidAppBuildGradlePath, nextContent, "utf8");
+  }
+
+  console.log(enabled
+    ? "✅ Amazon Fire WebView compatibility dependency enabled for Store ID 7."
+    : "ℹ️ Amazon Fire WebView compatibility dependency disabled for this store.");
+};
+
+function syncAndroidAdIdPermission() {
+  if (!fs.existsSync(androidManifestPath)) return;
+  const originalContent = fs.readFileSync(androidManifestPath, 'utf8');
+  const newline = originalContent.includes('\r\n') ? '\r\n' : '\n';
+  const marker = '<!-- Codeplay: child-directed advertising ID exclusion -->';
+  const permission = 'com.google.android.gms.permission.AD_ID';
+  const permissionTag = `<uses-permission android:name="${permission}" tools:node="remove" />`;
+  const generatedRule = new RegExp(`^[ \\t]*${marker}\\r?\\n[ \\t]*<uses-permission\\b[^>]*tools:node="remove"[^>]*\\/>\\r?\\n`, 'gm');
+  const hadGeneratedRule = originalContent.includes(marker);
+  let content = originalContent.replace(generatedRule, '');
+  if (isKidsAdmobApp()) {
+    content = content.replace(/(?:^[ \t]*)?<uses-permission\b[^>]*>(?:[ \t\r\n]*<\/uses-permission>)?[ \t]*(?:\r?\n)?/gm, tag =>
+      /android:name\s*=\s*["']com\.google\.android\.gms\.permission\.AD_ID["']/.test(tag) ? '' : tag);
+    if (!/xmlns:tools\s*=/.test(content)) {
+      content = content.replace(/<manifest\b/, '<manifest xmlns:tools="http://schemas.android.com/tools"');
+    }
+    content = content.replace(/(<manifest\b[^>]*>)(?:\r?\n)?/, (match, root) => `${root}${newline}    ${marker}${newline}    ${permissionTag}${newline}`);
+  } else if (hadGeneratedRule) {
+    content = content.replace(/(<manifest\b[^>]*>)(?:\r?\n)?/, (match, root) => `${root}${newline}    <uses-permission android:name="${permission}" />${newline}`);
+  }
+  if (content !== originalContent) {
+    fs.writeFileSync(androidManifestPath, content, 'utf8');
+    console.log(isKidsAdmobApp() ? 'Android advertising ID permission excluded for this kids app.' : 'Android advertising ID permission restored for this non-kids app.');
+  }
+}
+
+const ensureAndroidPermission = (permission, enabled) => {
   if (!fs.existsSync(androidManifestPath)) return false;
 
   let manifestContent = fs.readFileSync(androidManifestPath, "utf8");
@@ -3825,15 +3870,15 @@ const ensureAndroidPermission = (permission, enabled) => {
   return true;
 };
 
-const syncRevenueCatIapSetup = () => {
-  const admobConfig = getAdmobIapConfig();
-  const iapConfig = admobConfig?.IAP;
-
-  if (!iapConfig) {
-    syncAmazonFireWebViewDependency(false);
-    console.log("ℹ️ IAP configuration not found. Skipping RevenueCat package sync.");
-    return;
-  }
+const syncRevenueCatIapSetup = () => {
+  const admobConfig = getAdmobIapConfig();
+  const iapConfig = admobConfig?.IAP;
+
+  if (!iapConfig) {
+    syncAmazonFireWebViewDependency(false);
+    console.log("ℹ️ IAP configuration not found. Skipping RevenueCat package sync.");
+    return;
+  }
 
   ensureIapDesignInCapacitorConfig(iapConfig);
 
@@ -3841,9 +3886,9 @@ const syncRevenueCatIapSetup = () => {
     iapConfig.playstore === true ||
     iapConfig.ios === true ||
     iapConfig.amazon === true;
-  const { storeId, store } = getRevenueCatStoreState(iapConfig);
-  const revenueCatEnabledForCurrentStore = store?.enabled === true;
-  syncAmazonFireWebViewDependency(storeId === 7 && iapConfig.amazon === true);
+  const { storeId, store } = getRevenueCatStoreState(iapConfig);
+  const revenueCatEnabledForCurrentStore = store?.enabled === true;
+  syncAmazonFireWebViewDependency(storeId === 7 && iapConfig.amazon === true);
 
   if (revenueCatEnabledForCurrentStore && !store.apiKey) {
     console.error(`❌ RevenueCat IAP is enabled for ${store.name} but ${store.apiKeyName} is missing.`);
@@ -4246,18 +4291,19 @@ async function main() {
   validateAndRestoreSignDetails();
   ensureMandatoryCapacitorPlugins();
 
-  await loadPluginVersions();   // 🔥 NEW
-  await syncAgentInstructions();
-
-   await syncAdmobNextgenMigration();
-   syncCodeplaySystemBarsPackage();
-   syncSystemBarsSafeAreaMigration();
-  await checkPlugins();
-  ensureIapStartupOnHomePage();
-  syncRevenueCatIapSetup();
+  await loadPluginVersions();   // 🔥 NEW
+  await syncAgentInstructions();
+
+   await syncAdmobNextgenMigration();
+   syncCodeplaySystemBarsPackage();
+   syncSystemBarsSafeAreaMigration();
+  await checkPlugins();
+  ensureIapStartupOnHomePage();
+  syncRevenueCatIapSetup();
   syncFirebaseAnalyticsSetup();
   checkAndupdateDropInViteConfig();
   checkAdmobConfigurationProperty();
+  syncAndroidAdIdPermission();
 }
 
 await main();
@@ -4272,6 +4318,11 @@ await main();
 /*
 Release Notes
 
+  6.5
+    Kids ad configuration disables iOS ATT prompts and excludes Android AD_ID during builds.
+    Non-kids apps retain tracking prompts and normal permission behavior.
+    Ad configuration migration preserves newer local configuration versions.
+
   5.1
     Kotlin version update is commented. Previously admob is not worked if not update the kotlin version to higher version