@makefully/adaptfully 3.0.1 → 3.0.2

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 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

package/README.md

@@ -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.
 
@@ -284,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"
         }
       }
     },

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}`);
         }

package/package.json

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