@makefully/adaptfully 3.16.0 → 4.0.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project are documented in this file.
 
+## 4.0.0 — 2026-09-03
+
+### Removed
+
+- **Cordova / PhoneGap** — Dropped `CordovaPackager`, `packager: "cordova"`, and the `cordova` package keyword. Android/iOS prebuild and Wrapfully family resolution are Capacitor-only.
+- **`CordovaPackager` export** — No longer exported from `@makefully/adaptfully`.
+
+### Changed
+
+- **`resolveFamily(..., 'cordova')`** — Throws an explicit error directing clients to Capacitor.
+- **Major version** — Breaking for projects still configured with Cordova.
+
+## 3.16.1 — 2026-09-03
+
+### Fixed
+
+- **`adaptfully build` signing credentials** — Capacitor/Cordova zip builds now package `assets/meta/deployments/<canonical>/` (e.g. `ios-dev` → `ios`) so Wrapfully can sign device IPAs. Previously only `release` shipped deployment folders, so `ios:dev-build` arrived on the Mac without `apple/development.*`.
+
 ## 3.16.0 — 2026-09-02
 
 ### Added

package/README.md

@@ -159,16 +159,15 @@ Standard plugin keys load bundled Adaptfully runtime scripts and emit an inline
 
 Wrapfully builders (`steam`, `win`, `mac`, `android`, etc.) map to platform keys via defaults (`win` → `steam`) or an explicit `builders` array on the platform config.
 
-Each platform entry may set a **`packager`** (`web`, `electron`, `cordova`, or `capacitor`). Defaults to **`web`** — copy deploy and inject HTML only. Packagers are implemented as classes (`WebPackager`, `ElectronPackager`, `CordovaPackager`, `CapacitorPackager`) that handle prebuild output for their target platforms.
+Each platform entry may set a **`packager`** (`web`, `electron`, or `capacitor`). Defaults to **`web`** — copy deploy and inject HTML only. Packagers are implemented as classes (`WebPackager`, `ElectronPackager`, `CapacitorPackager`) that handle prebuild output for their target platforms.
 
 | Packager | Prebuild adds |
 |----------|---------------|
 | `web` | `game-config.js` for **`uwp`** platform prebuilds |
 | `electron` | `main.js` (Electron shell); `preload.js` when **`steam-auth`** is registered |
-| `cordova` | `cordova.js` stub, `game-config.js`, CSP/viewport HTML extras |
 | `capacitor` | `game-config.js`, Capacitor CSP/viewport; `social-login-config.js` when **`social-auth`** is registered |
 
-Android/iOS Wrapfully builds default to the **`capacitor`** builder family. Set `packager: "cordova"` on a platform to use Cordova for that target.
+Android/iOS Wrapfully builds use the **`capacitor`** builder family. Cordova/PhoneGap is no longer supported.
 
 **`steam-auth` requires `packager: "electron"`** and `platforms.<name>.steamId` (Steamworks app ID for the client preload). Steam **upload** app IDs live separately in each Steam deployment’s `manifest.json` — see Wrapfully docs.
 
@@ -461,10 +460,6 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
         }
       }
     },
