@makefully/adaptfully 3.0.0 → 3.0.2

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project are documented in this file.
 
+## 3.0.2 — 2026-06-18
+
+### Fixed
+
+- Deploy script paths without a leading `/` are emitted as page-relative `script src` values (for subdirectory hosting).
+
+## 3.0.1 — 2026-06-17
+
+### Added
+
+- `config.htmlInjections` — list of deploy-relative HTML paths to inject during prebuild (default: `["index.html"]`).
+
+### Fixed
+
+- Prebuild injects only configured HTML files instead of scanning every `.html` in the deploy folder.
+
 ## 3.0.0 — 2026-06-17
 
 ### Added

package/README.md

@@ -28,7 +28,7 @@ adaptfully deploy steam     # build + platform release when credentials are pres
 
 | Stage | What it does |
 |-------|----------------|
-| `prebuild` | Copy `deploy/` to `output/<platform>-prebuild/` and inject registrations |
+| `prebuild` | Copy `deploy/` to `output/<platform>-prebuild/` and inject registrations into `config.htmlInjections` |
 | `build` | Prebuild, then POST the result to Wrapfully |
 | `deploy` | Build, then release to the target platform (Steam upload, webapp SFTP, etc. via Wrapfully when credentials are in `assets/meta/publish/`) |
 
@@ -41,7 +41,7 @@ Place `<!-- adaptfully -->` / `<!-- /adaptfully -->` markers in your HTML templa
 adaptfully.register('auth', adaptfully.auth.Google);
 
 // In-game:
-var platform = adaptfully.get('auth');
+const platform = adaptfully.get('auth');
 platform.login(function (result) { /* ... */ });
 ```
 
@@ -68,7 +68,7 @@ Use plugin keys in `config.platforms.<platform>.registrations`. Custom deploy sc
       "web": {
         "registrations": {
           "auth": "google-auth",
-          "storage": "/javascript/adaptfully-bridge.js"
+          "storage": "javascript/adaptfully-bridge.js"
         }
       },
       "dev": {
@@ -81,7 +81,7 @@ Use plugin keys in `config.platforms.<platform>.registrations`. Custom deploy sc
 }
 ```
 
-Standard plugin keys load bundled Adaptfully runtime scripts and emit an inline `adaptfully.register()` call. Path values add a `<script src="...">` tag — the script is expected to call `adaptfully.register()` itself (for example a bridge that wires `storage` and `config`).
+Standard plugin keys load bundled Adaptfully runtime scripts and emit an inline `adaptfully.register()` call. Path values add a `<script src="...">` tag — the script is expected to call `adaptfully.register()` itself (for example a bridge that wires `storage` and `config`). Use a leading `/` for site-root URLs; omit it for paths relative to each HTML page (required when the game is hosted in a subdirectory).
 
 Wrapfully builders (`steam`, `win`, `mac`, `android`, etc.) map to platform keys via defaults (`win` → `steam`) or an explicit `builders` array on the platform config.
 
@@ -90,6 +90,7 @@ Wrapfully builders (`steam`, `win`, `mac`, `android`, etc.) map to platform keys
 ```javascript
 import {
     prebuildPlatform,
+    resolveHtmlInjections,
     runAdaptfullyStage,
     buildAdaptfullyInjection,
     injectAdaptfullyRegistrations,
@@ -103,7 +104,7 @@ import {
 } from '@makefully/adaptfully';
 ```
 
-- **`prebuildPlatform(deployFolder, platformKey, pkg)`** — copy `deploy/` to `output/<platform>-prebuild/` and inject registrations into all HTML files.
+- **`prebuildPlatform(deployFolder, platformKey, pkg)`** — copy `deploy/` to `output/<platform>-prebuild/` and inject registrations into `config.htmlInjections` (default: `index.html`).
 - **`resolveRegistrationAssets(registrations)`** — resolve runtime script paths, inline registration JS, and external script tags for a registration map (useful for Vite dev servers).
 - **`runAdaptfullyStage('prebuild' | 'build' | 'deploy', platformKey, options)`** — run a pipeline stage programmatically.
 
@@ -139,7 +140,7 @@ npx adaptfully <prebuild|build|deploy> <platform> [server] [mode]
 
 | Stage | Description |
 |-------|-------------|
-| `prebuild` | Copy `deploy/` → `output/<platform>-prebuild/` with registrations injected |
+| `prebuild` | Copy `deploy/` → `output/<platform>-prebuild/` with registrations injected into `config.htmlInjections` |
 | `build` | Prebuild, then POST to Wrapfully (no platform release) |
 | `deploy` | Prebuild, POST to Wrapfully, then release when credentials are present |
 
@@ -283,13 +284,13 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
       "web": {
         "registrations": {
           "auth": "google-auth",
-          "storage": "/javascript/adaptfully-bridge.js"
+          "storage": "javascript/adaptfully-bridge.js"
         }
       },
       "steam": {
         "registrations": {
           "auth": "steam-auth",
-          "storage": "/javascript/adaptfully-bridge.js"
+          "storage": "javascript/adaptfully-bridge.js"
         }
       }
     },
