@needle-tools/engine 5.1.8 → 5.1.9

package/lib/engine-components/webxr/WebXRImageTracking.utils.js

@@ -0,0 +1,96 @@
+import { isDevEnvironment } from "../../engine/debug/index.js";
+import { getParam } from "../../engine/engine_utils.js";
+// Kept in a dedicated module (with only lightweight imports) so the marker-loading logic can be unit
+// tested without pulling in the heavy WebXRImageTracking / USDZ exporter import graph.
+const debug = getParam("debugimagetracking");
+/**
+ * Cache of decoded marker bitmaps, keyed by image url.
+ * Also read by the USDZ exporter (see {@link WebXRImageTracking}) to embed the marker into the .usdz.
+ */
+export const _imageElements = new Map();
+const _imageLoadingPromises = new Map();
+/**
+ * Resolve marker bitmaps for the given tracked-image models and append them to `args.trackedImages`
+ * (the list handed to `navigator.xr.requestSession`).
+ *
+ * Every valid marker is awaited so that images which are still decoding when the XR session is
+ * requested get included instead of being silently dropped (which previously caused markers to only
+ * work after re-entering AR). Loading happens in parallel and never rejects: a marker that can not be
+ * loaded is skipped individually so a single unavailable image can not fail the whole session request.
+ *
+ * @param models The configured tracked-image models
+ * @param args The session init object; `trackedImages` is created if missing and appended to
+ * @param load Injectable loader (defaults to {@link loadImage}); resolves the decoded bitmap or null
+ * @returns Map of `trackedImages` index -> model for the appended images (used to resolve results)
+ */
+export async function collectTrackedImages(models, args, load = loadImage) {
+    const indexMap = new Map();
+    if (!args.trackedImages)
+        args.trackedImages = [];
+    if (!models)
+        return indexMap;
+    const valid = models.filter(m => !!m.image?.length && m.widthInMeters > 0);
+    // Load in parallel and wait for all of them. Guard every load with a catch so that a rejecting
+    // loader is treated as "unavailable" (null) rather than aborting the whole session request.
+    const bitmaps = await Promise.all(valid.map(m => load(m.image).catch(() => null)));
+    for (let i = 0; i < valid.length; i++) {
+        const model = valid[i];
+        const bitmap = bitmaps[i];
+        if (bitmap) {
+            indexMap.set(args.trackedImages.length, model);
+            args.trackedImages.push({ image: bitmap, widthInMeters: model.widthInMeters });
+        }
+        else if (isDevEnvironment() || debug) {
+            console.warn(`[WebXRImageTracking] Marker image could not be loaded, skipping: ${model.image}`);
+        }
+    }
+    return indexMap;
+}
+/**
+ * Load and decode a marker image into an {@link ImageBitmap}, caching it in {@link _imageElements}.
+ * Idempotent: concurrent or repeated calls for the same URL share a single in-flight load.
+ *
+ * Resolves to `null` and never rejects when the image can not be fetched or decoded, so callers can
+ * skip an unavailable marker without failing the surrounding XR session request. A failed load clears
+ * its cache entry so a later attempt (e.g. re-entering AR) can retry.
+ */
+export async function loadImage(url) {
+    const cached = _imageElements.get(url);
+    if (cached)
+        return cached;
+    const pending = _imageLoadingPromises.get(url);
+    if (pending)
+        return pending;
+    const promise = new Promise(res => {
+        _imageElements.set(url, null); // placeholder to dedupe concurrent loads
+        if (isDevEnvironment() || debug)
+            console.debug(`[WebXRImageTracking] Start loading image for tracking: ${url}`);
+        const imageElement = document.createElement("img");
+        imageElement.addEventListener("load", async () => {
+            try {
+                const img = await createImageBitmap(imageElement);
+                _imageElements.set(url, img);
+                if (isDevEnvironment() || debug)
+                    console.debug(`[WebXRImageTracking] Loaded image for tracking: ${url}`);
+                res(img);
+            }
+            catch (err) {
+                console.error(`[WebXRImageTracking] Failed to decode marker image for tracking: ${url}`, err);
+                _imageElements.delete(url); // allow a retry later (e.g. re-entering AR)
+                res(null);
+            }
+        });
+        imageElement.addEventListener("error", (evt) => {
+            console.error(`[WebXRImageTracking] Failed to load marker image for tracking: ${url}`, evt);
+            _imageElements.delete(url); // allow a retry later (e.g. re-entering AR)
+            res(null);
+        });
+        imageElement.src = url;
+    });
+    _imageLoadingPromises.set(url, promise);
+    promise.finally(() => {
+        _imageLoadingPromises.delete(url);
+    });
+    return promise;
+}
+//# sourceMappingURL=WebXRImageTracking.utils.js.map