-    "properties": [
-      { "tag": "plugin", "name": "cordova-plugin-inappbrowser" },
-      { "tag": "allow-navigation", "href": "*" }
-    ]
   }
 }
 ```
@@ -472,13 +467,13 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
 | Field | Used by | Description |
 |-------|---------|-------------|
 | `title` | All | Display name shown in stores and app shells |
-| `packageName` | Cordova, Capacitor, Electron, UWP, Play upload | Reverse-DNS identifier (`com.company.game`) |
-| `publisherDisplayName` | Cordova, Electron, web | Short publisher name |
+| `packageName` | Capacitor, Electron, UWP, Play upload | Reverse-DNS identifier (`com.company.game`) |
+| `publisherDisplayName` | Electron, web | Short publisher name |
 | `publisherFullName` | Electron | Legal entity name for copyright |
-| `publisherWebsite` | Cordova, web | Company URL |
-| `publisherEmailAddress` | Cordova | Contact email |
+| `publisherWebsite` | Web | Company URL |
+| `publisherEmailAddress` | Optional | Contact email |
 | `scope` | Web/PWA | Base URL scope for the web app |
-| `themeColor` | Cordova, Capacitor, Electron, UWP, web | Loading screen / theme color |
+| `themeColor` | Capacitor, Electron, UWP, web | Loading screen / theme color |
 | `twitterId` | Web | Twitter handle for meta tags |
 | `deployFolder` | Client | Neutral deploy directory staged before prebuild (default: `deploy`) |
 | `htmlInjections` | Prebuild | Deploy-relative HTML paths to inject (default: `["index.html"]`) |
@@ -486,11 +481,10 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
 | `platforms` | Prebuild | Per-platform registration maps (see [Adaptfully runtime](#adaptfully-runtime)) |
 | `platforms.<name>.builder` | Build/deploy | Override Wrapfully builder for a platform (default: `web` → `webapp`, others match platform key) |
 | `platforms.<name>.builders` | wrapfully-deploy | Map additional Wrapfully builder names to a platform |
-| `platforms.<name>.packager` | Prebuild | `web` (default), `electron`, `cordova`, or `capacitor` — selects the packager class that adds platform-specific files during prebuild |
+| `platforms.<name>.packager` | Prebuild | `web` (default), `electron`, or `capacitor` — selects the packager class that adds platform-specific files during prebuild |
 | `platforms.<name>.steamId` | Electron + steam-auth | Steamworks app ID baked into `preload.js` (client). Upload app IDs belong in the Steam deployment `manifest.json` |
 | `platforms.<name>.socialLogin` | Capacitor + social-auth | Capgo provider config (`providers`, `google.webClientId`, `apple.clientId`, optional `defaultProvider`) |
 | `platforms.<name>.<configField>` | Build/deploy | Overrides the matching top-level `config.*` default for that platform only (e.g. `platforms.android.packageName`, `platforms.ios.title`). Does not apply to control fields: `packager`, `registrations`, `builder`, `builders`, `deployments`, `steamId`, `socialLogin`, `steamworks` |
-| `properties` | Cordova | Cordova config.xml entries (plugins, allow-navigation, etc.) |
 
 Top-level `config.*` values are **defaults**. Any non-control field on `config.platforms.<name>` overrides the default when that platform is built or deployed. Example:
 
@@ -608,7 +602,7 @@ The file looks like:
 
 #### Apple (`ios`, `ios-dev`, `ios-sim`, `mac`)
 
-**Capacitor iOS** signing is file-based under the deployment folder (not the Cordova-style `build.json` `ios.*` identity fields):
+**Capacitor iOS** signing is file-based under the deployment folder:
 
 ```
 assets/meta/deployments/<deployment>/
@@ -617,11 +611,10 @@ assets/meta/deployments/<deployment>/
   apple/app-store.mobileprovision     # release
   apple/development.p12               # ios-dev device
   apple/development.mobileprovision   # ios-dev device
+  build.json                          # optional: { "apple": { "p12Password": "..." } }
 ```
 
-The `.p12` passphrase must match `MAC_KEYCHAIN_PASSWORD` on the Mac Wrapfully host. Team ID and profile UUID are read from the `.mobileprovision`. Enable **Sign in with Apple** on the App ID when using Capgo Apple auth.
-
-Optional `build.json` may still be present for tooling compatibility; Capacitor does not require its `ios.*` code-sign fields.
+`adaptfully build` (zip-only) still packages this deployment folder for Capacitor so device debug builds can sign. Optional `build.json` may set `apple.p12Password` for the `.p12` passphrase (Wrapfully uses an ephemeral keychain per build). Team ID and profile UUID are read from the `.mobileprovision`. Enable **Sign in with Apple** on the App ID when using Capgo Apple auth.
 
 To deploy to the App Store, include `assets/meta/deployments/<deployment>/apple.json`. The easiest path is:
 
@@ -642,9 +635,6 @@ The file looks like:
 ```
 
 iOS IPA upload uses `username` + `password` via `xcrun altool --upload-app`. `category` / `identity` matter more for macOS Electron signing/notarization.
-#### Cordova
-
-Set `packager: "cordova"` on an `android` or `ios` platform to use Cordova instead of Capacitor. Requires the Android and Apple package requirements above.
 
 #### Steam (`steam`, `steam-dev`)
 

package/lib/node/archive.js

