@dendotdev/grunt 1.0.2 → 1.0.3

package/dist/index.d.mts

@@ -429,6 +429,13 @@ interface RequestOptions {
      * @default true
      */
     enforceSuccess?: boolean;
+    /**
+     * Return raw bytes instead of deserializing the response.
+     * Use this for binary data like images, blobs, and film chunks.
+     *
+     * @default false
+     */
+    returnRaw?: boolean;
 }
 
 /**
@@ -578,6 +585,7 @@ declare abstract class ModuleBase {
         useClearance?: boolean;
         useSpartanToken?: boolean;
         customHeaders?: Record<string, string>;
+        returnRaw?: boolean;
     }): Promise<HaloApiResult<T>>;
     /**
      * Execute a GET request to an absolute URL.
@@ -595,6 +603,7 @@ declare abstract class ModuleBase {
         useSpartanToken?: boolean;
         customHeaders?: Record<string, string>;
         enforceSuccess?: boolean;
+        returnRaw?: boolean;
     }): Promise<HaloApiResult<T>>;
     /**
      * Execute a POST request to this module's service.

package/dist/index.d.ts

@@ -429,6 +429,13 @@ interface RequestOptions {
      * @default true
      */
     enforceSuccess?: boolean;
+    /**
+     * Return raw bytes instead of deserializing the response.
+     * Use this for binary data like images, blobs, and film chunks.
+     *
+     * @default false
+     */
+    returnRaw?: boolean;
 }
 
 /**
@@ -578,6 +585,7 @@ declare abstract class ModuleBase {
         useClearance?: boolean;
         useSpartanToken?: boolean;
         customHeaders?: Record<string, string>;
+        returnRaw?: boolean;
     }): Promise<HaloApiResult<T>>;
     /**
      * Execute a GET request to an absolute URL.
@@ -595,6 +603,7 @@ declare abstract class ModuleBase {
         useSpartanToken?: boolean;
         customHeaders?: Record<string, string>;
         enforceSuccess?: boolean;
+        returnRaw?: boolean;
     }): Promise<HaloApiResult<T>>;
     /**
      * Execute a POST request to this module's service.

package/dist/index.js

@@ -336,8 +336,13 @@ var ClientBase = class {
         );
       }
       if (response.status === 304 && cached) {
-        result.result = this.deserializeResponse(cached.content);
-        result.response.message = "304 Not Modified - using cached response";
+        if (options.returnRaw) {
+          result.result = cached.content;
+          result.response.message = `304 Not Modified - cached binary: ${cached.content.length} bytes`;
+        } else {
+          result.result = this.deserializeResponse(cached.content);
+          result.response.message = "304 Not Modified - using cached response";
+        }
         return result;
       }
       const bodyBuffer = await response.arrayBuffer();
@@ -346,10 +351,15 @@ var ClientBase = class {
         const etag = response.headers.get(HEADERS.ETAG) ?? void 0;
         this.cache.set(cacheKey, { etag, content: bodyBytes });
       }
-      const bodyText = new TextDecoder().decode(bodyBytes);
-      result.response.message = bodyText;
-      if (response.ok || options.enforceSuccess !== false) {
-        result.result = this.deserializeResponse(bodyBytes);
+      if (options.returnRaw) {
+        result.result = bodyBytes;
+        result.response.message = `Binary response: ${bodyBytes.length} bytes`;
+      } else {
+        const bodyText = new TextDecoder().decode(bodyBytes);
+        result.response.message = bodyText;
+        if (response.ok || options.enforceSuccess !== false) {
+          result.result = this.deserializeResponse(bodyBytes);
+        }
       }
     } catch (error) {
       result.response.code = 0;
@@ -536,7 +546,8 @@ var ModuleBase = class {
     return this.client.executeRequest(this.buildUrl(path), "GET", {
       useSpartanToken: options.useSpartanToken ?? true,
       useClearance: options.useClearance ?? false,
-      customHeaders: options.customHeaders
+      customHeaders: options.customHeaders,
+      returnRaw: options.returnRaw
     });
   }
   /**
@@ -555,7 +566,8 @@ var ModuleBase = class {
       useSpartanToken: options.useSpartanToken ?? true,
       useClearance: options.useClearance ?? false,
       customHeaders: options.customHeaders,
-      enforceSuccess: options.enforceSuccess ?? true
+      enforceSuccess: options.enforceSuccess ?? true,
+      returnRaw: options.returnRaw
     });
   }
   /**
@@ -1304,7 +1316,7 @@ var GameCmsModule = class extends ModuleBase {
    */
   getImage(filePath) {
     this.assertNotEmpty(filePath, "filePath");
-    return this.get(`/hi/images/file/${filePath}`);
+    return this.get(`/hi/images/file/${filePath}`, { returnRaw: true });
   }
   /**
    * Get a generic file from the CMS.
@@ -1314,7 +1326,7 @@ var GameCmsModule = class extends ModuleBase {
    */
   getGenericFile(filePath) {
     this.assertNotEmpty(filePath, "filePath");
-    return this.get(`/hi/Progression/file/${filePath}`);
+    return this.get(`/hi/Progression/file/${filePath}`, { returnRaw: true });
   }
   /**
    * Get a raw progression file with custom type.
@@ -1975,7 +1987,7 @@ var UgcModule = class extends ModuleBase {
   getBlob(blobPath) {
     this.assertNotEmpty(blobPath, "blobPath");
     const blobUrl = `https://${HALO_CORE_ENDPOINTS.BLOBS_ORIGIN}.${HALO_CORE_ENDPOINTS.SERVICE_DOMAIN}${blobPath}`;
-    return this.getFullUrl(blobUrl, { useSpartanToken: false });
+    return this.getFullUrl(blobUrl, { useSpartanToken: false, returnRaw: true });
   }
 };