@needle-tools/engine 5.1.0 → 5.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/engine",
-  "version": "5.1.0",
+  "version": "5.1.2",
   "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": {
@@ -99,7 +99,7 @@
   ],
   "dependencies": {
     "@dimforge/rapier3d-compat": "0.19.3",
-    "@needle-tools/gltf-progressive": "3.6.0-beta.1",
+    "@needle-tools/gltf-progressive": "3.6.0-beta.2",
     "@needle-tools/materialx": "1.7.0-next.0d06218",
     "@needle-tools/three-animation-pointer": "1.1.2",
     "@webxr-input-profiles/motion-controllers": "1.0.0",

package/plugins/common/license.js

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

package/plugins/types/userconfig.d.ts

@@ -76,9 +76,10 @@ export type userSettings = {
         /** Enable for verbose log output */
         verbose?: boolean,
 
-        /** Set to a specific version of the Needle Build Pipeline.
-         * @default "latest"
-         * @example "2.2.0-alpha"
+        /** Set to a specific version of the Needle Build Pipeline used for local compression.
+         * Must be 3.x or newer (earlier versions don't support the required license auth).
+         * @default "3"
+         * @example "3.0.0"
         */
         version?: string;
 

package/plugins/vite/build-pipeline.d.ts

@@ -11,11 +11,13 @@
  *   (cloud was the implied intent and can't run without a token).
  *
  * @param {import('../types').userSettings | undefined | null} opts
- * @param {{ isCI?: boolean }} [env]
+ * @param {{ isCI?: boolean, cloudToken?: string }} [env] `cloudToken` is the NEEDLE_CLOUD_TOKEN
+ *   env var fallback, used when `buildPipeline.accessToken` isn't set in the vite config.
  * @returns {"cloud" | "local" | "skip-no-token"}
  */
 export function resolveCompressionTarget(opts: import("../types").userSettings | undefined | null, env?: {
     isCI?: boolean;
+    cloudToken?: string;
 }): "cloud" | "local" | "skip-no-token";
 /**
  * This function can be used by other plugins to wait for the build pipeline to finish before doing some work in the closeBundle hook.

package/plugins/vite/build-pipeline.js

@@ -53,12 +53,19 @@ env:
  *   (cloud was the implied intent and can't run without a token).
  *
  * @param {import('../types').userSettings | undefined | null} opts
- * @param {{ isCI?: boolean }} [env]
+ * @param {{ isCI?: boolean, cloudToken?: string }} [env] `cloudToken` is the NEEDLE_CLOUD_TOKEN
+ *   env var fallback, used when `buildPipeline.accessToken` isn't set in the vite config.
  * @returns {"cloud" | "local" | "skip-no-token"}
  */
 export function resolveCompressionTarget(opts, env = {}) {
     const isCI = env.isCI ?? false;
-    const token = opts?.buildPipeline?.accessToken;
+    // A Needle Cloud access token can be configured two ways: buildPipeline.accessToken in the
+    // vite config, or the NEEDLE_CLOUD_TOKEN env var (the same var the license plugin reads —
+    // see common/license.js). buildPipeline.accessToken is not populated from the env var
+    // anywhere, so without this fallback an env-only token is invisible to the decision below:
+    // outside CI the build then selects local compression (no warning explaining why), and in
+    // CI it returns "skip-no-token".
+    const token = opts?.buildPipeline?.accessToken || env.cloudToken;
     const hasToken = typeof token === "string" && token.length > 0;
     const wantsLocal = opts?.buildPipeline?.compression === "local";
 
@@ -394,10 +401,11 @@ async function invokeBuildPipeline(opts, options = {}) {
 
     // Cloud token used by `${NEEDLE_CLOUD_CLI_NAME} optimize --token <token>`.
     // This is a Needle Cloud access token (created in the Needle Cloud UI), NOT a JWT.
-    const cloudAccessToken = opts.buildPipeline?.accessToken;
+    // Falls back to NEEDLE_CLOUD_TOKEN (same source the license plugin uses) when not set in the config.
+    const cloudAccessToken = opts.buildPipeline?.accessToken || process.env.NEEDLE_CLOUD_TOKEN;
 
     // Decide cloud vs local (see resolveCompressionTarget for the rules).
-    const compressionTarget = resolveCompressionTarget(opts, { isCI: !!process.env.CI });
+    const compressionTarget = resolveCompressionTarget(opts, { isCI: !!process.env.CI, cloudToken: process.env.NEEDLE_CLOUD_TOKEN });
     if (compressionTarget === "skip-no-token") {
         warn(`No cloud access token found. Set process.env.NEEDLE_CLOUD_TOKEN, or set buildPipeline.compression: "local" to compress on the build machine.`);
         return false;
@@ -475,8 +483,9 @@ async function invokeBuildPipeline(opts, options = {}) {
                 }
             }
         }
-        // Otherwise we default to the stable version on npm
-        if (!version) version = "stable";
+        // Otherwise default to the latest 3.x release on npm. 3.x is required for the
+        // `--auth-token` JWT auth used below; the older `stable` dist-tag predates that option.
+        if (!version) version = "3";
 
         resolvedPipelineVersion = version;
         const versionInfo = versionSource ? `'${version}' (${versionSource})` : `'${version}'`;
@@ -652,9 +661,10 @@ async function invokeBuildPipeline(opts, options = {}) {
                     const pinned = resolvedPipelineVersion ? `@${resolvedPipelineVersion}` : "";
                     needleLog("needle-buildpipeline",
                         `The compression tool reported an unknown option, which means an older/incompatible ` +
-                        `@needle-tools/gltf-build-pipeline ran instead of the pinned version ${pinned}. ` +
-                        `This is usually a stale local install shadowing it — check "npm ls @needle-tools/gltf-build-pipeline" ` +
-                        `in your web project and remove the old copy, or ensure the pinned version is reachable from your npm registry.`,
+                        `@needle-tools/gltf-build-pipeline${pinned ? ` (${pinned})` : ""} ran. Likely causes: the pinned ` +
+                        `version/tag itself predates this option (it must be 3.x or newer — set buildPipeline.version, ` +
+                        `e.g. "3.0.0"), or a stale local install is shadowing it (check "npm ls @needle-tools/gltf-build-pipeline" ` +
+                        `in your web project and remove the old copy, or ensure the pinned version is reachable from your npm registry).`,
                         "warn", { dimBody: false, showHeader: true, leadingNewline: true });
                 }
             }

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("_LquBhwVh");
+                const index = src.indexOf("__UoF");
                 if (index >= 0) {
                     const end = src.indexOf(";", index);
                     if (end >= 0) {
                         const line = src.substring(index, end);
-                        const replaced = "_LquBhwVh = \"" + licenseResult.type + "\"";
+                        const replaced = "__UoF = \"" + 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("BEvs");
+                    const jwtIndex = src.indexOf("_nMW");
                     if (jwtIndex >= 0) {
                         const jwtEnd = src.indexOf(";", jwtIndex);
                         if (jwtEnd >= 0) {
                             const jwtLine = src.substring(jwtIndex, jwtEnd);
-                            const jwtReplaced = "BEvs = \"" + licenseResult.jwt + "\"";
+                            const jwtReplaced = "_nMW = \"" + 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 { $iujBhf, $RHhhju, rXELCf } from "./engine_license.js";
+export { Jkdun, _$apSvAt, _hyjgv } 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 { __tBFssqnm } from "./engine_license.js";
+import { __NjkWq } 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();
-    __tBFssqnm();
+    __NjkWq();
 
     // Must be last. customElements.define() upgrades existing <needle-engine>
     // elements synchronously, which can trigger context.create() and dispatch