@@ -144,7 +144,8 @@ function createZipStream(deployFolder, contents, options = {}) {
 }
 
 /**
- * Game source zip for /build and /release (no credentials unless release).
+ * Game source zip for /build (and legacy callers). Include `deploymentDirs` when
+ * the builder needs signing credentials (e.g. Capacitor ios-dev).
  *
  * @param {string} deployFolder
  * @param {string} contents

package/lib/node/deploy.js

@@ -71,7 +71,11 @@ export async function send(gameId, contents, server, stage, family, deployFolder
     } else if (stage === 'release') {
         archiveStream = createReleaseArchive(deployFolder, contents, options.deploymentDirs ?? [], { log });
     } else {
-        archiveStream = createSourceArchive(deployFolder, contents, { log });
+        archiveStream = createSourceArchive(deployFolder, contents, {
+            log,
+            publishDir: options.publishDir,
+            deploymentDirs: options.deploymentDirs,
+        });
     }
 
     const url = resolveWrapfullyUrl(server, stage, family, gameId, platformKey, options.deploymentKey);

package/lib/node/index.js

@@ -23,7 +23,6 @@ export { prebuildPlatform, prebuildOutputDir, resolveHtmlInjections } from './pr
 export { getPackageRoot, getRuntimeDir, resolveRuntimeScript } from './paths.js';
 export {
     CapacitorPackager,
-    CordovaPackager,
     ElectronPackager,
     Packager,
     VALID_PACKAGERS,
@@ -52,6 +51,7 @@ export {
     resolveFamilyFromTarget,
     resolvePlatformKey,
     resolvePlatformRegistrationsByKey,
+    resolveBuildCredentialDirs,
     resolvePublishDir,
     resolveRegistrationAssets,
 } from './registrations.js';

package/lib/node/packagers/base.js

@@ -4,10 +4,10 @@ import { STANDARD_PLUGINS } from '../registrations.js';
 import { resolvePlatformConfig } from '../platform-config.js';
 
 /** @typedef {import('../registrations.js').RegistrationMap} RegistrationMap */
-/** @typedef {'web' | 'electron' | 'cordova' | 'capacitor'} PackagerName */
+/** @typedef {'web' | 'electron' | 'capacitor'} PackagerName */
 
 /** @type {PackagerName[]} */
-export const VALID_PACKAGERS = ['web', 'electron', 'cordova', 'capacitor'];
+export const VALID_PACKAGERS = ['web', 'electron', 'capacitor'];
 
 const PACKAGER_MARKER = '<!-- adaptfully-packager -->';
 const PACKAGER_END_MARKER = '<!-- /adaptfully-packager -->';
@@ -16,7 +16,7 @@ const HEAD_PACKAGER_END_MARKER = '<!-- /adaptfully-packager-head -->';
 
 /**
  * @typedef {Object} PackagerOptions
- * @property {string[]} [platforms] Platform keys this packager targets (e.g. ios + android for Cordova)
+ * @property {string[]} [platforms] Platform keys this packager targets
  * @property {string} [platformKey] Active platform for a single prebuild run
  * @property {(message: string) => void} [log]
  */

package/lib/node/packagers/index.js

@@ -1,5 +1,4 @@
 import { CapacitorPackager } from './capacitor.js';
-import { CordovaPackager } from './cordova.js';
 import { ElectronPackager } from './electron.js';
 import { Packager, VALID_PACKAGERS } from './base.js';
 import { WebPackager } from './web.js';
@@ -10,7 +9,6 @@ export {
     resolvePlatformSocialLogin,
     validateSocialLoginConfig,
 } from './capacitor.js';
