@makefully/adaptfully 3.12.0 → 3.13.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project are documented in this file.
 
+## 3.13.0 — 2026-07-24
+
+### Added
+
+- **Per-platform `config.*` overrides** — `config.platforms.<key>.packageName` (and other identity/branding fields) override top-level `config.*` defaults for that platform. Control fields (`packager`, `registrations`, `builder`, `deployments`, `steamId`, `socialLogin`, `steamworks`) are unchanged. Helpers: `resolvePlatformConfig`, `getConfigValue`, `resolveConfigForBuild`.
+
+## 3.12.1 — 2026-07-23
+
+### Fixed
+
+- **Publish path prompts** — strip wrapping quotes from user-supplied paths (e.g. pasted `"D:\…\key.json"`) so absolute paths are not treated as project-relative.
+
 ## 3.12.0 — 2026-07-23
 
 ### Added

package/README.md

@@ -437,13 +437,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, Electron, UWP | Reverse-DNS identifier (`com.company.game`) |
+| `packageName` | Cordova, Capacitor, Electron, UWP, Play upload | Reverse-DNS identifier (`com.company.game`) |
 | `publisherDisplayName` | Cordova, Electron, web | Short publisher name |
 | `publisherFullName` | Electron | Legal entity name for copyright |
 | `publisherWebsite` | Cordova, web | Company URL |
 | `publisherEmailAddress` | Cordova | Contact email |
 | `scope` | Web/PWA | Base URL scope for the web app |
-| `themeColor` | Cordova, Electron, UWP, web | Loading screen / theme color |
+| `themeColor` | Cordova, 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"]`) |
@@ -454,8 +454,29 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
 | `platforms.<name>.packager` | Prebuild | `web` (default), `electron`, `cordova`, 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:
+
+```json
+"config": {
+  "packageName": "com.example.game",
+  "title": "My Game",
+  "platforms": {
+    "android": {
+      "packager": "capacitor",
+      "packageName": "com.example.game.android"
+    },
+    "android-dev": {
+      "packager": "capacitor",
+      "packageName": "com.example.game.dev"
+    }
+  }
+}
+```
+
+
 ### `wrapfully.json`
 
 Optional. Fields are shallow-merged into `package.json`'s `config`:

package/lib/node/apple-publish.js

@@ -7,6 +7,7 @@ import {
     ensureDeploymentManifest,
     ensurePublishCredentialsGitignore,
     parsePublishCredentialArgv,
+    resolveUserPath,
 } from './publish-credentials.js';
 
 /**
@@ -82,7 +83,7 @@ export async function runApplePublish(options = {}) {
     let appleJson;
 
     if (options.from) {
-        const fromPath = path.resolve(options.from);
+        const fromPath = resolveUserPath(options.from);
         let raw;
 
         try {

package/lib/node/google-publish.js

@@ -6,6 +6,7 @@ import {
     ensurePublishCredentialsGitignore,
     parsePublishCredentialArgv,
     promptRequired,
+    resolveUserPath,
 } from './publish-credentials.js';
 
 const GOOGLE_REQUIRED_FIELDS = [
@@ -72,7 +73,7 @@ export async function runGooglePublish(options = {}) {
         options.output ?? defaultGooglePublishPath(projectRoot, deploymentKey),
     );
 
-    const fromPath = path.resolve(
+    const fromPath = resolveUserPath(
         await promptRequired(
             'Path to Google Play service account JSON: ',
             options.from ?? process.env.GOOGLE_APPLICATION_CREDENTIALS,

package/lib/node/index.js

@@ -1,6 +1,12 @@
 export { buildOutputDir, clearStaleBuildExtract, resolveBuildArtifactDir } from './artifacts.js';
 export { createArchive, createDeployArchive, createReleaseArchive, createSourceArchive } from './archive.js';
 export { loadProjectConfig, resolveServerUrl } from './config.js';
+export {
+    getConfigValue,
+    PLATFORM_CONTROL_KEYS,
+    resolveConfigForBuild,
+    resolvePlatformConfig,
+} from './platform-config.js';
 export { send } from './deploy.js';
 export {
     appendMetaIcons,
@@ -54,9 +60,11 @@ export {
     defaultDeploymentCredentialPath,
     ensureDeploymentManifest,
     ensurePublishCredentialsGitignore,
+    normalizeUserPath,
     parsePublishCredentialArgv,
     promptRequired,
     PUBLISH_CREDENTIAL_GITIGNORE_PATTERNS,
+    resolveUserPath,
 } from './publish-credentials.js';
 export {
     buildSteamPublishJson,

package/lib/node/packagers/base.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { STANDARD_PLUGINS } from '../registrations.js';
+import { resolvePlatformConfig } from '../platform-config.js';
 
 /** @typedef {import('../registrations.js').RegistrationMap} RegistrationMap */
 /** @typedef {'web' | 'electron' | 'cordova' | 'capacitor'} PackagerName */
