codeplay-common 4.9.9 → 4.10.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 4.10.0 — 2026-10-23
+
+Version name: 4.10.0. Version code/build number: not applicable to this npm package.
+Bundled pre-build script: 6.7.
+
+Files changed: `package.json`, `files/buildCodeplay/project-scripts.cjs`, `scripts/sync-files.js`, `scripts/uninstall.js`, `files/finalrelease`, `files/buildCodeplay/`, `files/scripts-common/`, `files/take-screen-image.js`, `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Copy shared build scripts and the versions manifest into each app; run local scripts with unversioned filenames.
+- Rename app helper scripts to scripts-common automatically, migrate command paths, and preserve existing files without overwriting folder conflicts.
+- Migrate app build/store/sync paths automatically and remove only superseded versioned helpers; preserve app-owned configuration and screenshot data.
+- Resolve app sources/native targets from the consuming app directory while keeping bundled assets inside the plugin.
+- Download IAP and AdMob directly from htmlcodeplay.com, without bundling archives or adding a separate fallback.
+- Automatically migrate deferred ownership verification, purchase-safe advertising, and Home Pro visibility according to each store IAP flag.
+- Copy the full finalrelease implementation so it can be tested from the application folder.
+- Preserve working files during preinstall and avoid downgrading local/newer plugin installations to an older registry release.
+
 ## 4.9.8 — 2026-10-22
 
 Version name: 4.9.8. Version code/build number: not applicable to this npm package.
@@ -12,20 +28,20 @@ Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/cod
 - 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
-
-Version name: 4.7.7. Version code/build number: not applicable to this npm package.
-Bundled pre-build script: 6.4.
-
-Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.4.js`
-(replaces `codeplayBeforeBuild-6.3.js`), `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
-
-- Keep `npm run build` as the Android default on every host; add `npm run build:ios` automatically during installation.
-- Route `build-capacitor-android` through the same pre-build validation before copying the web build.
-- Migrate direct save-gallery imports to `@saveGallery` and select the matching platform helper in Vite after one detailed Enter/y confirmation.
-- Stop without import writes on cancellation, missing helpers, mixed versions, unsupported query/hash aliases or concurrent source edits.
-- Reuse source directory traversal and combine gallery, retired OneSignal import, StatusBar and editor checks in one content pass.
-- Automatically remove an installed/declared `onesignal-cordova-plugin` with a warning; skip legacy OneSignal patching/helper downloads and stop on remaining package imports.
-- Keep `agent-temp/` ignored and remove existing `buildCodeplay/` ignore entries without adding them in future projects.
+- Validate the selected folder controller during final-release checks while continuing to reject test aliases.
+
+## 4.7.7 — 2026-10-07
+
+Version name: 4.7.7. Version code/build number: not applicable to this npm package.
+Bundled pre-build script: 6.4.
+
+Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.4.js`
+(replaces `codeplayBeforeBuild-6.3.js`), `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Keep `npm run build` as the Android default on every host; add `npm run build:ios` automatically during installation.
+- Route `build-capacitor-android` through the same pre-build validation before copying the web build.
+- Migrate direct save-gallery imports to `@saveGallery` and select the matching platform helper in Vite after one detailed Enter/y confirmation.
+- Stop without import writes on cancellation, missing helpers, mixed versions, unsupported query/hash aliases or concurrent source edits.
+- Reuse source directory traversal and combine gallery, retired OneSignal import, StatusBar and editor checks in one content pass.
+- Automatically remove an installed/declared `onesignal-cordova-plugin` with a warning; skip legacy OneSignal patching/helper downloads and stop on remaining package imports.
+- Keep `agent-temp/` ignored and remove existing `buildCodeplay/` ignore entries without adding them in future projects.

package/README.md

@@ -9,13 +9,27 @@ Based on store install various IAP plugins
 Make it to ionic project
 
 
-## AdMob folder packages (4.9.8)
+## App helper folder
 
-Installing this release automatically migrates AdMob to:
+Application helper scripts are kept in `scripts-common/`. Installation migrates the old `scripts/` folder and package command paths automatically, preserving every existing file. A conflicting destination file stops migration before any files are moved. The plugin’s internal npm lifecycle folder remains `scripts/`.
 
-`src/js/Ads/admob-nextgen-4.0/admob-emi-nextgen.js`
+## Shared unversioned build files (4.10.0)
 
-`src/js/Ads/admob-nextgen-4.0/app-open-state.js`
+The plugin keeps the master build templates in files/buildCodeplay and copies them into each app's buildCodeplay folder during installation/update. Test changes in the application folder, then update these master templates for distribution to other apps.
+
+App package scripts run local files: node buildCodeplay/codeplayBeforeBuild.js, node buildCodeplay/packageidBaseModification.js, node buildCodeplay/add-splash-screen.js and node buildCodeplay/setSplashAnimation.js. Filenames have no version suffixes. The versions.json plugin manifest remains alongside these scripts and is copied too.
+
+Installation migrates both legacy versioned filenames and the temporary node_modules runner commands to these local paths. It removes only superseded versioned build scripts, preserves app-owned release configuration and splash XML overrides, and keeps screenshot data and custom helpers. The root finalrelease script is also copied as a local implementation.
+
+Before-build includes the automatic IAP startup and Home Pro-button migrations. IAP and AdMob ZIPs are downloaded directly from https://htmlcodeplay.com/code-play-plugin/ using the existing update flow. No plugin ZIPs are bundled in this npm package. App-specific configuration and designs remain in the app.
+
+## AdMob folder packages
+
+The next before-build automatically migrates AdMob to at least:
+
+`src/js/Ads/admob-nextgen-4.1/admob-emi-nextgen.js`
+
+`src/js/Ads/admob-nextgen-4.1/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
@@ -24,7 +38,7 @@ paths, `@/` paths and static dynamic imports. App-owned
 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.