-export { CordovaPackager } from './cordova.js';
 export {
     ElectronPackager,
     buildElectronMain,
@@ -26,7 +24,6 @@ export { WebPackager } from './web.js';
 const PACKAGER_REGISTRY = {
     web: WebPackager,
     electron: ElectronPackager,
-    cordova: CordovaPackager,
     capacitor: CapacitorPackager,
 };
 

package/lib/node/pipeline.js

@@ -4,6 +4,7 @@ import { send } from './deploy.js';
 import { resolveBuildArtifactDir } from './artifacts.js';
 import { prebuildPlatform } from './prebuild.js';
 import {
+    resolveBuildCredentialDirs,
     resolveBuildSpec,
     resolveDeploymentsForPlatform,
     resolvePublishDir,
@@ -130,6 +131,9 @@ export async function runAdaptfullyStage(stage, platformKey, options) {
     for (const deploymentKey of deployments) {
         const publishDir = deploymentKey === 'zip' ? undefined : resolvePublishDir(deploymentKey);
         const wrapStage = stage === 'deploy' ? 'deploy' : 'build';
+        const deploymentDirs = wrapStage === 'build'
+            ? resolveBuildCredentialDirs(platformKey, pkg)
+            : [];
 
         log(
             `adaptfully: ${stage} ${platformKey} → `
@@ -137,6 +141,14 @@ export async function runAdaptfullyStage(stage, platformKey, options) {
             + `via Wrapfully /${wrapfullyRoute}/${wrapStage} (${buildSpec.family})`,
         );
 
+        if (deploymentDirs.length) {
+            log(
+                `adaptfully: build signing credentials → ${
+                    deploymentDirs.map((dir) => path.resolve(dir)).join(', ')
+                }`,
+            );
+        }
+
         await send(
             gameId,
             contents,
@@ -149,6 +161,7 @@ export async function runAdaptfullyStage(stage, platformKey, options) {
             {
                 log,
                 publishDir,
+                deploymentDirs,
                 platformKey,
                 deploymentKey: wrapStage === 'deploy' ? deploymentKey : undefined,
                 artifactPath,

package/lib/node/registrations.js

@@ -345,6 +345,30 @@ export function resolvePublishDir(deploymentKey, metaDir = 'assets/meta') {
     return path.join(metaDir, 'deployments', deploymentKey);
 }
 
+const BUILD_SIGNING_PACKAGERS = new Set(['capacitor']);
+
+/**
+ * Credential folders to ship with `adaptfully build` (zip artifact) when the
+ * Wrapfully builder needs signing material — e.g. ios-dev → deployments/ios.
+ * Upload-only targets (SFTP, Play, ASC) are not included.
+ *
+ * @param {string} platformKey
+ * @param {object} pkg
+ * @param {string} [metaDir='assets/meta']
+ * @returns {string[]} Absolute paths to existing deployment dirs
+ */
+export function resolveBuildCredentialDirs(platformKey, pkg, metaDir = 'assets/meta') {
+    const platform = pkg?.config?.platforms?.[platformKey];
+    const packager = platform?.packager;
+    if (!BUILD_SIGNING_PACKAGERS.has(packager)) {
+        return [];
+    }
+
+    const credentialKey = DEFAULT_BUILDER_PLATFORMS[platformKey] ?? platformKey;
+    const dir = path.resolve(resolvePublishDir(credentialKey, metaDir));
+    return fs.existsSync(dir) ? [dir] : [];
+}
+
 const ELECTRON_TARGETS = new Set([
     'win', 'win-dev', 'mac', 'mac-dev', 'linux', 'linux-dev',
 ]);
@@ -388,7 +412,10 @@ export function resolveFamily(targets, packager) {
         return 'electron';
     }
     if (packager === 'cordova') {
-        return 'cordova';
+        throw new Error(
+            'Cordova/PhoneGap is no longer supported. Remove packager: "cordova" '
+            + '(or set packager: "capacitor") and use Capacitor for android/ios builds.',
+        );
     }
     if (packager === 'capacitor') {
         return 'capacitor';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@makefully/adaptfully",
-    "version": "3.16.0",
+    "version": "4.0.0",
     "description": "Platform abstraction and Wrapfully deploy client for Makefully games",
     "type": "module",
     "main": "./lib/node/index.js",
@@ -40,7 +40,7 @@
         "platform",
         "deploy",
         "build",
-        "cordova",
+        "capacitor",
         "electron"
     ],
     "contributors": [

package/lib/node/packagers/cordova.js

@@ -1,44 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { Packager } from './base.js';
-
-const CORDOVA_CSP = '<meta http-equiv="Content-Security-Policy" content="default-src * \'self\' data: gap: \'unsafe-inline\' \'unsafe-eval\'; style-src * \'self\' \'unsafe-inline\' \'unsafe-eval\' gap:; script-src * \'self\' \'unsafe-inline\' \'unsafe-eval\' gap:; frame-src *;" />';
-
-const CORDOVA_VIEWPORT = '<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />';
-
-const CORDOVA_STUB = `/**
- * Stub for non-Cordova environments. Cordova replaces this at runtime on device builds.
- */
-window.cordova = null;
-`;
-
-export class CordovaPackager extends Packager {
-    /** @type {'cordova'} */
-    static id = 'cordova';
-
-    /** @type {string[]} */
-    static defaultPlatforms = ['ios', 'android'];
-
-    needsGameConfig() {
-        return true;
-    }
-
-    /** @param {string} dest */
-    applyTemplates(dest) {
-        fs.writeFileSync(path.join(dest, 'cordova.js'), CORDOVA_STUB);
-        this.log('adaptfully: write cordova.js');
-
-        super.applyTemplates(dest);
-    }
-
-    buildHtmlInjection() {
-        const headExtras = [CORDOVA_CSP, CORDOVA_VIEWPORT];
-        const bodyScripts = ['<script src="cordova.js"></script>'];
-
-        if (this.needsGameConfig()) {
-            bodyScripts.push('<script src="game-config.js"></script>');
-        }
-
-        return this.formatHtmlInjection(headExtras, bodyScripts);
-    }
-}