codeplay-common 4.9.6 → 4.9.9

package/.gitattributes

@@ -1,2 +1,2 @@
-# Auto detect text files and perform LF normalization
-* text=auto
+# Auto detect text files and perform LF normalization
+* text=auto

package/CHANGELOG.md

@@ -1,4 +1,18 @@
-# Changelog
+# Changelog
+
+## 4.9.8 — 2026-10-22
+
+Version name: 4.9.8. Version code/build number: not applicable to this npm package.
+Bundled pre-build script: 6.5.
+
+Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.5.js`, `files/buildCodeplay/sync-admob-nextgen.js`, `files/buildCodeplay/versions.json`, `files/finalrelease`, `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Install AdMob as `src/js/Ads/admob-nextgen-4.0/` with stable `admob-emi-nextgen.js` and `app-open-state.js` filenames.
+- Automatically migrate loose-file references, folder references and Vite aliases during installation and before builds.
+- Preserve app-owned ad configuration and select each app's existing IAP analytics module.
+- Download every AdMob folder ZIP from htmlcodeplay.com; no AdMob archive is included in this npm package.
+- Validate ZIP contents before switching imports; retain the working package when a remote update fails.
+- Validate the selected folder controller during final-release checks while continuing to reject test aliases.
 
 ## 4.7.7 — 2026-10-07
 

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Merbin Joe
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Merbin Joe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,169 +1,201 @@
-# codeplay-common
- Everything automatted in Capacitor apps, easy to maintain many apps in capacitor. It will reduce your 40% of work, with common file code.
-
-
-Easy add splashscreen and set animation
-Admob id automatically from capacitor.config.json file
-Make three build file for different store as per our requirement
-Based on store install various IAP plugins
-Make it to ionic project
-
-## Platform builds and shared validation
-
-Installing or updating `codeplay-common` updates the consuming project's `package.json`
-to use the latest bundled pre-build script and adds these commands:
-
-- `npm run build`: Android by default, including on macOS.
-- `npm run build:ios`: sets `CODEPLAY_BUILD_PLATFORM=ios` and runs the same build pipeline.
-- `npm run build-capacitor-android`: runs the shared checks and copies the web build to Android.
-
-The pre-build script migrates direct `saveToGalleryAndSaveAnyFile` imports to
-`@saveGallery` and sets the Vite alias to the matching Android or iOS helper.
-Before changing source imports or the alias, it lists the build target, affected files,
-and exact replacements. Press Enter or type `y` to continue; any other answer cancels.
-Correct imports and alias targets continue without prompting. Missing helpers, mixed
-versions and query/hash imports stop with an actionable error.
-
-Source validation reuses a directory inventory and combines the gallery and editor
-checks in one content pass. The inventory refreshes when generated or downloaded
-files change the source tree.
-
-Builds also keep `agent-temp/` ignored and remove existing `buildCodeplay/` ignore entries.
-If `onesignal-cordova-plugin` is declared or installed, the pre-build script warns and
-runs `npm uninstall onesignal-cordova-plugin`. It stops if removal fails or active
-package imports remain. Legacy OneSignal patching and helper downloads are disabled.
-
-## Screenshot data
-
-Shared screenshot helpers are installed into `scripts/screenshot/` and updated with
-the package. App-specific data is not bundled with the package.
-During an upgrade, cleanup removes only the two legacy helpers `frame-samples.js`
-and `background-decorations.js` from `scripts-screenshot/screenshot/`, preserving
-the folder, JSON data, and other app files.
-
-`take-screen-image.js` creates `scripts-screenshot/screenshot/` and empty
-`screenshot-copy.json` and `screenshot-info.json` files when needed. Existing files
-are preserved during initialization, package installation, and cleanup. Capture
-updates screenshot information; the AI text-generation workflow fills screenshot
-copy. `--delete` removes matching records, and screenshot runs reconcile records
-against the captured images (except dry runs and `--refresh-info`).
-
-## Agent instructions
-
-Agent instructions are updated during `npm run build`, not during npm installation.
-The build script reads the `agents` version from
-`https://htmlcodeplay.com/code-play-plugin/versions.json` and downloads the matching
-`agents-<version>.zip` archive when the project has no agent instructions or the
-server version is newer.
-
-The ZIP root must contain `AGENTS.md` and `AGENTS/`. These are copied directly to
-the project root. The installed version is stored in `AGENTS/.codeplay-version`.
-Existing files with matching names are replaced; project-only files with other
-names inside `AGENTS/` are preserved.
-
-For example, publish `agents-1.1.zip` and add this entry to the server's
-`versions.json`:
-
-```json
-"agents": "1.1"
-```
-
-Donate to get full code including many common functions
-https://ko-fi.com/codeplay
-
-Version 4.6.1
-  Added automatic IAP startup integration for Framework7 home pages.
-  Updated minimum shared versions to IAP 4.2 and AdMob nextgen 2.5.
-
-4.2.8
-  baseline profile code modifications
-
-Version 4.2.3
-  Added build warning confirmation when android.ORIENTATION is not "auto" or android.RESIZEABLE_ACTIVITY is not true.
-
-Version 4.2.2
-  Added "bannerDisabledPages" property and its default value
-  The admob configuration default value priority is updated
-
-Version 4.2.1
-  Updated AdMob nextgen file validation to match admob-emi-nextgen file names.
-
-Version 4.2.0
-  Firebase related automatic changes updated
-
-Version 4.1.9
-  Added AdMob nextgen 1.7 validation/default support for "overlappingHeight", "bannerTypeAndroidLandscape", and "bannerTypeiOSLandscape".
-
-Version 4.1.8
-  "consentDebug: false" is added
-
-Version 4.1.7
-  admob configuration automatically added.
-
-Version 4.1.6
-  "setup-baseline-profile.js" modification, duplicate validation error fixed
-
-Version 4.1.5
-  While isTesting is true it is not validated from our new configuration admob file, now it is solved
-
-Version 4.1.4
-  hardcoded version is removed for the admob-emi-nextgen
-
-
-Version 4.1.3
-"consentDebug": false automatically adds if not
-
-Version 4.1.2
-  Speedup
-
-Version 4.1.1
-  Auto admob integration updated
-
-
-version 4.0.9
-  packageJson.scripts["ionic:serve"] = "cross-env NODE_ENV=development vite"; this line updated in "sync-files.js"
-
-
-version 4.0.8
-  safearea plugin is checked and removed automatically
-  Automatically added following in capacitor.config.json file
-      "SystemBars": {
-        "insetsHandling": "css"
-      }
-  patchFile() method is removed
-
-
-
-
-Version 4.0.6
-  IAP related some automatic variable creation and validation
-   Fetch from vite.config.json file
-      'import.meta.env.VITE_APP_UNIQUE_ID': JSON.stringify(APP_UNIQUE_ID),
-      'import.meta.env.VITE_ANDROID_ANALYTICS_ENABLED': JSON.stringify(ANDROID_ANALYTICS_ENABLED),
-      'import.meta.env.VITE_IOS_ANALYTICS_ENABLED': JSON.stringify(IOS_ANALYTICS_ENABLED),
-      'import.meta.env.VITE_IAP_DESIGN': JSON.stringify(IAP_DESIGN),
-
-
-Version 4.0.5
-  In "files\buildCodeplay\packageidBaseModification-1.4.js" SCHEDULE_EXACT_ALARM permission added for the app unique id 2 (resume generator app)
-
-
-Version 4.0.4
-  patchFile(); method is disabled, Due to "@capacitor/android:8.4.2" this update. I think it is realted to  safearea issue fixed in this latest version, file in "SystemBars.java"
-
-Version 4.0.3
-  Old admob check performs through plugin location, but not it is validated from capacitor.config.json 
-
-
-Version: 4.0.2
-  After check & install/download the latest version, the re-check is cancelled now
-
-Version: 4.0.1
-    Base profile script added
-
-
-  "version": "",
-Version : 4.0.0 (Previous version 3.2.19)
-    1) In here we are completly remove the admob-emi and use "capacitor-admob-nextgen"
-    2) Removed "modify-plugin-xml.js"
-    3) 
+# codeplay-common
+ Everything automatted in Capacitor apps, easy to maintain many apps in capacitor. It will reduce your 40% of work, with common file code.
+
+
+Easy add splashscreen and set animation
+Admob id automatically from capacitor.config.json file
+Make three build file for different store as per our requirement
+Based on store install various IAP plugins
+Make it to ionic project
+
+
+## AdMob folder packages (4.9.8)
+
+Installing this release automatically migrates AdMob to:
+
+`src/js/Ads/admob-nextgen-4.0/admob-emi-nextgen.js`
+
+`src/js/Ads/admob-nextgen-4.0/app-open-state.js`
+
+Existing `@admob` imports continue to work. Direct imports of the controller or
+lightweight state module are rewritten to the selected folder, including relative
+paths, `@/` paths and static dynamic imports. App-owned
+`src/js/Ads/admob-ad-configuration-nextgen.json` remains outside the package;
+installation does not replace its values. The controller's analytics import is
+aligned with the newest installed IAP folder containing `firebase-analytics.js`.
+
+The postinstall hook and pre-build script use the same migration helper. AdMob archives are downloaded only from the live plugin server; none are stored in this npm package.
+ZIPs may contain the files directly or one matching versioned folder. A complete
+controller and state module are required before imports switch. An unavailable or
+invalid remote ZIP leaves the installed package in use, with a warning. Unresolved
+import targets stop migration before old packages are removed.
+
+For future AdMob releases, upload `admob-nextgen-X.Y.zip` to
+`https://htmlcodeplay.com/code-play-plugin/` and set `"admob-nextgen": "X.Y"`
+in that server's `versions.json`. Version the folder, and keep module filenames
+stable. The previous `admob-emi-nextgen` manifest key is accepted for versions
+4.0 and later during the transition. Apps automatically select a newer ZIP during
+installation or their next normal pre-build; no per-app import changes are needed.
+For older manifests without a folder release entry, migration checks the required
+`admob-nextgen-4.0.zip` directly on the same server. If offline, an existing complete
+folder remains usable; first migration stops with the legacy files preserved.
+
+## Platform builds and shared validation
+
+Installing or updating `codeplay-common` updates the consuming project's `package.json`
+to use the latest bundled pre-build script and adds these commands:
+
+- `npm run build`: Android by default, including on macOS.
+- `npm run build:ios`: sets `CODEPLAY_BUILD_PLATFORM=ios` and runs the same build pipeline.
+- `npm run build-capacitor-android`: runs the shared checks and copies the web build to Android.
+
+The pre-build script migrates direct `saveToGalleryAndSaveAnyFile` imports to
+`@saveGallery` and sets the Vite alias to the matching Android or iOS helper.
+Before changing source imports or the alias, it lists the build target, affected files,
+and exact replacements. Press Enter or type `y` to continue; any other answer cancels.
+Correct imports and alias targets continue without prompting. Missing helpers, mixed
+versions and query/hash imports stop with an actionable error.
+
+Source validation reuses a directory inventory and combines the gallery and editor
+checks in one content pass. The inventory refreshes when generated or downloaded
+files change the source tree.
+
+Builds also keep `agent-temp/` ignored and remove existing `buildCodeplay/` ignore entries.
+If `onesignal-cordova-plugin` is declared or installed, the pre-build script warns and
+runs `npm uninstall onesignal-cordova-plugin`. It stops if removal fails or active
+package imports remain. Legacy OneSignal patching and helper downloads are disabled.
+
+## Screenshot data
+
+Shared screenshot helpers are installed into `scripts/screenshot/` and updated with
+the package. App-specific data is not bundled with the package.
+During an upgrade, cleanup removes only the two legacy helpers `frame-samples.js`
+and `background-decorations.js` from `scripts-screenshot/screenshot/`, preserving
+the folder, JSON data, and other app files.
+
+`take-screen-image.js` creates `scripts-screenshot/screenshot/` and empty
+`screenshot-copy.json` and `screenshot-info.json` files when needed. Existing files
+are preserved during initialization, package installation, and cleanup. Capture
+updates screenshot information; the AI text-generation workflow fills screenshot
+copy. `--delete` removes matching records, and screenshot runs reconcile records
+against the captured images (except dry runs and `--refresh-info`).
+
+## Agent instructions
+
+Agent instructions are updated during `npm run build`, not during npm installation.
+The build script reads the `agents` version from
+`https://htmlcodeplay.com/code-play-plugin/versions.json` and downloads the matching
+`agents-<version>.zip` archive when the project has no agent instructions or the
+server version is newer.
+
+The ZIP root must contain `AGENTS.md` and `AGENTS/`. These are copied directly to
+the project root. The installed version is stored in `AGENTS/.codeplay-version`.
+Existing files with matching names are replaced; project-only files with other
+names inside `AGENTS/` are preserved.
+
+For example, publish `agents-1.1.zip` and add this entry to the server's
+`versions.json`:
+
+```json
+"agents": "1.1"
+```
+
+Donate to get full code including many common functions
+https://ko-fi.com/codeplay
+
+Version 4.6.1
+  Added automatic IAP startup integration for Framework7 home pages.
+  Updated minimum shared versions to IAP 4.2 and AdMob nextgen 2.5.
+
+4.2.8
+  baseline profile code modifications
+
+Version 4.2.3
+  Added build warning confirmation when android.ORIENTATION is not "auto" or android.RESIZEABLE_ACTIVITY is not true.
+
+Version 4.2.2
+  Added "bannerDisabledPages" property and its default value
+  The admob configuration default value priority is updated
+
+Version 4.2.1
+  Updated AdMob nextgen file validation to match admob-emi-nextgen file names.
+
+Version 4.2.0
+  Firebase related automatic changes updated
+
+Version 4.1.9
+  Added AdMob nextgen 1.7 validation/default support for "overlappingHeight", "bannerTypeAndroidLandscape", and "bannerTypeiOSLandscape".
+
+Version 4.1.8
+  "consentDebug: false" is added
+
+Version 4.1.7
+  admob configuration automatically added.
+
+Version 4.1.6
+  "setup-baseline-profile.js" modification, duplicate validation error fixed
+
+Version 4.1.5
+  While isTesting is true it is not validated from our new configuration admob file, now it is solved
+
+Version 4.1.4
+  hardcoded version is removed for the admob-emi-nextgen
+
+
+Version 4.1.3
+"consentDebug": false automatically adds if not
+
+Version 4.1.2
+  Speedup
+
+Version 4.1.1
+  Auto admob integration updated
+
+
+version 4.0.9
+  packageJson.scripts["ionic:serve"] = "cross-env NODE_ENV=development vite"; this line updated in "sync-files.js"
+
+
+version 4.0.8
+  safearea plugin is checked and removed automatically
+  Automatically added following in capacitor.config.json file
+      "SystemBars": {
+        "insetsHandling": "css"
+      }
+  patchFile() method is removed
+
+
+
+
+Version 4.0.6
+  IAP related some automatic variable creation and validation
+   Fetch from vite.config.json file
+      'import.meta.env.VITE_APP_UNIQUE_ID': JSON.stringify(APP_UNIQUE_ID),
+      'import.meta.env.VITE_ANDROID_ANALYTICS_ENABLED': JSON.stringify(ANDROID_ANALYTICS_ENABLED),
+      'import.meta.env.VITE_IOS_ANALYTICS_ENABLED': JSON.stringify(IOS_ANALYTICS_ENABLED),
+      'import.meta.env.VITE_IAP_DESIGN': JSON.stringify(IAP_DESIGN),
+
+
+Version 4.0.5
+  In "files\buildCodeplay\packageidBaseModification-1.4.js" SCHEDULE_EXACT_ALARM permission added for the app unique id 2 (resume generator app)
+
+
+Version 4.0.4
+  patchFile(); method is disabled, Due to "@capacitor/android:8.4.2" this update. I think it is realted to  safearea issue fixed in this latest version, file in "SystemBars.java"
+
+Version 4.0.3
+  Old admob check performs through plugin location, but not it is validated from capacitor.config.json 
+
+
+Version: 4.0.2
+  After check & install/download the latest version, the re-check is cancelled now
+
+Version: 4.0.1
+    Base profile script added
+
+
+  "version": "",
+Version : 4.0.0 (Previous version 3.2.19)
+    1) In here we are completly remove the admob-emi and use "capacitor-admob-nextgen"
+    2) Removed "modify-plugin-xml.js"
+    3) 

package/RELEASE_NOTES.md

@@ -1,4 +1,18 @@
-# Release notes
+# Release notes
+
+## 4.9.8 — 2026-10-22
+
+Version name: 4.9.8. Version code/build number: not applicable to this npm package.
+Bundled pre-build script: 6.5.
+
+Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.5.js`, `files/buildCodeplay/sync-admob-nextgen.js`, `files/buildCodeplay/versions.json`, `files/finalrelease`, `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Install AdMob as `src/js/Ads/admob-nextgen-4.0/` with stable `admob-emi-nextgen.js` and `app-open-state.js` filenames.
+- Automatically migrate loose-file references, folder references and Vite aliases during installation and before builds.
+- Preserve app-owned ad configuration and select each app's existing IAP analytics module.
+- Download every AdMob folder ZIP from htmlcodeplay.com; no AdMob archive is included in this npm package.
+- Validate ZIP contents before switching imports; retain the working package when a remote update fails.
+- Validate the selected folder controller during final-release checks while continuing to reject test aliases.
 
 ## 4.7.7 — 2026-10-07