+The pre-build script downloads IAP before migrating AdMob so the corresponding imports exist. Postinstall does not independently update AdMob ahead of IAP.
 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
@@ -35,15 +49,15 @@ For future AdMob releases, upload `admob-nextgen-X.Y.zip` to
 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.
+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.
+`admob-nextgen-4.1.zip` directly from the same server. If offline, an existing compatible
+installation is preserved; a missing required package stops the build.
 
 ## 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:
+to use the copied unversioned 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.
@@ -67,7 +81,7 @@ package imports remain. Legacy OneSignal patching and helper downloads are disab
 
 ## Screenshot data
 
-Shared screenshot helpers are installed into `scripts/screenshot/` and updated with
+Shared screenshot helpers are installed into `scripts-common/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

package/RELEASE_NOTES.md

@@ -1,5 +1,21 @@
 # Release notes
 
+## 4.10.0 — 2026-10-23
+
+Version name: 4.10.0. Version code/build number: not applicable to this npm package.
+Bundled pre-build script: 6.7.
+
+Files changed: `package.json`, `files/buildCodeplay/project-scripts.cjs`, `scripts/sync-files.js`, `scripts/uninstall.js`, `files/finalrelease`, `files/buildCodeplay/`, `files/scripts-common/`, `files/take-screen-image.js`, `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Copy shared build scripts and the versions manifest into each app; run local scripts with unversioned filenames.
+- Rename app helper scripts to scripts-common automatically, migrate command paths, and preserve existing files without overwriting folder conflicts.
+- Migrate app build/store/sync paths automatically and remove only superseded versioned helpers; preserve app-owned configuration and screenshot data.
+- Resolve app sources/native targets from the consuming app directory while keeping bundled assets inside the plugin.
+- Download IAP and AdMob directly from htmlcodeplay.com, without bundling archives or adding a separate fallback.
+- Automatically migrate deferred ownership verification, purchase-safe advertising, and Home Pro visibility according to each store IAP flag.
+- Copy the full finalrelease implementation so it can be tested from the application folder.
+- Preserve working files during preinstall and avoid downgrading local/newer plugin installations to an older registry release.
+
 ## 4.9.8 — 2026-10-22
 
 Version name: 4.9.8. Version code/build number: not applicable to this npm package.
@@ -12,18 +28,18 @@ Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/cod
 - 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
-
-Version name: 4.7.7. Version code/build number: not applicable to this npm package.
-
-Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.4.js`
-(replaces `codeplayBeforeBuild-6.3.js`), `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
-
-- Installation automatically configures Android and iOS build commands in your app's `package.json`.
-- Android builds remain the default; use `npm run build:ios` for iOS.
-- Save-gallery imports use one alias with a platform-specific helper and a clear confirmation before source changes.
-- Shared checks reuse file traversal to reduce repeated scanning.
-- Builds warn and automatically uninstall the retired OneSignal Cordova plugin when found.
-- `agent-temp/` stays ignored, while `buildCodeplay/` is removed from ignore rules.
+- Validate the selected folder controller during final-release checks while continuing to reject test aliases.
+
+## 4.7.7 — 2026-10-07
+
+Version name: 4.7.7. Version code/build number: not applicable to this npm package.
+
+Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.4.js`
+(replaces `codeplayBeforeBuild-6.3.js`), `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Installation automatically configures Android and iOS build commands in your app's `package.json`.
+- Android builds remain the default; use `npm run build:ios` for iOS.
+- Save-gallery imports use one alias with a platform-specific helper and a clear confirmation before source changes.
+- Shared checks reuse file traversal to reduce repeated scanning.
+- Builds warn and automatically uninstall the retired OneSignal Cordova plugin when found.
+- `agent-temp/` stays ignored, while `buildCodeplay/` is removed from ignore rules.