@needle-tools/engine 6.0.0-alpha.4 → 6.0.0-alpha.6

package/plugins/license/index.js

@@ -0,0 +1,24 @@
+// @ts-check
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { getMeta } from "../common/config.cjs";
+import { resolveLicense } from "../common/license.js";
+
+/**
+ * Write a signed license file for a site that does not use a Needle build plugin.
+ * The file contains only the public, signed JWT. Never write the Cloud access token.
+ * @param {{ out?: string, team?: string, accessToken?: string }} [options]
+ * @returns {Promise<{ output: string, signed: boolean }>}
+ */
+export async function generateLicenseFile(options = {}) {
+    const output = resolve(options.out ?? "public/needle-license.json");
+    mkdirSync(dirname(output), { recursive: true });
+    // Clear a previous license before resolving, including when resolution throws.
+    writeFileSync(output, '{"jwt":""}\n');
+    const team = options.team ?? getMeta()?.license?.team;
+    const license = /** @type {{ jwt: string | null } | null} */ (
+        /** @type {unknown} */ (await resolveLicense({ team, accessToken: options.accessToken }))
+    );
+    if (license?.jwt) writeFileSync(output, JSON.stringify({ jwt: license.jwt }) + "\n");
+    return { output, signed: Boolean(license?.jwt) };
+}

package/plugins/vite/license.js