@@ -314,6 +315,7 @@ Standard npm fields (`name`, `version`, `description`) are used directly. Add a
 | `twitterId` | Web | Twitter handle for meta tags |
 | `steamId` | Steam | Steam app ID |
 | `deployFolder` | Client | Neutral deploy directory staged before prebuild (default: `deploy`) |
+| `htmlInjections` | Prebuild | Deploy-relative HTML paths to inject (default: `["index.html"]`) |
 | `outputFolder` | Client | Prebuild output root (default: `output`) |
 | `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) |

package/lib/node/index.js

@@ -2,7 +2,7 @@ export { createArchive } from './archive.js';
 export { loadProjectConfig, resolveServerUrl } from './config.js';
 export { send } from './deploy.js';
 export { adaptfullyFromCli, runAdaptfullyStage } from './pipeline.js';
-export { prebuildPlatform, prebuildOutputDir } from './prebuild.js';
+export { prebuildPlatform, prebuildOutputDir, resolveHtmlInjections } from './prebuild.js';
 export { getPackageRoot, getRuntimeDir, resolveRuntimeScript } from './paths.js';
 export {
     STANDARD_PLUGINS,

package/lib/node/prebuild.js

@@ -4,10 +4,32 @@ import {
     adaptfullyInjectionForPlatform,
     injectAdaptfullyRegistrations,
 } from './registrations.js';
-import { copyRecursiveSync, emptyDirSync, listHtmlFilesRecursive } from './fs-utils.js';
+import { copyRecursiveSync, emptyDirSync } from './fs-utils.js';
 
 /** @typedef {'prebuild' | 'build' | 'deploy'} AdaptfullyStage */
 
+const DEFAULT_HTML_INJECTIONS = ['index.html'];
+
+/**
+ * @param {{ config?: { htmlInjections?: string[] } }} pkg
+ * @returns {string[]}
+ */
+export function resolveHtmlInjections(pkg) {
+    const injections = pkg.config?.htmlInjections;
+    if (injections === undefined) {
+        return DEFAULT_HTML_INJECTIONS;
+    }
+    if (!Array.isArray(injections) || injections.length === 0) {
+        throw new Error('config.htmlInjections must be a non-empty array of paths relative to the deploy folder');
+    }
+    for (const entry of injections) {
+        if (typeof entry !== 'string' || !entry.length) {
+            throw new Error('config.htmlInjections entries must be non-empty strings');
+        }
+    }
+    return injections;
+}
+
 /**
  * @param {string} platformKey
  * @param {{ config?: { platforms?: Record<string, unknown>, outputFolder?: string } }} pkg
@@ -53,7 +75,12 @@ export function prebuildPlatform(deployFolder, platformKey, pkg, options = {}) {
 
     const injection = adaptfullyInjectionForPlatform(platformKey, pkg, { log });
     if (injection) {
-        for (const htmlPath of listHtmlFilesRecursive(dest)) {
+        for (const relativePath of resolveHtmlInjections(pkg)) {
+            const htmlPath = path.join(dest, relativePath);
+            if (!fs.existsSync(htmlPath)) {
+                throw new Error(`htmlInjections file not found in deploy output: ${relativePath}`);
+            }
+            log(`adaptfully: inject ${relativePath}`);
             injectAdaptfullyIntoHtmlFile(htmlPath, injection);
         }
     }

package/lib/node/registrations.js

@@ -83,7 +83,7 @@ export function collectRegistrationParts(registrations) {
         }
 
         if (isDeployPath(value)) {
-            const src = value.startsWith('/') ? value : `/${value.replace(/^\.\//, '')}`;
+            const src = normalizeDeployScriptSrc(value);
             deployScripts.push({ key: registerKey, src });
             continue;
         }
@@ -130,6 +130,17 @@ function isDeployPath(value) {
     return value.startsWith('/') || value.startsWith('./') || value.includes('/');
 }
 
+/**
+ * @param {string} value Deploy-relative script path from config
+ * @returns {string} Value for HTML script src (leading `/` = site root; otherwise page-relative)
+ */
+function normalizeDeployScriptSrc(value) {
+    if (value.startsWith('/')) {
+        return value;
+    }
+    return value.replace(/^\.\//, '');
+}
+
 /**
  * @param {string} builder
  * @param {Record<string, { builders?: string[], registrations?: RegistrationMap }>} [platforms]
@@ -178,8 +189,7 @@ export function buildAdaptfullyInjection(registrations, options = {}) {
 
     for (const [registerKey, value] of Object.entries(registrations)) {
         if (isDeployPath(value)) {
-            const src = value.startsWith('/') ? value : `/${value.replace(/^\.\//, '')}`;
-            log(`adaptfully: registering ${registerKey} ← ${src}`);
+            log(`adaptfully: registering ${registerKey} ← ${normalizeDeployScriptSrc(value)}`);
         } else {
             log(`adaptfully: registering ${registerKey} ← ${value}`);
         }
@@ -233,7 +243,7 @@ export function injectAdaptfullyRegistrations(html, injection) {
     }
 
     throw new Error(
-        'Cannot inject Adaptfully registrations: index.html needs '
+        'Cannot inject Adaptfully registrations: HTML needs '
         + '<!-- adaptfully -->…<!-- /adaptfully -->, <!-- scripts -->, or </head>',
     );
 }

package/package.json

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