fix(runtime): guard page bootstrap contract

Agent-Logs-Url: https://github.com/Starisian-Technologies/sparxstar-starmus-audio/sessions/8a8980e0-073d-4308-b02a-fe8fde421acc

Co-authored-by: MaximillianGroup <34328348+MaximillianGroup@users.noreply.github.com>

Author: Copilot

src/core/StarmusAssetLoader.php

@@ -425,18 +425,18 @@ private function build_bootstrap_merge_script(): string
         return <<<'JS'
 // The asset loader composes the final runtime bootstrap immediately before this
 // bundle executes. Only page-surface fields may override the base bootstrap.
-window.STARMUS_BOOTSTRAP = Object.assign(
-    {},
-    window.STARMUS_BOOTSTRAP_BASE || {},
-    ((page) => ({
-        pageType: page.pageType,
-        mode: page.mode,
-        postId: page.postId,
-        canCommit: page.canCommit,
-        artifact: page.artifact,
-        hosts: page.hosts,
-    }))(window.STARMUS_BOOTSTRAP_PAGE || {})
-);
+window.STARMUS_BOOTSTRAP = Object.assign({}, window.STARMUS_BOOTSTRAP_BASE || {});
+
+if (window.STARMUS_BOOTSTRAP_PAGE && typeof window.STARMUS_BOOTSTRAP_PAGE === "object") {
+    window.STARMUS_BOOTSTRAP = Object.assign(window.STARMUS_BOOTSTRAP, {
+        pageType: window.STARMUS_BOOTSTRAP_PAGE.pageType || "unknown",
+        mode: window.STARMUS_BOOTSTRAP_PAGE.mode || "unknown",
+        postId: window.STARMUS_BOOTSTRAP_PAGE.postId || 0,
+        canCommit: Boolean(window.STARMUS_BOOTSTRAP_PAGE.canCommit),
+        artifact: window.STARMUS_BOOTSTRAP_PAGE.artifact || window.STARMUS_BOOTSTRAP.artifact,
+        hosts: window.STARMUS_BOOTSTRAP_PAGE.hosts || null,
+    });
+}
 JS;
     }
 

src/core/StarmusUiPackageResolver.php

@@ -27,7 +27,7 @@ public function __construct(
         private readonly string $base_path = ''
     ) {
         if ($this->base_url === '' || $this->base_path === '') {
-            throw new InvalidArgumentException('StarmusUiPackageResolver requires non-empty base URL and base path.');
+            throw new InvalidArgumentException('StarmusUiPackageResolver requires both base_url and base_path to be non-empty strings.');
         }
     }
 

src/js/starmus-main.js

@@ -137,12 +137,21 @@ function getRuntimeBootstrap() {
     // STARMUS_BOOTSTRAP is composed by PHP via wp_add_inline_script(..., 'before')
     // immediately before this bundle executes, so the merged object is the
     // authoritative runtime contract for initialization.
+    if (!window.STARMUS_BOOTSTRAP_PAGE || typeof window.STARMUS_BOOTSTRAP_PAGE !== "object") {
+        console.warn("[StarmusMain] Missing STARMUS_BOOTSTRAP_PAGE.");
+        return null;
+    }
+
     if (!window.STARMUS_BOOTSTRAP || typeof window.STARMUS_BOOTSTRAP !== "object") {
         console.warn("[StarmusMain] Missing STARMUS_BOOTSTRAP.");
         return null;
     }
 
-    if (!window.STARMUS_BOOTSTRAP.pageType || !window.STARMUS_BOOTSTRAP.hosts) {
+    if (
+        !window.STARMUS_BOOTSTRAP.pageType ||
+        window.STARMUS_BOOTSTRAP.pageType === "unknown" ||
+        !window.STARMUS_BOOTSTRAP.hosts
+    ) {
         console.warn("[StarmusMain] Incomplete STARMUS_BOOTSTRAP.");
         return null;
     }

src/templates/starmus-audio-editor-ui.php

@@ -42,8 +42,8 @@
 
 <!-- JS Bootstrap Data -->
 <script>
-    window.STARMUS_BOOTSTRAP_PAGE = JSON.parse('<?php echo esc_js((string) wp_json_encode($bootstrap_page, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT)); ?>');
-    window.STARMUS_EDITOR_DATA = JSON.parse('<?php echo esc_js((string) wp_json_encode($editor_data, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT)); ?>');
+    window.STARMUS_BOOTSTRAP_PAGE = <?php echo wp_json_encode($bootstrap_page, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT); ?>;
+    window.STARMUS_EDITOR_DATA = <?php echo wp_json_encode($editor_data, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT); ?>;
 </script>
 
 

src/templates/starmus-audio-re-recorder-ui.php

@@ -41,7 +41,7 @@
 ];
 ?>
 <script>
-    window.STARMUS_BOOTSTRAP_PAGE = JSON.parse('<?php echo esc_js((string) wp_json_encode($bootstrap_page, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT)); ?>');
+    window.STARMUS_BOOTSTRAP_PAGE = <?php echo wp_json_encode($bootstrap_page, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT); ?>;
 </script>
 <div class="starmus-audio-re-recorder-wrapper" data-starmus="recorder" data-starmus-mode="update" data-starmus-instance="<?php echo esc_attr($instance_id); ?>">
     <div class="starmus-recorder-form sparxstar-glass-card">

src/templates/starmus-audio-recorder-ui.php

@@ -53,7 +53,7 @@
 
 ?>
 <script>
-    window.STARMUS_BOOTSTRAP_PAGE = JSON.parse('<?php echo esc_js((string) wp_json_encode($bootstrap_page, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT)); ?>');
+    window.STARMUS_BOOTSTRAP_PAGE = <?php echo wp_json_encode($bootstrap_page, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT); ?>;
 </script>
 <div class="starmus-audio-recorder-wrapper" data-starmus="recorder" data-starmus-mode="create" data-starmus-instance="<?php echo esc_attr($instance_id); ?>">
     <div id="starmus-app" class="starmus-recorder-form sparxstar-glass-card">