@@ -49,12 +49,12 @@ export function needleLicense(command, config, userSettings) {
                 let modified = false;
 
                 // Replace license type
-                const index = src.indexOf("btgRyBvJ");
+                const index = src.indexOf("__deG");
                 if (index >= 0) {
                     const end = src.indexOf(";", index);
                     if (end >= 0) {
                         const line = src.substring(index, end);
-                        const replaced = "btgRyBvJ = \"" + licenseResult.type + "\"";
+                        const replaced = "__deG = \"" + licenseResult.type + "\"";
                         src = src.replace(line, replaced);
                         modified = true;
                     }
@@ -62,12 +62,12 @@ export function needleLicense(command, config, userSettings) {
 
                 // Replace license JWT (same pattern)
                 if (licenseResult.jwt) {
-                    const jwtIndex = src.indexOf("__rmQg");
+                    const jwtIndex = src.indexOf("yDKPfo");
                     if (jwtIndex >= 0) {
                         const jwtEnd = src.indexOf(";", jwtIndex);
                         if (jwtEnd >= 0) {
                             const jwtLine = src.substring(jwtIndex, jwtEnd);
-                            const jwtReplaced = "__rmQg = \"" + licenseResult.jwt + "\"";
+                            const jwtReplaced = "yDKPfo = \"" + licenseResult.jwt + "\"";
                             src = src.replace(jwtLine, jwtReplaced);
                             modified = true;
                         }

package/src/engine/api.ts

@@ -237,7 +237,7 @@ export * from "./engine_input.js";
 export { InstancingUtil } from "./engine_instancing.js";
 
 /** License checking utilities */
-export { _$IqaqwY, $TNE, $vnStLM } from "./engine_license.js";
+export { KLnyx, _$sHuA, $jVksoCHS } from "./engine_license.js";
 
 
 // ============================================================================

package/src/engine/engine_init.ts

@@ -8,7 +8,7 @@ import { initBuiltinTypes } from "./codegen/register_types.js";
 import { initSpatialConsole } from "./debug/debug_spatial_console.js";
 import { initAddressableSerializers } from "./engine_addressables.js";
 import { ensureAudioContextIsResumed } from "./engine_audio.js";
-import { FiUWO } from "./engine_license.js";
+import { $bqSkkSKJ } from "./engine_license.js";
 import { initNeedleLoader } from "./engine_loaders.js";
 import { initPhysics } from "./engine_physics_rapier.js";
 import { initBuiltinSerializers } from "./engine_serialization_builtin_serializer.js";
@@ -59,7 +59,7 @@ export function initEngine() {
     initPhysics();
     initXR();
     initSpatialConsole();
-    FiUWO();
+    $bqSkkSKJ();
 
     // Must be last. customElements.define() upgrades existing <needle-engine>
     // elements synchronously, which can trigger context.create() and dispatch

package/src/engine/engine_license.ts

@@ -42,19 +42,19 @@ function setLicenseTimeout(ctx: IContext, callback: () => void, delay: number) {
     return timer;
 }
 
-const _$zlWB: ((result: boolean) => void)[] = [];
+const _$hziI: ((result: boolean) => void)[] = [];
 
 // DO NOT EDIT MANUALLY
-let btgRyBvJ: string = "";
+let __deG: string = "";
 // eslint-disable-next-line prefer-const
-let __rmQg: string = "";
+let yDKPfo: string = "";
 
 if (debug) {
-    console.log("License Type: " + btgRyBvJ);
-    if (__rmQg) {
-        console.log("License JWT: " + __rmQg);
+    console.log("License Type: " + __deG);
+    if (yDKPfo) {
+        console.log("License JWT: " + yDKPfo);
         try {
-            const payload = JSON.parse(atob(__rmQg.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
+            const payload = JSON.parse(atob(yDKPfo.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
             console.log("License JWT payload:", payload);
         }
         catch { console.log("License JWT payload: (failed to decode)"); }
@@ -65,8 +65,8 @@ if (debug) {
 }
 
 /** @internal */
-export function $vnStLM() {
-    switch (btgRyBvJ) {
+export function $jVksoCHS() {
+    switch (__deG) {
         case "pro":
         case "enterprise":
             return true;
@@ -75,8 +75,8 @@ export function $vnStLM() {
 }
 
 /** @internal */
-export function $TNE() {
-    switch (btgRyBvJ) {
+export function _$sHuA() {
+    switch (__deG) {
         case "indie":
             return true;
     }
@@ -84,8 +84,8 @@ export function $TNE() {
 }
 
 /** @internal */
-export function $wyQnLr() {
-    switch (btgRyBvJ) {
+export function $BZiUJx() {
+    switch (__deG) {
         case "edu":
             return true;
     }
@@ -93,26 +93,26 @@ export function $wyQnLr() {
 }
 
 /** @internal */
-export function _$IqaqwY() {
-    return $vnStLM() || $TNE() || $wyQnLr();
+export function KLnyx() {
+    return $jVksoCHS() || _$sHuA() || $BZiUJx();
 }
 
 
 /** @internal */
-export function __YPGv(cb: (result: boolean) => void) {
-    if ($vnStLM() || $TNE() || $wyQnLr()) {
+export function _$jODX(cb: (result: boolean) => void) {
+    if ($jVksoCHS() || _$sHuA() || $BZiUJx()) {
         cb(true);
         return () => {};
     }
-    _$zlWB.push(cb);
+    _$hziI.push(cb);
     return () => {
-        const index = _$zlWB.indexOf(cb);
-        if (index >= 0) _$zlWB.splice(index, 1);
+        const index = _$hziI.indexOf(cb);
+        if (index >= 0) _$hziI.splice(index, 1);
     };
 }
 
-function SpVw(result: boolean) {
-    for (const cb of _$zlWB) {
+function __QVQhCm(result: boolean) {
+    for (const cb of _$hziI) {
         try {
             cb(result);
         }
@@ -127,7 +127,7 @@ function SpVw(result: boolean) {
 
 // ECDSA P-256 public key for verifying license JWTs (verification-only, safe to ship)
 /* eslint-disable no-secrets/no-secrets -- public key, not a secret */
-const __xEfpTWY = {
+const _UHT = {
     kty: "EC",
     crv: "P-256",
     x: "A34nyKMjhQYVgzeE4tyLUYdx34TAKogDa7v7PRaO9Lg",
@@ -151,7 +151,7 @@ function base64urlDecode(str: string): Uint8Array {
  * Verify a JWT license token and return the `type` claim if valid.
  * Returns null if the JWT is missing, malformed, or has an invalid signature.
  */
-async function QyCIa(jwt: string): Promise<string | null> {
+async function _$IUNmiHVF(jwt: string): Promise<string | null> {
     if (!jwt) return null;
     try {
         const parts = jwt.split(".");
@@ -161,7 +161,7 @@ async function QyCIa(jwt: string): Promise<string | null> {
 
         const key = await crypto.subtle.importKey(
             "jwk",
-            __xEfpTWY,
+            _UHT,
             { name: "ECDSA", namedCurve: "P-256" },
             false,
             ["verify"]
@@ -221,24 +221,40 @@ async function QyCIa(jwt: string): Promise<string | null> {
 }
 
 /** Verify the injected JWT and update the license type if valid.
- * The engine ONLY trusts the JWT — the plain btgRyBvJ string is ignored. */
+ * The engine ONLY trusts the JWT — the plain __deG string is ignored. */
 let _jwtVerificationPromise: Promise<void> | undefined = undefined;
-async function __hSxthgWC(): Promise<void> {
-    // NOTE: do NOT add an `if (!__rmQg) return` guard here.
-    // esbuild (Vite dependency pre-bundling) would see the variable as constant ""
-    // and tree-shake the entire JWT verification code path.
-    const jwt = __rmQg;
-    // Clear after reading — this reassignment also prevents esbuild from
-    // constant-folding the variable (it now has multiple assignment sites).
-    __rmQg = "";
-    const verifiedType = await QyCIa(jwt);
+async function wJwFeUbX(): Promise<void> {
+    // The bundled JWT may be empty when a build supplies a signed license file.
+    // Do not return early: the meta tag below may provide the JWT instead.
+    // Keep the bundled binding mutable so Vite's esbuild pre-bundling does not
+    // treat its initial empty value as constant and remove JWT verification.
+    let jwt = yDKPfo;
+    // Clear the bundled JWT after reading it; this assignment keeps the binding mutable.
+    yDKPfo = "";
+    if (!jwt && typeof document !== "undefined") {
+        const licenseFile = document.querySelector('meta[name="needle-license"]')?.getAttribute("content");
+        if (licenseFile) {
+            try {
+                const url = new URL(licenseFile, document.baseURI);
+                const response = await fetch(url, { cache: "no-store" });
+                if (response.ok) {
+                    const data = await response.json();
+                    if (typeof data?.jwt === "string") jwt = data.jwt;
+                }
+            }
+            catch (err) {
+                if (debug) console.warn("Could not load signed license file", err);
+            }
+        }
+    }
+    const verifiedType = await _$IUNmiHVF(jwt);
     if (verifiedType) {
-        btgRyBvJ = verifiedType;
+        __deG = verifiedType;
         if (debug) console.log("License type set from verified JWT: " + verifiedType);
-        SpVw(_$IqaqwY());
+        __QVQhCm(KLnyx());
     }
     else {
-        btgRyBvJ = "basic";
+        __deG = "basic";
         if (debug && jwt) console.warn("JWT verification failed — license reset to basic");
     }
 }
@@ -361,7 +377,7 @@ export namespace Telemetry {
         // NOTE: this does NOT affect license enforcement — the /check call, the "forbidden"
         // overlay and the watermark/logo run on separate, ungated code paths.
         const attribute = domElement?.getAttribute("no-telemetry");
-        if ($vnStLM() && (attribute === "" || attribute === "true" || attribute === "1")) {
+        if ($jVksoCHS() && (attribute === "" || attribute === "true" || attribute === "1")) {
             if (debug) console.debug("Telemetry is disabled via no-telemetry attribute");
             return false;
         }
@@ -689,18 +705,21 @@ export namespace Telemetry {
 }
 
 
-export function FiUWO() {
+export function $bqSkkSKJ() {
 
-    if(btgRyBvJ === "") btgRyBvJ = "basic";
+    if(__deG === "") __deG = "basic";
 
     // Start JWT verification — must be here (not top-level) to avoid tree-shaking
-    _jwtVerificationPromise = __hSxthgWC();
+    _jwtVerificationPromise = wJwFeUbX();
+    // Start after setting the initial type. At module scope the type was still "",
+    // so Basic builds skipped the runtime check entirely.
+    _$cThps = __zwPG();
 
     Telemetry.init();
     ContextRegistry.registerCallback(ContextEvent.ContextRegistered, evt => {
-        __zUywTXF(evt.context);
-        $FUD(evt.context);
-        setLicenseTimeout(evt.context, () => __jDHSHz(evt.context), 2000);
+        pTWobY(evt.context);
+        _$XfWxk(evt.context);
+        setLicenseTimeout(evt.context, () => _YuMDhu(evt.context), 2000);
     });
     // ContextCreated fires after the renderer exists, so the canvas is available for context-loss monitoring
     ContextRegistry.registerCallback(ContextEvent.ContextCreated, evt => {
@@ -709,17 +728,17 @@ export function FiUWO() {
     });
 }
 
-export let __BOmm: Promise<void> | undefined = undefined;
+export let _$cThps: Promise<void> | undefined = undefined;
 let applicationIsForbidden = false;
 let applicationForbiddenText = "";
-async function _$CByS() {
+async function __zwPG() {
     // Only perform the runtime license check once
-    if (__BOmm) return __BOmm;
+    if (_$cThps) return _$cThps;
     // Wait for JWT verification to complete first (if running)
     if (_jwtVerificationPromise) {
         await _jwtVerificationPromise;
     }
-    if (btgRyBvJ === "basic") {
+    if (__deG === "basic") {
         try {
             const licenseUrl = "https://needle.tools/api/v1/needle-engine/check?location=" + encodeURIComponent(window.location.href) + "&version=" + VERSION + "&generator=" + encodeURIComponent(GENERATOR);
             const res = await fetch(licenseUrl, {
@@ -731,29 +750,27 @@ async function _$CByS() {
             if (res?.status === 200) {
                 applicationIsForbidden = false;
                 if (debug) console.log("License check succeeded");
-                btgRyBvJ = "pro";
-                SpVw(true);
+                __deG = "pro";
+                __QVQhCm(true);
             }
             else if (res?.status === 403) {
-                SpVw(false);
+                __QVQhCm(false);
                 applicationIsForbidden = true;
                 applicationForbiddenText = await res.text();
             }
             else {
-                SpVw(false);
+                __QVQhCm(false);
                 if (debug) console.log("License check failed with status " + res?.status);
             }
         }
         catch (err) {
-            SpVw(false);
+            __QVQhCm(false);
             if (debug) console.error("License check failed", err);
         }
     }
-    else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + btgRyBvJ + "\"");
+    else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + __deG + "\"");
 }
-__BOmm = _$CByS();
-
-async function $FUD(ctx: IContext) {
+async function _$XfWxk(ctx: IContext) {
     function createForbiddenElement() {
         const div = document.createElement("div");
         div.className = "needle-forbidden";
@@ -818,40 +835,40 @@ async function $FUD(ctx: IContext) {
     }, 500)
 }
 
-async function __zUywTXF(ctx: IContext) {
+async function pTWobY(ctx: IContext) {
     try {
-        if (!$vnStLM() && !$TNE()) {
-            return fFIu(ctx);
+        if (!$jVksoCHS() && !_$sHuA()) {
+            return $KXTmgnjE(ctx);
         }
     }
     catch (err) {
         if (debug) console.log("License check failed", err)
-        return fFIu(ctx)
+        return $KXTmgnjE(ctx)
     }
-    if (debug) fFIu(ctx)
+    if (debug) $KXTmgnjE(ctx)
 }
 
 
 
-async function fFIu(ctx: IContext) {
+async function $KXTmgnjE(ctx: IContext) {
 
     // if the engine loads faster than the license check, we need to capture the ready event here
     let isReady = false;
     ctx.domElement.addEventListener("ready", () => isReady = true);
 
-    await __BOmm?.catch(() => { });
+    await _$cThps?.catch(() => { });
 
 
-    if ($vnStLM() || $TNE()) return;
-    if (_$IqaqwY() === false) Yjj();
+    if ($jVksoCHS() || _$sHuA()) return;
+    if (KLnyx() === false) $vKd();
 
     // check if the engine is already ready (meaning has finished loading)
     if (isReady) {
-        fWqZoV(ctx);
+        __OzoZ(ctx);
     }
     else {
         ctx.domElement.addEventListener("ready", () => {
-            fWqZoV(ctx);
+            __OzoZ(ctx);
         });
     }
 }
@@ -859,7 +876,7 @@ async function fFIu(ctx: IContext) {
 // const licenseElementIdentifier = "needle-license-element";
 // const licenseDuration = 10000;
 // const licenseDelay = 1200;
-function fWqZoV(ctx: IContext) {
+function __OzoZ(ctx: IContext) {
 
     const style = `
         position: relative;
@@ -872,7 +889,7 @@ function fWqZoV(ctx: IContext) {
         padding: 10px;
         padding-left: 30px;
     `;
-    if (btgRyBvJ === "edu") {
+    if (__deG === "edu") {
         if (navigator.webdriver) {
             console.log("This project is supported by Needle for Education – https://needle.tools");
         }
@@ -929,7 +946,7 @@ function fWqZoV(ctx: IContext) {
         }
     }, 1000);
 
-    if ($wyQnLr()) {
+    if ($BZiUJx()) {
         const removeDelay = 20_000;
         setLicenseTimeout(ctx, () => {
             clearInterval(interval);
@@ -938,7 +955,7 @@ function fWqZoV(ctx: IContext) {
             const intervalInMinutes = 5;
             setLicenseTimeout(ctx, () => {
                 if (ctx.domElement.parentNode)
-                    fWqZoV(ctx);
+                    __OzoZ(ctx);
             }, 1000 * 60 * intervalInMinutes)
         }, removeDelay);
     }
@@ -949,7 +966,7 @@ function fWqZoV(ctx: IContext) {
 const base64Logo = "data:image/webp;base64,UklGRrABAABXRUJQVlA4WAoAAAAQAAAAHwAAHwAAQUxQSKEAAAARN6CmbSM4WR7vdARON11EBDq3fLiNbVtVzpMCPlKAEzsx0Y/x+Ovuv4dn0EFE/ydAvz6YggXzgh5sVgXM/zOC/4sii7qgGvB5N7hmuQYwkvazWAu1JPW41FXSHq6pnaQWvqYH18Fc0j1hO/BFTtIeSBlJi5w6qIIO7IOrwhFsB2Yxukif0FTRLpXswHR8MxbslKe9VZsn/Ub5C7YFOpqSTABWUDgg6AAAAFAGAJ0BKiAAIAA+7VyoTqmkpCI3+qgBMB2JbACdMt69DwMIQBLhkTO6XwY00UEDK6cNIDnuNibPf0EgAP7Y1myuiQHLDsF/0h5unrGh6WAbv7aegg2ZMd3uRKfT/3SJztcaujYfTvMXspfCTmYcoO6a+vhC3ss4M8uM58t4siiu59I4aOl59e9Sr6xoxYlHf2v+NnBNpJYeJf8jABQAId/PXuBkLEFkiCucgSGEcfhvajql/j3reCGl0M5/9gQWy7ayNPs+wlvIxFnNfSlfuND4CZOCyxOHhRqOmHN4ULHo3tCSrUNvgAA=";
 
 let lastLogTime = 0;
-async function Yjj(_logo?: string) {
+async function $vKd(_logo?: string) {
     const now = Date.now();
     if (now - lastLogTime < 2000) return;
     lastLogTime = now;
@@ -982,7 +999,7 @@ async function Yjj(_logo?: string) {
 }
 
 
-async function __jDHSHz(context: IContext) {
+async function _YuMDhu(context: IContext) {
     // isAllowed() now also covers cross-origin-isolated pages (where beacons can't be sent)
     // and Do Not Track / GPC.
     if (!Telemetry.isAllowed(context)) {
@@ -996,7 +1013,7 @@ async function __jDHSHz(context: IContext) {
 
             // current url without query parameters
             const currentUrl = window.location.href.split("?")[0];
-            const license = btgRyBvJ;
+            const license = __deG;
 
             const beaconData = {
                 license,

package/src/engine/engine_networking_blob.ts

@@ -1,7 +1,7 @@
 import { FileLoader } from "three";
 
 import { showBalloonWarning } from "./debug/index.js";
-import { _$IqaqwY } from "./engine_license.js";
+import { KLnyx } from "./engine_license.js";
 import { delay } from "./engine_utils.js";
 import { md5AsBytes, md5Hex, sha256Base64 } from "./engine_utils_hash.js";
 
@@ -45,7 +45,7 @@ export namespace BlobStorage {
      */
     export function canUpload(info: { filesize: number }) {
         const sizeInMB = info.filesize / 1024 / 1024;
-        if (_$IqaqwY()) {
+        if (KLnyx()) {
             return sizeInMB < maxSizeInMB;
         }
         return sizeInMB < maxFreeSizeInMB;
@@ -100,7 +100,7 @@ export namespace BlobStorage {
             console.warn(`Your file is too large for uploading (${filesizeInMB.toFixed(1)}MB). Max allowed size is ${maxSizeInMB}MB`);
             return null;
         }
-        else if (!_$IqaqwY() && filesizeInMB > maxFreeSizeInMB) {
+        else if (!KLnyx() && filesizeInMB > maxFreeSizeInMB) {
             if (opts?.silent !== true) showBalloonWarning(`File is too large for uploading. Please get a <a href=\"https://needle.tools/pricing\" target=\"_blank\">commercial license</a> to upload files larger than 5MB`);
             console.warn(`Your file is too large for uploading (${filesizeInMB.toFixed(1)}MB). Max size is 5MB for non-commercial users. Please get a commercial license at https://needle.tools/pricing for larger files (up to 50MB)`);
             return null;

package/src/engine/engine_utils_qrcode.ts

@@ -4,7 +4,7 @@ import { Quaternion, Vector2, Vector3, Vector4 } from "three";
 
 import { needleLogoOnlySVG } from "./assets/index.js";
 import { isDevEnvironment } from "./debug/debug.js";
-import { _$IqaqwY } from "./engine_license.js";
+import { KLnyx } from "./engine_license.js";
 import { InternalAttributeUtils } from "./engine_utils_attributes.js";
 import type { NeedleEngineWebComponent } from "./webcomponents/needle-engine.js";
 
@@ -135,7 +135,7 @@ async function internalRenderQRCodeOverlays(canvas: HTMLCanvasElement, args: { s
         console.debug("[QR Code] No web component found")
     }
 
-    const canUseCustomLogo = _$IqaqwY();
+    const canUseCustomLogo = KLnyx();
 
     // Query logo src from needle-engine attribute.
     // For any supported attribute it's possible to use "falsey" values (e.g. "0" or "false" to disable the logo in the QR code)

package/src/engine/webcomponents/needle menu/needle-menu-spatial.ts

@@ -2,7 +2,7 @@ import { Mesh, Object3D, TextureLoader, Vector4 } from "three";
 import ThreeMeshUI from "three-mesh-ui";
 
 import { addNewComponent } from "../../engine_components.js";
-import { _$IqaqwY } from "../../engine_license.js";
+import { KLnyx } from "../../engine_license.js";
 import { OneEuroFilterXYZ } from "../../engine_math.js";
 import type { Context } from "../../engine_setup.js";
 import { lookAtObject } from "../../engine_three_utils.js";
@@ -321,7 +321,7 @@ export class NeedleSpatialMenu {
         }
         if (this.menu) {
             const index = this.menu.children.indexOf(this._poweredByNeedleElement as any);
-            if (!this._showNeedleLogo && _$IqaqwY()) {
+            if (!this._showNeedleLogo && KLnyx()) {
                 if (index >= 0) {
                     this._poweredByNeedleElement.removeFromParent();
                     this.markDirty();

package/src/engine/webcomponents/needle menu/needle-menu.ts

@@ -1,6 +1,6 @@
 import { showBalloonMessage } from "../../debug/debug.js";
 import type { Context } from "../../engine_context.js";
-import { _$IqaqwY, __YPGv, Telemetry } from "../../engine_license.js";
+import { KLnyx, _$jODX, Telemetry } from "../../engine_license.js";
 import { isLocalNetwork } from "../../engine_networking_utils.js";
 import { HTMLElementBase } from "../../engine_ssr.js";
 import { DeviceUtilities, getParam } from "../../engine_utils.js";
@@ -801,8 +801,8 @@ export class NeedleMenuElement extends HTMLElementBase {
             // calling this method immediately will cause an issue with vite bundling tho
             this._licenseFrame = window.requestAnimationFrame(() => {
                 this._licenseFrame = undefined;
-                this._unsubscribeLicense = __YPGv(res => {
-                    if (res == true && _$IqaqwY() && !debugNonCommercial) {
+                this._unsubscribeLicense = _$jODX(res => {
+                    if (res == true && KLnyx() && !debugNonCommercial) {
                         let visible = this._userRequestedLogoVisible;
                         if (visible === undefined) visible = false;
                         this.___onSetLogoVisible(visible);
@@ -854,7 +854,7 @@ export class NeedleMenuElement extends HTMLElementBase {
                 // ensure the menu is not hidden or removed
                 const requiredParent = this?.parentNode;
                 if (this.style.display != "flex" || this.style.visibility != "visible" || this.style.opacity != "1" || requiredParent != this._domElement?.shadowRoot) {
-                    if (!_$IqaqwY()) {
+                    if (!KLnyx()) {
                         const change = changeEventCounter++;
                         // if a user doesn't have a local pro license *but* for development the menu is hidden then we show a warning
                         if (isLocalNetwork() && this._userRequestedMenuVisible === false) {
@@ -950,7 +950,7 @@ export class NeedleMenuElement extends HTMLElementBase {
     showNeedleLogo(visible: boolean) {
         this._userRequestedLogoVisible = visible;
         if (!visible) {
-            if (!_$IqaqwY() || debugNonCommercial) {
+            if (!KLnyx() || debugNonCommercial) {
                 console.warn("[Needle Engine] You need a commercial license to hide the Needle Engine logo in production.");
                 const localNetwork = isLocalNetwork()
                 if (!localNetwork) return;

package/src/engine/webcomponents/needle-engine.loading.ts

@@ -1,6 +1,6 @@
 import { needleLogoOnlySVG } from "../assets/index.js"
 import { showBalloonWarning } from "../debug/index.js";
-import { $vnStLM } from "../engine_license.js";
+import { $jVksoCHS } from "../engine_license.js";
 import { Mathf } from "../engine_math.js";
 import { LoadingProgressArgs } from "../engine_setup.js";
 import { getParam } from "../engine_utils.js";
@@ -402,7 +402,7 @@ export class EngineLoadingView implements ILoadingViewHandler {
         const logoToggle = InternalAttributeUtils.getAttributeAndCheckFalsey(this._element, "loading-logo");
         const showLogo = logoToggle !== null && logoToggle !== false;
 
-        const hasLicense = $vnStLM();
+        const hasLicense = $jVksoCHS();
 
         const className = this._loadingElementOptions?.className ?? EngineLoadingView.LoadingContainerClassName;
         el.classList.add(className);

package/src/engine/webcomponents/needle-engine.ts

@@ -3,7 +3,7 @@ import type { Texture } from "three";
 import { isDevEnvironment, showBalloonWarning } from "../debug/index.js";
 import { PUBLIC_KEY, VERSION } from "../engine_constants.js";
 import { ContextEvent, ContextRegistry } from "../engine_context_registry.js";
-import { _$IqaqwY, Telemetry } from "../engine_license.js";
+import { KLnyx, Telemetry } from "../engine_license.js";
 import { onStart } from "../engine_lifecycle_api.js";
 import { setDracoDecoderPath, setDracoDecoderType, setKtx2TranscoderPath } from "../engine_loaders.gltf.js";
 import { Context, ContextCreateArgs } from "../engine_setup.js";
@@ -617,7 +617,7 @@ export class NeedleEngineWebComponent extends HTMLElementBase implements INeedle
 
 
         // Loading start events
-        const allowOverridingDefaultLoading = _$IqaqwY();
+        const allowOverridingDefaultLoading = KLnyx();
         // default loading can be overriden by calling preventDefault in the onload start event
         this.ensureLoadStartIsRegistered();
         let useDefaultLoading = this.dispatchEvent(new CustomEvent("loadstart", {

package/src/engine/xr/TempXRContext.ts

@@ -3,7 +3,7 @@ import { ArrayCamera, AxesHelper, Camera, Color, DirectionalLight, Fog, GridHelp
 import { needleLogoOnlySVG } from "../assets/index.js";
 import { isDevEnvironment } from "../debug/index.js";
 import { ObjectUtils, PrimitiveType } from "../engine_create_objects.js";
-import { _$IqaqwY } from "../engine_license.js";
+import { KLnyx } from "../engine_license.js";
 import { Mathf } from "../engine_math.js";
 import { delay, DeviceUtilities } from "../engine_utils.js";
 
@@ -215,7 +215,7 @@ export class TemporaryXRContext {
         this._scene.background = new Color(0x000000);
 
         let logoSrc = needleLogoOnlySVG;
-        if (_$IqaqwY()) {
+        if (KLnyx()) {
             const htmlComponent = document.querySelector("needle-engine");
             if (htmlComponent) {
                 const licenseLogo = htmlComponent.getAttribute("logo-src");

package/src/engine-components/Renderer.ts

@@ -1,5 +1,5 @@
 import { getRaycastMesh } from "@needle-tools/gltf-progressive";
-import { AxesHelper, Material, Mesh, MeshBasicMaterial, MeshPhysicalMaterial, MeshStandardMaterial, Object3D, RawShaderMaterial, ShaderMaterial, SkinnedMesh, Texture, Vector4 } from "three";
+import { AxesHelper, Material, Mesh, MeshPhysicalMaterial, MeshStandardMaterial, Object3D, RawShaderMaterial, ShaderMaterial, SkinnedMesh, Texture, Vector4 } from "three";
 
 import { showBalloonWarning } from "../engine/debug/index.js";
 import { getComponent, getOrAddComponent } from "../engine/engine_components.js";
@@ -305,21 +305,12 @@ export class Renderer extends Behaviour implements IRenderer {
     // private _materialProperties: Array<MaterialProperties> | undefined = undefined;
     private _lightmaps?: RendererLightmap[];
 
-    /** Get the mesh Object3D for this renderer  
-     * Warn: if this is a multimaterial object it will return the first mesh only 
+    /** Get the mesh Object3D for this renderer
+     * Warn: if this is a multimaterial object it will return the first submesh only (same as `sharedMeshes[0]`), use {@link sharedMeshes} to get all of them
      * @returns a mesh object3D.
      * */
     get sharedMesh(): Mesh | SkinnedMesh | undefined {
-        if (this.gameObject.type === "Mesh") {
-            return this.gameObject as unknown as Mesh
-        }
-        else if (this.gameObject.type === "SkinnesMesh") {
-            return this.gameObject as unknown as SkinnedMesh;
-        }
-        else if (this.gameObject.type === "Group") {
-            return this.gameObject.children[0] as unknown as Mesh;
-        }
-        return undefined;
+        return this.sharedMeshes[0];
     }
 
     private readonly _sharedMeshes: Mesh[] = [];