@@ -38,15 +39,17 @@ function gameConfigPlatform(platformKey) {
 /**
  * @param {string} dest
  * @param {string} platformKey
- * @param {{ name: string, version: string, config?: { title?: string } }} pkg
+ * @param {{ name: string, version: string, config?: object }} pkg
  * @param {(message: string) => void} log
  */
 function writeGameConfig(dest, platformKey, pkg, log) {
+    const config = resolvePlatformConfig(pkg, platformKey);
     const content = `window.gameConfig = ${JSON.stringify({
-        title: pkg.config?.title,
+        title: config.title,
         version: pkg.version,
         id: pkg.name,
         platform: gameConfigPlatform(platformKey),
+        packageName: config.packageName,
     }, null, 4)};`;
 
     fs.writeFileSync(path.join(dest, 'game-config.js'), content);

package/lib/node/packagers/electron.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { Packager } from './base.js';
+import { resolvePlatformConfig } from '../platform-config.js';
 
 const STEAM_INIT = `const path = require('path');
 
@@ -221,8 +222,10 @@ export class ElectronPackager extends Packager {
 
     /** @param {string} dest */
     writeElectronMain(dest) {
-        const withSteam = this.usesPlugin('steam-auth');
-        const mainContent = buildElectronMain(withSteam, this.pkg.config?.themeColor);
+        const
+            withSteam = this.usesPlugin('steam-auth'),
+            config = resolvePlatformConfig(this.pkg, this.platformKey),
+            mainContent = buildElectronMain(withSteam, config.themeColor);
 
         if (withSteam) {
             const steamId = resolvePlatformSteamId(this.platformKey, this.pkg);

package/lib/node/platform-config.js

@@ -0,0 +1,81 @@
+/**
+ * Keys that configure platform behavior (not inherited identity/defaults).
+ * These stay on `platforms.<key>` and are not treated as config.* overrides.
+ */
+export const PLATFORM_CONTROL_KEYS = new Set([
+    'registrations',
+    'builder',
+    'builders',
+    'packager',
+    'deployments',
+    'steamId',
+    'socialLogin',
+    'steamworks',
+]);
+
+/**
+ * Resolve effective `config` for a platform: top-level `config.*` are defaults;
+ * any non-control field on `config.platforms.<platformKey>` overrides them.
+ *
+ * @param {{ config?: Record<string, unknown> }} pkg
+ * @param {string | null | undefined} platformKey
+ * @returns {Record<string, unknown>}
+ */
+export function resolvePlatformConfig(pkg, platformKey) {
+    const root = pkg?.config && typeof pkg.config === 'object' ? pkg.config : {};
+    /** @type {Record<string, unknown>} */
+    const resolved = { ...root };
+    delete resolved.platforms;
+
+    if (!platformKey || typeof platformKey !== 'string') {
+        return resolved;
+    }
+
+    const platform = root.platforms?.[platformKey];
+    if (!platform || typeof platform !== 'object' || Array.isArray(platform)) {
+        return resolved;
+    }
+
+    for (const [key, value] of Object.entries(platform)) {
+        if (PLATFORM_CONTROL_KEYS.has(key) || value === undefined) {
+            continue;
+        }
+        resolved[key] = value;
+    }
+
+    return resolved;
+}
+
+/**
+ * @param {{ config?: Record<string, unknown> }} pkg
+ * @param {string | null | undefined} platformKey
+ * @param {string} key
+ * @param {unknown} [fallback]
+ */
+export function getConfigValue(pkg, platformKey, key, fallback) {
+    const resolved = resolvePlatformConfig(pkg, platformKey);
+    return resolved[key] !== undefined ? resolved[key] : fallback;
+}
+
+/**
+ * Prefer a platform whose key matches the deployment key (e.g. deploy "android"
+ * → platforms.android), else the build's platformKey.
+ *
+ * @param {{ config?: Record<string, unknown> }} pkg
+ * @param {{ platformKey?: string | null, deploymentKey?: string | null }} [context]
+ */
+export function resolveConfigForBuild(pkg, context = {}) {
+    const { platformKey = null, deploymentKey = null } = context;
+    const platforms = pkg?.config?.platforms;
+
+    if (
+        deploymentKey
+        && platforms
+        && typeof platforms === 'object'
+        && platforms[deploymentKey]
+    ) {
+        return resolvePlatformConfig(pkg, deploymentKey);
+    }
+
+    return resolvePlatformConfig(pkg, platformKey);
+}

package/lib/node/publish-credentials.js

@@ -158,6 +158,35 @@ export async function ensureDeploymentManifest(deploymentDir, type, log = consol
     return { manifestPath, created: false, updated: true };
 }
 
+/**
+ * Strip wrapping quotes and whitespace from a user-supplied filesystem path.
+ * Quoted absolute paths (common when pasting on Windows) must not be treated as relative.
+ *
+ * @param {string} value
+ * @returns {string}
+ */
+export function normalizeUserPath(value) {
+    let result = String(value).trim();
+
+    if (
+        (result.startsWith('"') && result.endsWith('"'))
+        || (result.startsWith("'") && result.endsWith("'"))
+    ) {
+        result = result.slice(1, -1).trim();
+    }
+
+    return result;
+}
+
+/**
+ * @param {string} value
+ * @param {string} [base]
+ * @returns {string}
+ */
+export function resolveUserPath(value, base = process.cwd()) {
+    return path.resolve(base, normalizeUserPath(value));
+}
+
 /**
  * @param {string} prompt
  * @param {string} [existing]
@@ -165,13 +194,13 @@ export async function ensureDeploymentManifest(deploymentDir, type, log = consol
  */
 export async function promptRequired(prompt, existing) {
     if (existing != null && String(existing).trim() !== '') {
-        return String(existing).trim();
+        return normalizeUserPath(existing);
     }
 
     const rl = readline.createInterface({ input, output });
 
     try {
-        const value = String(await rl.question(prompt)).trim();
+        const value = normalizeUserPath(await rl.question(prompt));
         if (!value) {
             throw new Error(`${prompt.replace(/:\s*$/, '')} is required.`);
         }
@@ -196,15 +225,15 @@ export function parsePublishCredentialArgv(argv, startIndex = 3) {
         const arg = argv[i];
 
         if (arg === '--from' && argv[i + 1]) {
-            options.from = argv[++i];
+            options.from = normalizeUserPath(argv[++i]);
         } else if (arg === '--output' && argv[i + 1]) {
-            options.output = argv[++i];
+            options.output = normalizeUserPath(argv[++i]);
         } else if (arg === '--deployment' && argv[i + 1]) {
             options.deployment = argv[++i];
         } else if (arg === '--project-root' && argv[i + 1]) {
-            options.projectRoot = argv[++i];
+            options.projectRoot = normalizeUserPath(argv[++i]);
         } else if (arg === '--steamcmd-dir' && argv[i + 1]) {
-            options.steamcmdDir = argv[++i];
+            options.steamcmdDir = normalizeUserPath(argv[++i]);
         } else if (arg === '--category' && argv[i + 1]) {
             options.category = argv[++i];
         } else if (arg === '--identity' && argv[i + 1]) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@makefully/adaptfully",
-    "version": "3.12.0",
+    "version": "3.13.0",
     "description": "Platform abstraction and Wrapfully deploy client for Makefully games",
     "type": "module",
     "main": "./lib/node/index.js",