@needle-tools/gltf-build-pipeline 2.15.9-next.e981752 → 2.15.9

package/dist/transforms/needle_pmrem.js

@@ -8,6 +8,7 @@ import { v4 as uuid } from 'uuid';
 import { createHash } from 'crypto';
 import tmp from 'tmp';
 import { addToCache, tryGetFromCache } from '../cache/index.js';
+import { testAssert } from '../utils/test-assert.js';
 /** Resolve the tools/pmrem/ directory relative to this file.
  *  At runtime this file is at dist/transforms/needle_pmrem.js,
  *  so tools/pmrem/ is at ../../tools/pmrem/ */
@@ -61,12 +62,14 @@ export class NeedlePmremContext {
         const wasmBinPath = join(this.pmremDir, 'pkg', 'pmrem_wasm_bg.wasm');
         if (!existsSync(wasmJsPath) || !existsSync(wasmBinPath)) {
             this.logger.warn('pmrem: WASM not found — EXR textures will not be processed');
+            testAssert(false, 'pmrem WASM files are missing. Please run `npm run build:pmrem` to build the tools/pmrem/ WASM module.');
             return false;
         }
         // Check basisu binary
         this.basisuExe = resolveBasisuExe(this.pmremDir);
         if (!existsSync(this.basisuExe)) {
             this.logger.warn(`pmrem: basisu binary not found at ${this.basisuExe} — EXR textures will not be processed`);
+            testAssert(false, `basisu executable is missing for platform ${process.platform}. Please run \`npm run build:pmrem\` to build the tools/pmrem/ binaries.`);
             return false;
         }
         // Set executable permission
@@ -85,6 +88,7 @@ export class NeedlePmremContext {
         }
         catch (err) {
             this.logger.warn(`pmrem: Failed to load WASM — ${err.message}`);
+            testAssert(false, `Failed to load pmrem WASM module: ${err.message}`);
             return false;
         }
         // Create temp directory (per-instance to avoid parallel cleanup races)
@@ -109,6 +113,7 @@ export class NeedlePmremContext {
         const contentHash = createHash('md5').update(exrBytes).digest('hex');
         const cacheKey = `pmrem-${contentHash}`;
         // Get KTX2 bytes — deduplicated and optionally cached
+        const wasDeduplicated = this.processingPromises.has(cacheKey);
         const ktx2Bytes = await this.getOrProcessExr(cacheKey, exrBytes, index, name, context.useCache);
         // Remove EXT_texture_exr property since the texture is now KTX2
         const exrProp = texture.getExtension('EXT_texture_exr');
@@ -133,20 +138,25 @@ export class NeedlePmremContext {
             texture.setName(ktx2FileName);
             // Clear image data so gltf-transform doesn't embed it in the GLB
             texture.setImage(null);
-            this.logger.info(`pmrem:texture[${index}] ${name}: external → ${ktx2FileName}`);
+            this.logger.debug(`NEEDLE_pmrem[${index}] ${name}: external → ${ktx2FileName}`);
         }
         else {
             // Bundled: embed the KTX2 in the GLB
             texture.setImage(new Uint8Array(ktx2Bytes));
         }
-        // Report size
-        const sizeStr = image.byteLength < 100 * 1024
-            ? `${(image.byteLength / 1024).toFixed(0)} KB`
-            : `${(image.byteLength / (1024 * 1024)).toFixed(2)} MB`;
-        const dstSizestr = ktx2Bytes.length < 100 * 1024
-            ? `${(ktx2Bytes.length / 1024).toFixed(0)} KB`
-            : `${(ktx2Bytes.length / (1024 * 1024)).toFixed(2)} MB`;
-        this.logger.info(`pmrem:texture[${index}] ${name}: ${sizeStr} EXR → ${dstSizestr} KTX2 (${texture.getURI() || texture.getName() || name})`);
+        // Report size — skip info log for deduplicated textures to avoid confusion
+        if (wasDeduplicated) {
+            this.logger.debug(`NEEDLE_pmrem[${index}] ${name}: reused (identical content) → ${texture.getURI() || texture.getName() || name}`);
+        }
+        else {
+            const sizeStr = image.byteLength < 100 * 1024
+                ? `${(image.byteLength / 1024).toFixed(0)} KB`
+                : `${(image.byteLength / (1024 * 1024)).toFixed(2)} MB`;
+            const dstSizestr = ktx2Bytes.length < 100 * 1024
+                ? `${(ktx2Bytes.length / 1024).toFixed(0)} KB`
+                : `${(ktx2Bytes.length / (1024 * 1024)).toFixed(2)} MB`;
+            this.logger.info(`NEEDLE_pmrem[${index}] ${name}: ${sizeStr} EXR → ${dstSizestr} KTX2 (${texture.getURI() || texture.getName() || name})`);
+        }
         this.convertedTextures.push(texture);
         this.processed++;
         return true;
@@ -156,7 +166,7 @@ export class NeedlePmremContext {
         // In-memory dedup: if we're already processing identical EXR content, reuse the promise
         const existing = this.processingPromises.get(cacheKey);
         if (existing) {
-            this.logger.info(`pmrem:texture[${index}] ${name}: reusing in-flight result (identical content)`);
+            this.logger.debug(`NEEDLE_pmrem[${index}] ${name}: reusing in-flight result (identical content)`);
             return existing;
         }
         const promise = this.processExrToKtx2(cacheKey, exrBytes, index, name, useCache);
@@ -168,7 +178,7 @@ export class NeedlePmremContext {
         if (useCache) {
             const cached = tryGetFromCache(cacheKey);
             if (cached && cached.length > 0) {
-                this.logger.info(`pmrem:texture[${index}] ${name}: loaded from cache`);
+                this.logger.debug(`NEEDLE_pmrem[${index}] ${name}: loaded from cache`);
                 return cached;
             }
         }
@@ -176,24 +186,24 @@ export class NeedlePmremContext {
         const inputSize = exrBytes.byteLength < 100 * 1024
             ? `${(exrBytes.byteLength / 1024).toFixed(0)} KB`
             : `${(exrBytes.byteLength / (1024 * 1024)).toFixed(2)} MB`;
-        this.logger.info(`pmrem:texture[${index}] ${name}: Running PMREM WASM (${inputSize} EXR) — this may take a while...`);
+        this.logger.debug(`NEEDLE_pmrem[${index}] ${name}: Running PMREM WASM (${inputSize} EXR) — this may take a while...`);
         // Yield to allow log to flush before blocking WASM call
         await new Promise(r => setTimeout(r, 0));
         const t0 = Date.now();
         const pmremExrBytes = this.wasmModule.pmrem_exr(exrBytes);
         const elapsed = ((Date.now() - t0) / 1000).toFixed(1);
-        this.logger.info(`pmrem:texture[${index}] ${name}: PMREM done in ${elapsed}s (${(pmremExrBytes.byteLength / 1024 / 1024).toFixed(1)} MB)`);
+        this.logger.debug(`NEEDLE_pmrem[${index}] ${name}: PMREM done in ${elapsed}s (${(pmremExrBytes.byteLength / 1024 / 1024).toFixed(1)} MB)`);
         // 2. Write PMREM EXR to temp file
         const id = uuid();
         const tempExr = join(this.tmpDir, `${id}.pmrem.exr`);
         const tempKtx2 = join(this.tmpDir, `${id}.ktx2`);
         writeFileSync(tempExr, Buffer.from(pmremExrBytes));
         // 3. Encode to KTX2 HDR via basisu
-        this.logger.info(`pmrem:texture[${index}] ${name}: Encoding KTX2 HDR...`);
+        this.logger.debug(`NEEDLE_pmrem[${index}] ${name}: Encoding KTX2 HDR...`);
         const variant = 'hdr4x4'; // 6x6 needs an update in Needle
         await encodeKTX2WithBasisu(this.basisuExe, tempExr, tempKtx2, variant, true);
         if (!existsSync(tempKtx2)) {
-            throw new Error(`pmrem:texture[${index}] ${name}: basisu did not produce output`);
+            throw new Error(`NEEDLE_pmrem[${index}] ${name}: basisu did not produce output`);
         }
         // 4. Read KTX2 result
         const ktx2Bytes = readFileSync(tempKtx2);

package/dist/utils/version.gen.d.ts

@@ -1 +1 @@
-export declare const version = "2.15.9-next.e981752";
+export declare const version = "2.15.9";

package/dist/utils/version.gen.js

@@ -1 +1 @@
-export const version = "2.15.9-next.e981752";
+export const version = "2.15.9";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/gltf-build-pipeline",
-  "version": "2.15.9-next.e981752",
+  "version": "2.15.9",
   "description": "Pipeline and tools for optimizing gltf files using gltf-transform and compression settings within glTF extensions",
   "main": "dist/index.js",
   "type": "module",