package/lib/engine-components/webxr/WebXRImageTracking.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebXRImageTracking.utils.js","sourceRoot":"","sources":["../../../src/engine-components/webxr/WebXRImageTracking.utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/engine",
-  "version": "5.1.8",
+  "version": "5.1.9",
   "description": "Needle Engine is a web-based runtime for 3D apps. It runs on your machine for development with great integrations into editors like Unity or Blender - and can be deployed onto any device! It is flexible, extensible and networking and XR are built-in.",
   "main": "dist/needle-engine.min.js",
   "exports": {

package/plugins/common/license.js

@@ -127,7 +127,7 @@ async function requestNeedleCloud(path, options) {
  * @param {DefaultOptions & {accessToken?:string, team:string|undefined}} opts
  */
 export async function replaceLicense(code, opts) {
-    const index = code?.indexOf("DCMbeC");
+    const index = code?.indexOf("_xUlE");
     if (index >= 0) {
         const licenseResult = await resolveLicense(opts);
         if (!licenseResult) {
@@ -136,18 +136,18 @@ export async function replaceLicense(code, opts) {
         const end = code.indexOf(";", index);
         if (end >= 0) {
             const line = code.substring(index, end);
-            const replaced = "DCMbeC = \"" + licenseResult.type + "\"";
+            const replaced = "_xUlE = \"" + licenseResult.type + "\"";
             code = code.replace(line, replaced);
         }
 
         // Also inject JWT if available
         if (licenseResult.jwt) {
-            const jwtIndex = code.indexOf("_$QDa");
+            const jwtIndex = code.indexOf("$YQu");
             if (jwtIndex >= 0) {
                 const jwtEnd = code.indexOf(";", jwtIndex);
                 if (jwtEnd >= 0) {
                     const jwtLine = code.substring(jwtIndex, jwtEnd);
-                    const jwtReplaced = "_$QDa = \"" + licenseResult.jwt + "\"";
+                    const jwtReplaced = "$YQu = \"" + licenseResult.jwt + "\"";
                     code = code.replace(jwtLine, jwtReplaced);
                 }
             }

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("DCMbeC");
+                const index = src.indexOf("_xUlE");
                 if (index >= 0) {
                     const end = src.indexOf(";", index);
                     if (end >= 0) {
                         const line = src.substring(index, end);
-                        const replaced = "DCMbeC = \"" + licenseResult.type + "\"";
+                        const replaced = "_xUlE = \"" + 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("_$QDa");
+                    const jwtIndex = src.indexOf("$YQu");
                     if (jwtIndex >= 0) {
                         const jwtEnd = src.indexOf(";", jwtIndex);
                         if (jwtEnd >= 0) {
                             const jwtLine = src.substring(jwtIndex, jwtEnd);
-                            const jwtReplaced = "_$QDa = \"" + licenseResult.jwt + "\"";
+                            const jwtReplaced = "$YQu = \"" + licenseResult.jwt + "\"";
                             src = src.replace(jwtLine, jwtReplaced);
                             modified = true;
                         }

package/src/engine/api.ts

@@ -230,7 +230,7 @@ export * from "./engine_input.js";
 export { InstancingUtil } from "./engine_instancing.js";
 
 /** License checking utilities */
-export { __sKHtRdk, _VIq, LuMYUbW } from "./engine_license.js";
+export { _$qxlHFE, $iNNlsg, _iXmRJVD } 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 { __jwMeHQW } from "./engine_license.js";
+import { _$FgmvbDMW } 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();
-    __jwMeHQW();
+    _$FgmvbDMW();
 
     // Must be last. customElements.define() upgrades existing <needle-engine>
     // elements synchronously, which can trigger context.create() and dispatch

package/src/engine/engine_license.ts

@@ -9,19 +9,19 @@ import { DeviceUtilities, getParam } from "./engine_utils.js";
 
 const debug = getParam("__debuglic__");
 
-const _vyy: ((result: boolean) => void)[] = [];
+const _$JpwdW: ((result: boolean) => void)[] = [];
 
 // DO NOT EDIT MANUALLY
-let DCMbeC: string = "";
+let _xUlE: string = "";
 // eslint-disable-next-line prefer-const
-let _$QDa: string = "";
+let $YQu: string = "";
 
 if (debug) {
-    console.log("License Type: " + DCMbeC);
-    if (_$QDa) {
-        console.log("License JWT: " + _$QDa);
+    console.log("License Type: " + _xUlE);
+    if ($YQu) {
+        console.log("License JWT: " + $YQu);
         try {
-            const payload = JSON.parse(atob(_$QDa.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
+            const payload = JSON.parse(atob($YQu.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
             console.log("License JWT payload:", payload);
         }
         catch { console.log("License JWT payload: (failed to decode)"); }
@@ -32,8 +32,8 @@ if (debug) {
 }
 
 /** @internal */
-export function LuMYUbW() {
-    switch (DCMbeC) {
+export function _iXmRJVD() {
+    switch (_xUlE) {
         case "pro":
         case "enterprise":
             return true;
@@ -42,8 +42,8 @@ export function LuMYUbW() {
 }
 
 /** @internal */
-export function _VIq() {
-    switch (DCMbeC) {
+export function $iNNlsg() {
+    switch (_xUlE) {
         case "indie":
             return true;
     }
@@ -51,8 +51,8 @@ export function _VIq() {
 }
 
 /** @internal */
-export function _qGnTHBt() {
-    switch (DCMbeC) {
+export function BWKK() {
+    switch (_xUlE) {
         case "edu":
             return true;
     }
@@ -60,20 +60,20 @@ export function _qGnTHBt() {
 }
 
 /** @internal */
-export function __sKHtRdk() {
-    return LuMYUbW() || _VIq() || _qGnTHBt();
+export function _$qxlHFE() {
+    return _iXmRJVD() || $iNNlsg() || BWKK();
 }
 
 
 /** @internal */
-export function __YcMNHT(cb: (result: boolean) => void) {
-    if (LuMYUbW() || _VIq() || _qGnTHBt())
+export function $LDKVfeT(cb: (result: boolean) => void) {
+    if (_iXmRJVD() || $iNNlsg() || BWKK())
         return cb(true);
-    _vyy.push(cb);
+    _$JpwdW.push(cb);
 }
 
-function __GhIoUnR(result: boolean) {
-    for (const cb of _vyy) {
+function _$UmxBO(result: boolean) {
+    for (const cb of _$JpwdW) {
         try {
             cb(result);
         }
@@ -88,7 +88,7 @@ function __GhIoUnR(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 _ZlcqTFZ = {
+const _$jgGCcE = {
     kty: "EC",
     crv: "P-256",
     x: "A34nyKMjhQYVgzeE4tyLUYdx34TAKogDa7v7PRaO9Lg",
@@ -112,7 +112,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 $XibkUuV(jwt: string): Promise<string | null> {
+async function _$jlNUf(jwt: string): Promise<string | null> {
     if (!jwt) return null;
     try {
         const parts = jwt.split(".");
@@ -122,7 +122,7 @@ async function $XibkUuV(jwt: string): Promise<string | null> {
 
         const key = await crypto.subtle.importKey(
             "jwk",
-            _ZlcqTFZ,
+            _$jgGCcE,
             { name: "ECDSA", namedCurve: "P-256" },
             false,
             ["verify"]
@@ -182,24 +182,24 @@ async function $XibkUuV(jwt: string): Promise<string | null> {
 }
 
 /** Verify the injected JWT and update the license type if valid.
- * The engine ONLY trusts the JWT — the plain DCMbeC string is ignored. */
+ * The engine ONLY trusts the JWT — the plain _xUlE string is ignored. */
 let _jwtVerificationPromise: Promise<void> | undefined = undefined;
-async function _eHTHvyky(): Promise<void> {
-    // NOTE: do NOT add an `if (!_$QDa) return` guard here.
+async function $yoiJPs(): Promise<void> {
+    // NOTE: do NOT add an `if (!$YQu) 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 = _$QDa;
+    const jwt = $YQu;
     // Clear after reading — this reassignment also prevents esbuild from
     // constant-folding the variable (it now has multiple assignment sites).
-    _$QDa = "";
-    const verifiedType = await $XibkUuV(jwt);
+    $YQu = "";
+    const verifiedType = await _$jlNUf(jwt);
     if (verifiedType) {
-        DCMbeC = verifiedType;
+        _xUlE = verifiedType;
         if (debug) console.log("License type set from verified JWT: " + verifiedType);
-        __GhIoUnR(__sKHtRdk());
+        _$UmxBO(_$qxlHFE());
     }
     else {
-        DCMbeC = "basic";
+        _xUlE = "basic";
         if (debug && jwt) console.warn("JWT verification failed — license reset to basic");
     }
 }
@@ -650,18 +650,18 @@ export namespace Telemetry {
 }
 
 
-export function __jwMeHQW() {
+export function _$FgmvbDMW() {
 
-    if(DCMbeC === "") DCMbeC = "basic";
+    if(_xUlE === "") _xUlE = "basic";
 
     // Start JWT verification — must be here (not top-level) to avoid tree-shaking
-    _jwtVerificationPromise = _eHTHvyky();
+    _jwtVerificationPromise = $yoiJPs();
 
     Telemetry.init();
     ContextRegistry.registerCallback(ContextEvent.ContextRegistered, evt => {
-        __dwrTPO(evt.context);
-        RENdB(evt.context);
-        setTimeout(() => _$lKMhQuj(evt.context), 2000);
+        _$XHf(evt.context);
+        $HVsWDxs(evt.context);
+        setTimeout(() => qRfAszSq(evt.context), 2000);
     });
     // ContextCreated fires after the renderer exists, so the canvas is available for context-loss monitoring
     ContextRegistry.registerCallback(ContextEvent.ContextCreated, evt => {
@@ -670,17 +670,17 @@ export function __jwMeHQW() {
     });
 }
 
-export let __pRlh: Promise<void> | undefined = undefined;
+export let _$vVym: Promise<void> | undefined = undefined;
 let applicationIsForbidden = false;
 let applicationForbiddenText = "";
-async function __DmsXa() {
+async function $lSDygug() {
     // Only perform the runtime license check once
-    if (__pRlh) return __pRlh;
+    if (_$vVym) return _$vVym;
     // Wait for JWT verification to complete first (if running)
     if (_jwtVerificationPromise) {
         await _jwtVerificationPromise;
     }
-    if (DCMbeC === "basic") {
+    if (_xUlE === "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, {
@@ -692,29 +692,29 @@ async function __DmsXa() {
             if (res?.status === 200) {
                 applicationIsForbidden = false;
                 if (debug) console.log("License check succeeded");
-                DCMbeC = "pro";
-                __GhIoUnR(true);
+                _xUlE = "pro";
+                _$UmxBO(true);
             }
             else if (res?.status === 403) {
-                __GhIoUnR(false);
+                _$UmxBO(false);
                 applicationIsForbidden = true;
                 applicationForbiddenText = await res.text();
             }
             else {
-                __GhIoUnR(false);
+                _$UmxBO(false);
                 if (debug) console.log("License check failed with status " + res?.status);
             }
         }
         catch (err) {
-            __GhIoUnR(false);
+            _$UmxBO(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 \"" + DCMbeC + "\"");
+    else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + _xUlE + "\"");
 }
-__pRlh = __DmsXa();
+_$vVym = $lSDygug();
 
-async function RENdB(ctx: IContext) {
+async function $HVsWDxs(ctx: IContext) {
     function createForbiddenElement() {
         const div = document.createElement("div");
         div.className = "needle-forbidden";
@@ -779,40 +779,40 @@ async function RENdB(ctx: IContext) {
     }, 500)
 }
 
-async function __dwrTPO(ctx: IContext) {
+async function _$XHf(ctx: IContext) {
     try {
-        if (!LuMYUbW() && !_VIq()) {
-            return _BDcq(ctx);
+        if (!_iXmRJVD() && !$iNNlsg()) {
+            return $MfDiSn(ctx);
         }
     }
     catch (err) {
         if (debug) console.log("License check failed", err)
-        return _BDcq(ctx)
+        return $MfDiSn(ctx)
     }
-    if (debug) _BDcq(ctx)
+    if (debug) $MfDiSn(ctx)
 }
 
 
 
-async function _BDcq(ctx: IContext) {
+async function $MfDiSn(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 __pRlh?.catch(() => { });
+    await _$vVym?.catch(() => { });
 
 
-    if (LuMYUbW() || _VIq()) return;
-    if (__sKHtRdk() === false) _oFDigtof();
+    if (_iXmRJVD() || $iNNlsg()) return;
+    if (_$qxlHFE() === false) __qjjvQNJb();
 
     // check if the engine is already ready (meaning has finished loading)
     if (isReady) {
-        DWOdshYS(ctx);
+        $RnnJzy(ctx);
     }
     else {
         ctx.domElement.addEventListener("ready", () => {
-            DWOdshYS(ctx);
+            $RnnJzy(ctx);
         });
     }
 }
@@ -820,7 +820,7 @@ async function _BDcq(ctx: IContext) {
 // const licenseElementIdentifier = "needle-license-element";
 // const licenseDuration = 10000;
 // const licenseDelay = 1200;
-function DWOdshYS(ctx: IContext) {
+function $RnnJzy(ctx: IContext) {
 
     const style = `
         position: relative;
@@ -833,7 +833,7 @@ function DWOdshYS(ctx: IContext) {
         padding: 10px;
         padding-left: 30px;
     `;
-    if (DCMbeC === "edu") {
+    if (_xUlE === "edu") {
         if (navigator.webdriver) {
             console.log("This project is supported by Needle for Education – https://needle.tools");
         }
@@ -890,7 +890,7 @@ function DWOdshYS(ctx: IContext) {
         }
     }, 1000);
 
-    if (_qGnTHBt()) {
+    if (BWKK()) {
         const removeDelay = 20_000;
         setTimeout(() => {
             clearInterval(interval);
@@ -899,7 +899,7 @@ function DWOdshYS(ctx: IContext) {
             const intervalInMinutes = 5;
             setTimeout(() => {
                 if (ctx.domElement.parentNode)
-                    DWOdshYS(ctx);
+                    $RnnJzy(ctx);
             }, 1000 * 60 * intervalInMinutes)
         }, removeDelay);
     }
@@ -910,7 +910,7 @@ function DWOdshYS(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 _oFDigtof(_logo?: string) {
+async function __qjjvQNJb(_logo?: string) {
     const now = Date.now();
     if (now - lastLogTime < 2000) return;
     lastLogTime = now;
@@ -943,7 +943,7 @@ async function _oFDigtof(_logo?: string) {
 }
 
 
-async function _$lKMhQuj(context: IContext) {
+async function qRfAszSq(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)) {
@@ -957,7 +957,7 @@ async function _$lKMhQuj(context: IContext) {
 
             // current url without query parameters
             const currentUrl = window.location.href.split("?")[0];
-            const license = DCMbeC;
+            const license = _xUlE;
 
             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 { __sKHtRdk } from "./engine_license.js";
+import { _$qxlHFE } 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 (__sKHtRdk()) {
+        if (_$qxlHFE()) {
             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 (!__sKHtRdk() && filesizeInMB > maxFreeSizeInMB) {
+        else if (!_$qxlHFE() && 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 { __sKHtRdk } from "./engine_license.js";
+import { _$qxlHFE } 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 = __sKHtRdk();
+    const canUseCustomLogo = _$qxlHFE();
 
     // 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 { __sKHtRdk } from "../../engine_license.js";
+import { _$qxlHFE } 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 && __sKHtRdk()) {
+            if (!this._showNeedleLogo && _$qxlHFE()) {
                 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 { __sKHtRdk, __YcMNHT, Telemetry } from "../../engine_license.js";
+import { _$qxlHFE, $LDKVfeT, 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";
@@ -784,8 +784,8 @@ export class NeedleMenuElement extends HTMLElementBase {
         try {
             // if the user has a license then we CAN hide the needle logo
             // calling this method immediately will cause an issue with vite bundling tho
-            window.requestAnimationFrame(() => __YcMNHT(res => {
-                if (res == true && __sKHtRdk() && !debugNonCommercial) {
+            window.requestAnimationFrame(() => $LDKVfeT(res => {
+                if (res == true && _$qxlHFE() && !debugNonCommercial) {
                     let visible = this._userRequestedLogoVisible;
                     if (visible === undefined) visible = false;
                     this.___onSetLogoVisible(visible);
@@ -836,7 +836,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 (!__sKHtRdk()) {
+                    if (!_$qxlHFE()) {
                         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) {
@@ -932,7 +932,7 @@ export class NeedleMenuElement extends HTMLElementBase {
     showNeedleLogo(visible: boolean) {
         this._userRequestedLogoVisible = visible;
         if (!visible) {
-            if (!__sKHtRdk() || debugNonCommercial) {
+            if (!_$qxlHFE() || debugNonCommercial) {
                 console.warn("[Needle Engine] You need a commercial license to hide the Needle Engine logo in production.");
                 const localNetwork = isLocalNetwork()
                 if (!localNetwork) return;