@poof-bg/js 1.0.0 → 1.1.0

package/README.md

@@ -50,13 +50,35 @@ const url = URL.createObjectURL(blob);
 ```typescript
 const result = await poof.removeBackground(file, {
   format: 'webp',      // Output format: 'png' | 'jpg' | 'webp'
-  crop: true,          // Crop to subject bounds
-  size: 'medium',      // Size: 'full' | 'preview' | 'small' | 'medium' | 'large'
-  channels: 'rgb',     // 'rgba' for transparency, 'rgb' for opaque
-  bgColor: '#ffffff',  // Background color (when channels is 'rgb')
+  crop: true,          // Crop to subject bounds, or an aspect ratio like '1:1'
+  padding: '10%',      // Padding around the subject when cropping
+  size: 'medium',      // Size preset: 'full' | 'preview' | 'medium' | 'hd'
+  channels: 'rgb',     // 'rgba' for transparency, 'rgb' for opaque, 'alpha' for the mask
+  bgColor: '#ffffff',  // Background color (when channels is 'rgb' or 'rgba')
 });
 ```
 
+### Fixed Output Size
+
+Resize to an exact size without stretching. `fit` decides what happens with the aspect-ratio difference: `contain` (default) pads, `cover` crops the overflow around the subject, `scale-down` pads without ever enlarging a smaller image. Setting only `width` or `height` keeps the aspect ratio. `size` is ignored when a fixed size is set.
+
+```typescript
+// 500x500 product image: subject cropped, padded and centred
+const result = await poof.removeBackground(file, { crop: true, width: 500, height: 500 });
+
+// Fill a 1080x1080 canvas on white instead
+const result = await poof.removeBackground(file, {
+  width: 1080,
+  height: 1080,
+  fit: 'cover',
+  format: 'jpg',
+  bgColor: '#ffffff',
+});
+
+// Cap the width at 1000px, keep the aspect ratio, leave smaller images alone
+const result = await poof.removeBackground(file, { width: 1000, fit: 'scale-down' });
+```
+
 ### Node.js: From File Path
 
 ```typescript

package/dist/index.cjs

@@ -116,14 +116,10 @@ async function toBlob(input) {
     const mimeType = detectMimeType(uint8);
     return new Blob([input], { type: mimeType });
   }
-  if (input instanceof Uint8Array) {
-    const mimeType = detectMimeType(input);
-    return new Blob([input], { type: mimeType });
-  }
-  if (isNode && Buffer.isBuffer(input)) {
-    const uint8 = new Uint8Array(input);
-    const mimeType = detectMimeType(uint8);
-    return new Blob([input], { type: mimeType });
+  if (input instanceof Uint8Array || isNode && Buffer.isBuffer(input)) {
+    const bytes = Uint8Array.from(input);
+    const mimeType = detectMimeType(bytes);
+    return new Blob([bytes], { type: mimeType });
   }
   if (typeof input === "string") {
     if (!isNode) {
@@ -193,6 +189,9 @@ var Poof = class {
    *   size: 'medium'
    * });
    *
+   * // Exact 500x500 output, subject cropped and centred, never stretched
+   * const result = await poof.removeBackground(file, { crop: true, width: 500, height: 500 });
+   *
    * // Node.js: from file path
    * const result = await poof.removeBackground('/path/to/image.png');
    *
@@ -211,6 +210,10 @@ var Poof = class {
     if (options.bgColor) formData.append("bg_color", options.bgColor);
     if (options.size) formData.append("size", options.size);
     if (options.crop !== void 0) formData.append("crop", String(options.crop));
+    if (options.padding) formData.append("padding", options.padding);
+    if (options.width !== void 0) formData.append("width", String(options.width));
+    if (options.height !== void 0) formData.append("height", String(options.height));
+    if (options.fit) formData.append("fit", options.fit);
     const response = await this.fetch(`${this.baseUrl}/remove`, {
       method: "POST",
       body: formData
@@ -219,6 +222,8 @@ var Poof = class {
       await this.handleError(response);
     }
     const data = await response.arrayBuffer();
+    const matteConfidence = response.headers.get("X-Matte-Confidence");
+    const matteAmbiguousRatio = response.headers.get("X-Matte-Ambiguous-Ratio");
     return {
       data,
       metadata: {
@@ -226,7 +231,9 @@ var Poof = class {
         processingTimeMs: parseInt(response.headers.get("X-Processing-Time-Ms") || "0", 10),
         width: parseInt(response.headers.get("X-Image-Width") || "0", 10),
         height: parseInt(response.headers.get("X-Image-Height") || "0", 10),
-        contentType: response.headers.get("Content-Type") || "image/png"
+        contentType: response.headers.get("Content-Type") || "image/png",
+        matteConfidence: matteConfidence !== null ? parseFloat(matteConfidence) : void 0,
+        matteAmbiguousRatio: matteAmbiguousRatio !== null ? parseFloat(matteAmbiguousRatio) : void 0
       }
     };
   }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/client.ts"],"names":[],"mappings":";;;AAKO,IAAM,SAAA,GAAN,MAAM,UAAA,SAAkB,KAAA,CAAM;AAAA;AAAA,EAE1B,IAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA,EAEA,SAAA;AAAA;AAAA,EAEA,OAAA;AAAA,EAET,WAAA,CACE,OAAA,EACA,IAAA,EACA,OAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,WAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,SAAS,OAAA,EAAS,MAAA;AACvB,IAAA,IAAA,CAAK,YAAY,OAAA,EAAS,SAAA;AAC1B,IAAA,IAAA,CAAK,UAAU,OAAA,EAAS,OAAA;AAGxB,IAAA,IAAI,mBAAA,IAAuB,KAAA,IAAS,OAAO,KAAA,CAAM,sBAAsB,UAAA,EAAY;AACjF,MAAA,KAAA,CAAM,iBAAA,CAAkB,IAAA,EAAM,IAAA,CAAK,WAAW,CAAA;AAAA,IAChD;AAAA,EACF;AAAA;AAAA,EAGA,OAAO,YAAA,CAAa,QAAA,EAA4B,MAAA,EAA2B;AACzE,IAAA,MAAM,UAAA,GAAa,SAAA,CAAU,QAAA,CAAS,IAAI,CAAA,IAAK,UAAA;AAC/C,IAAA,OAAO,IAAI,UAAA,CAAW,QAAA,CAAS,OAAA,EAAS,SAAS,IAAA,EAAM;AAAA,MACrD,MAAA;AAAA,MACA,WAAW,QAAA,CAAS,UAAA;AAAA,MACpB,SAAS,QAAA,CAAS;AAAA,KACnB,CAAA;AAAA,EACH;AACF;AAKO,IAAM,mBAAA,GAAN,cAAkC,SAAA,CAAU;AAAA,EACjD,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AAAA,EACd;AACF;AAKO,IAAM,eAAA,GAAN,cAA8B,SAAA,CAAU;AAAA,EAC7C,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAKO,IAAM,oBAAA,GAAN,cAAmC,SAAA,CAAU;AAAA,EAClD,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AAAA,EACd;AACF;AAKO,IAAM,cAAA,GAAN,cAA6B,SAAA,CAAU;AAAA,EAC5C,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AAAA,EACd;AACF;AAKO,IAAM,eAAA,GAAN,cAA8B,SAAA,CAAU;AAAA,EAC7C,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAKO,IAAM,WAAA,GAAN,cAA0B,SAAA,CAAU;AAAA,EACzC,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AAAA,EACd;AACF;AAGA,IAAM,SAAA,GAAiD;AAAA,EACrD,oBAAA,EAAsB,mBAAA;AAAA,EACtB,iBAAA,EAAmB,eAAA;AAAA,EACnB,gBAAA,EAAkB,oBAAA;AAAA,EAClB,mBAAA,EAAqB,cAAA;AAAA,EACrB,gBAAA,EAAkB,eAAA;AAAA,EAClB,aAAA,EAAe,eAAA;AAAA,EACf,eAAA,EAAiB,eAAA;AAAA,EACjB,cAAA,EAAgB,WAAA;AAAA,EAChB,qBAAA,EAAuB;AACzB,CAAA;;;AChHO,IAAM,MAAA,GAAS,OAAO,OAAA,KAAY,WAAA,IAAe,QAAQ,QAAA,EAAU,IAAA;AAG1E,SAAS,eAAe,MAAA,EAA4B;AAElD,EAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,GAAA,IAAQ,OAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,MAAM,EAAA,EAAM;AACxF,IAAA,OAAO,WAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,GAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,GAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,GAAA,EAAM;AAClE,IAAA,OAAO,YAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,OAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,MAAM,EAAA,EAAM;AAExF,IAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,OAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,EAAE,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,EAAE,MAAM,EAAA,EAAM;AAC1F,MAAA,OAAO,YAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,EAAM;AAClE,IAAA,OAAO,WAAA;AAAA,EACT;AAEA,EAAA,OAAO,0BAAA;AACT;AAGA,SAAS,aAAa,QAAA,EAA0B;AAC9C,EAAA,MAAM,GAAA,GAA8B;AAAA,IAClC,WAAA,EAAa,KAAA;AAAA,IACb,YAAA,EAAc,KAAA;AAAA,IACd,YAAA,EAAc,MAAA;AAAA,IACd,WAAA,EAAa;AAAA,GACf;AACA,EAAA,OAAO,GAAA,CAAI,QAAQ,CAAA,IAAK,KAAA;AAC1B;AAGA,eAAsB,OAAO,KAAA,EAAkC;AAE7D,EAAA,IAAI,iBAAiB,IAAA,EAAM;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AAGA,EAAA,IAAI,iBAAiB,WAAA,EAAa;AAChC,IAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,KAAK,CAAA;AAClC,IAAA,MAAM,QAAA,GAAW,eAAe,KAAK,CAAA;AACrC,IAAA,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,IAAA,EAAM,UAAU,CAAA;AAAA,EAC7C;AAGA,EAAA,IAAI,iBAAiB,UAAA,EAAY;AAC/B,IAAA,MAAM,QAAA,GAAW,eAAe,KAAK,CAAA;AACrC,IAAA,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,IAAA,EAAM,UAAU,CAAA;AAAA,EAC7C;AAGA,EAAA,IAAI,MAAA,IAAU,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,EAAG;AACpC,IAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,KAAK,CAAA;AAClC,IAAA,MAAM,QAAA,GAAW,eAAe,KAAK,CAAA;AACrC,IAAA,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,IAAA,EAAM,UAAU,CAAA;AAAA,EAC7C;AAGA,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,8EAA8E,CAAA;AAAA,IAChG;AAEA,IAAA,MAAM,EAAA,GAAK,MAAM,OAAO,aAAkB,CAAA;AAC1C,IAAA,MAAM,IAAA,GAAO,MAAM,OAAO,MAAW,CAAA;AAErC,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,QAAA,CAAS,KAAK,CAAA;AACtC,IAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,MAAM,CAAA;AACnC,IAAA,MAAM,QAAA,GAAW,eAAe,KAAK,CAAA;AACrC,IAAA,MAAM,GAAA,GAAM,KAAK,OAAA,CAAQ,KAAK,EAAE,WAAA,EAAY,CAAE,MAAM,CAAC,CAAA;AAGrD,IAAA,MAAM,WAAA,GAAsC;AAAA,MAC1C,GAAA,EAAK,WAAA;AAAA,MACL,GAAA,EAAK,YAAA;AAAA,MACL,IAAA,EAAM,YAAA;AAAA,MACN,IAAA,EAAM,YAAA;AAAA,MACN,GAAA,EAAK;AAAA,KACP;AAEA,IAAA,MAAM,aAAA,GAAgB,WAAA,CAAY,GAAG,CAAA,IAAK,QAAA;AAC1C,IAAA,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,IAAA,EAAM,eAAe,CAAA;AAAA,EACnD;AAEA,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,wBAAA,EAA2B,OAAO,KAAK,CAAA,CAAE,CAAA;AAC3D;AAGO,SAAS,WAAA,CAAY,OAAmB,QAAA,EAA0B;AAEvE,EAAA,IAAI,OAAO,IAAA,KAAS,WAAA,IAAe,KAAA,YAAiB,IAAA,EAAM;AACxD,IAAA,OAAO,KAAA,CAAM,IAAA;AAAA,EACf;AAGA,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,MAAA,EAAQ;AAEvC,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,OAAO,CAAA;AACjC,IAAA,OAAO,KAAA,CAAM,MAAM,MAAA,GAAS,CAAC,KAAK,CAAA,MAAA,EAAS,YAAA,CAAa,QAAQ,CAAC,CAAA,CAAA;AAAA,EACnE;AAGA,EAAA,OAAO,CAAA,MAAA,EAAS,YAAA,CAAa,QAAQ,CAAC,CAAA,CAAA;AACxC;;;ACpGA,IAAM,gBAAA,GAAmB,wBAAA;AACzB,IAAM,eAAA,GAAkB,GAAA;AAajB,IAAM,OAAN,MAAW;AAAA,EACC,MAAA;AAAA,EACA,OAAA;AAAA,EACA,OAAA;AAAA,EAEjB,YAAY,OAAA,EAAsB;AAChC,IAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,MAAA,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAAA,IACvC;AAEA,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA,EAAS,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA,IAAK,gBAAA;AACtD,IAAA,IAAA,CAAK,OAAA,GAAU,QAAQ,OAAA,IAAW,eAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BA,MAAM,gBAAA,CACJ,KAAA,EACA,OAAA,GAAmC,EAAC,EACH;AACjC,IAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAAO,KAAK,CAAA;AAC/B,IAAA,MAAM,QAAA,GAAW,WAAA,CAAY,KAAA,EAAO,IAAA,CAAK,IAAI,CAAA;AAE7C,IAAA,MAAM,QAAA,GAAW,IAAI,QAAA,EAAS;AAC9B,IAAA,QAAA,CAAS,MAAA,CAAO,YAAA,EAAc,IAAA,EAAM,QAAQ,CAAA;AAG5C,IAAA,IAAI,QAAQ,MAAA,EAAQ,QAAA,CAAS,MAAA,CAAO,QAAA,EAAU,QAAQ,MAAM,CAAA;AAC5D,IAAA,IAAI,QAAQ,QAAA,EAAU,QAAA,CAAS,MAAA,CAAO,UAAA,EAAY,QAAQ,QAAQ,CAAA;AAClE,IAAA,IAAI,QAAQ,OAAA,EAAS,QAAA,CAAS,MAAA,CAAO,UAAA,EAAY,QAAQ,OAAO,CAAA;AAChE,IAAA,IAAI,QAAQ,IAAA,EAAM,QAAA,CAAS,MAAA,CAAO,MAAA,EAAQ,QAAQ,IAAI,CAAA;AACtD,IAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW,QAAA,CAAS,OAAO,MAAA,EAAQ,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAC,CAAA;AAE5E,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,MAAM,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,OAAA,CAAA,EAAW;AAAA,MAC1D,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM;AAAA,KACP,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,IAAA,CAAK,YAAY,QAAQ,CAAA;AAAA,IACjC;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,WAAA,EAAY;AAExC,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,QAAA,EAAU;AAAA,QACR,SAAA,EAAW,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,EAAA;AAAA,QACnD,gBAAA,EAAkB,SAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,sBAAsB,CAAA,IAAK,KAAK,EAAE,CAAA;AAAA,QAClF,KAAA,EAAO,SAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,eAAe,CAAA,IAAK,KAAK,EAAE,CAAA;AAAA,QAChE,MAAA,EAAQ,SAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,gBAAgB,CAAA,IAAK,KAAK,EAAE,CAAA;AAAA,QAClE,WAAA,EAAa,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK;AAAA;AACvD,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,EAAA,GAA2B;AAC/B,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,MAAM,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,GAAA,CAAA,EAAO;AAAA,MACtD,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACP,MAAA,EAAQ;AAAA;AACV,KACD,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,IAAA,CAAK,YAAY,QAAQ,CAAA;AAAA,IACjC;AAEA,IAAA,OAAO,SAAS,IAAA,EAAK;AAAA,EACvB;AAAA;AAAA,EAGA,MAAc,KAAA,CAAM,GAAA,EAAa,IAAA,EAAsC;AACrE,IAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAQ,IAAA,CAAK,OAAO,CAAA;AACxC,IAAA,OAAA,CAAQ,GAAA,CAAI,WAAA,EAAa,IAAA,CAAK,MAAM,CAAA;AAEpC,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,MAAM,YAAY,UAAA,CAAW,MAAM,WAAW,KAAA,EAAM,EAAG,KAAK,OAAO,CAAA;AAEnE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,GAAG,IAAA;AAAA,QACH,OAAA;AAAA,QACA,QAAQ,UAAA,CAAW;AAAA,OACpB,CAAA;AACD,MAAA,OAAO,QAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,EAAc;AACzD,QAAA,MAAM,IAAI,SAAA,CAAU,iBAAA,EAAmB,WAAW,EAAE,MAAA,EAAQ,KAAK,CAAA;AAAA,MACnE;AACA,MAAA,MAAM,KAAA;AAAA,IACR,CAAA,SAAE;AACA,MAAA,YAAA,CAAa,SAAS,CAAA;AAAA,IACxB;AAAA,EACF;AAAA;AAAA,EAGA,MAAc,YAAY,QAAA,EAAoC;AAC5D,IAAA,IAAI,SAAA;AAEJ,IAAA,IAAI;AACF,MAAA,SAAA,GAAY,MAAM,SAAS,IAAA,EAAK;AAAA,IAClC,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,SAAA;AAAA,QACR,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,SAAS,UAAU,CAAA,CAAA;AAAA,QAC/C,eAAA;AAAA,QACA,EAAE,MAAA,EAAQ,QAAA,CAAS,MAAA;AAAO,OAC5B;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,CAAU,YAAA,CAAa,SAAA,EAAW,QAAA,CAAS,MAAM,CAAA;AAAA,EACzD;AACF","file":"index.cjs","sourcesContent":["import type { ErrorCode, ApiErrorResponse } from './types.js';\n\n/**\n * Base error class for all Poof SDK errors\n */\nexport class PoofError extends Error {\n  /** Machine-readable error code */\n  readonly code: string;\n  /** HTTP status code */\n  readonly status?: number;\n  /** Unique request ID for support */\n  readonly requestId?: string;\n  /** Additional details */\n  readonly details?: string;\n\n  constructor(\n    message: string,\n    code: string,\n    options?: { status?: number; requestId?: string; details?: string }\n  ) {\n    super(message);\n    this.name = 'PoofError';\n    this.code = code;\n    this.status = options?.status;\n    this.requestId = options?.requestId;\n    this.details = options?.details;\n\n    // Maintains proper stack trace for where error was thrown (V8 engines)\n    if ('captureStackTrace' in Error && typeof Error.captureStackTrace === 'function') {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  /** Create error from API response */\n  static fromResponse(response: ApiErrorResponse, status: number): PoofError {\n    const ErrorClass = ERROR_MAP[response.code] || PoofError;\n    return new ErrorClass(response.message, response.code, {\n      status,\n      requestId: response.request_id,\n      details: response.details,\n    });\n  }\n}\n\n/**\n * Thrown when the API key is invalid or missing\n */\nexport class AuthenticationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'AuthenticationError';\n  }\n}\n\n/**\n * Thrown when the account doesn't have permission\n */\nexport class PermissionError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PermissionError';\n  }\n}\n\n/**\n * Thrown when the account has insufficient credits\n */\nexport class PaymentRequiredError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PaymentRequiredError';\n  }\n}\n\n/**\n * Thrown when rate limit is exceeded\n */\nexport class RateLimitError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Thrown when request parameters are invalid\n */\nexport class ValidationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Thrown when a server error occurs\n */\nexport class ServerError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ServerError';\n  }\n}\n\n/** Map error codes to error classes */\nconst ERROR_MAP: Record<ErrorCode, typeof PoofError> = {\n  authentication_error: AuthenticationError,\n  permission_denied: PermissionError,\n  payment_required: PaymentRequiredError,\n  rate_limit_exceeded: RateLimitError,\n  validation_error: ValidationError,\n  missing_image: ValidationError,\n  image_too_large: ValidationError,\n  upstream_error: ServerError,\n  internal_server_error: ServerError,\n};\n","import type { ImageInput } from './types.js';\n\n/** Check if running in Node.js environment */\nexport const isNode = typeof process !== 'undefined' && process.versions?.node;\n\n/** Detect MIME type from buffer */\nfunction detectMimeType(buffer: Uint8Array): string {\n  // Check magic bytes\n  if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {\n    return 'image/png';\n  }\n  if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {\n    return 'image/jpeg';\n  }\n  if (buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46) {\n    // RIFF header, check for WEBP\n    if (buffer[8] === 0x57 && buffer[9] === 0x45 && buffer[10] === 0x42 && buffer[11] === 0x50) {\n      return 'image/webp';\n    }\n  }\n  if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46) {\n    return 'image/gif';\n  }\n  // Default to octet-stream\n  return 'application/octet-stream';\n}\n\n/** Get file extension from MIME type */\nfunction getExtension(mimeType: string): string {\n  const map: Record<string, string> = {\n    'image/png': 'png',\n    'image/jpeg': 'jpg',\n    'image/webp': 'webp',\n    'image/gif': 'gif',\n  };\n  return map[mimeType] || 'bin';\n}\n\n/** Convert various input types to a Blob suitable for FormData */\nexport async function toBlob(input: ImageInput): Promise<Blob> {\n  // Already a Blob or File\n  if (input instanceof Blob) {\n    return input;\n  }\n\n  // ArrayBuffer\n  if (input instanceof ArrayBuffer) {\n    const uint8 = new Uint8Array(input);\n    const mimeType = detectMimeType(uint8);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // Uint8Array\n  if (input instanceof Uint8Array) {\n    const mimeType = detectMimeType(input);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // Node.js Buffer\n  if (isNode && Buffer.isBuffer(input)) {\n    const uint8 = new Uint8Array(input);\n    const mimeType = detectMimeType(uint8);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // String - treat as file path (Node.js only)\n  if (typeof input === 'string') {\n    if (!isNode) {\n      throw new Error('File paths are only supported in Node.js. Use a Blob or File in the browser.');\n    }\n    \n    const fs = await import('node:fs/promises');\n    const path = await import('node:path');\n    \n    const buffer = await fs.readFile(input);\n    const uint8 = new Uint8Array(buffer);\n    const mimeType = detectMimeType(uint8);\n    const ext = path.extname(input).toLowerCase().slice(1);\n    \n    // Use file extension for mime type if available\n    const mimeFromExt: Record<string, string> = {\n      png: 'image/png',\n      jpg: 'image/jpeg',\n      jpeg: 'image/jpeg',\n      webp: 'image/webp',\n      gif: 'image/gif',\n    };\n    \n    const finalMimeType = mimeFromExt[ext] || mimeType;\n    return new Blob([buffer], { type: finalMimeType });\n  }\n\n  throw new Error(`Unsupported input type: ${typeof input}`);\n}\n\n/** Get filename for FormData */\nexport function getFilename(input: ImageInput, mimeType: string): string {\n  // File has a name\n  if (typeof File !== 'undefined' && input instanceof File) {\n    return input.name;\n  }\n\n  // String path\n  if (typeof input === 'string' && isNode) {\n    // Extract filename from path\n    const parts = input.split(/[/\\\\]/);\n    return parts[parts.length - 1] || `image.${getExtension(mimeType)}`;\n  }\n\n  // Generate name from mime type\n  return `image.${getExtension(mimeType)}`;\n}\n","import type {\n  PoofOptions,\n  ImageInput,\n  RemoveBackgroundOptions,\n  RemoveBackgroundResult,\n  AccountInfo,\n  ApiErrorResponse,\n} from './types.js';\nimport { PoofError } from './errors.js';\nimport { toBlob, getFilename } from './utils.js';\n\nconst DEFAULT_BASE_URL = 'https://api.poof.bg/v1';\nconst DEFAULT_TIMEOUT = 60000;\n\n/**\n * Poof API client for background removal\n *\n * @example\n * ```typescript\n * import { Poof } from '@poof-bg/js';\n *\n * const poof = new Poof({ apiKey: 'your-api-key' });\n * const result = await poof.removeBackground(imageFile);\n * ```\n */\nexport class Poof {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: PoofOptions) {\n    if (!options.apiKey) {\n      throw new Error('API key is required');\n    }\n\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl?.replace(/\\/$/, '') || DEFAULT_BASE_URL;\n    this.timeout = options.timeout || DEFAULT_TIMEOUT;\n  }\n\n  /**\n   * Remove background from an image\n   *\n   * @param input - Image input: File, Blob, Buffer, ArrayBuffer, Uint8Array, or file path (Node.js)\n   * @param options - Processing options\n   * @returns Processed image data and metadata\n   *\n   * @example\n   * ```typescript\n   * // Basic usage\n   * const result = await poof.removeBackground(file);\n   * const imageBlob = new Blob([result.data], { type: result.metadata.contentType });\n   *\n   * // With options\n   * const result = await poof.removeBackground(file, {\n   *   format: 'webp',\n   *   crop: true,\n   *   size: 'medium'\n   * });\n   *\n   * // Node.js: from file path\n   * const result = await poof.removeBackground('/path/to/image.png');\n   *\n   * // Node.js: save to file\n   * const fs = require('fs');\n   * fs.writeFileSync('output.png', Buffer.from(result.data));\n   * ```\n   */\n  async removeBackground(\n    input: ImageInput,\n    options: RemoveBackgroundOptions = {}\n  ): Promise<RemoveBackgroundResult> {\n    const blob = await toBlob(input);\n    const filename = getFilename(input, blob.type);\n\n    const formData = new FormData();\n    formData.append('image_file', blob, filename);\n\n    // Add optional parameters\n    if (options.format) formData.append('format', options.format);\n    if (options.channels) formData.append('channels', options.channels);\n    if (options.bgColor) formData.append('bg_color', options.bgColor);\n    if (options.size) formData.append('size', options.size);\n    if (options.crop !== undefined) formData.append('crop', String(options.crop));\n\n    const response = await this.fetch(`${this.baseUrl}/remove`, {\n      method: 'POST',\n      body: formData,\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    const data = await response.arrayBuffer();\n\n    return {\n      data,\n      metadata: {\n        requestId: response.headers.get('X-Request-ID') || '',\n        processingTimeMs: parseInt(response.headers.get('X-Processing-Time-Ms') || '0', 10),\n        width: parseInt(response.headers.get('X-Image-Width') || '0', 10),\n        height: parseInt(response.headers.get('X-Image-Height') || '0', 10),\n        contentType: response.headers.get('Content-Type') || 'image/png',\n      },\n    };\n  }\n\n  /**\n   * Get account information\n   *\n   * @returns Account info including plan and credit usage\n   *\n   * @example\n   * ```typescript\n   * const account = await poof.me();\n   * console.log(`Plan: ${account.plan}`);\n   * console.log(`Credits: ${account.usedCredits}/${account.maxCredits}`);\n   * ```\n   */\n  async me(): Promise<AccountInfo> {\n    const response = await this.fetch(`${this.baseUrl}/me`, {\n      method: 'GET',\n      headers: {\n        Accept: 'application/json',\n      },\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json();\n  }\n\n  /** Make a fetch request with auth and timeout */\n  private async fetch(url: string, init: RequestInit): Promise<Response> {\n    const headers = new Headers(init.headers);\n    headers.set('x-api-key', this.apiKey);\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers,\n        signal: controller.signal,\n      });\n      return response;\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new PoofError('Request timeout', 'timeout', { status: 408 });\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /** Handle error response */\n  private async handleError(response: Response): Promise<never> {\n    let errorData: ApiErrorResponse;\n\n    try {\n      errorData = await response.json();\n    } catch {\n      throw new PoofError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        'unknown_error',\n        { status: response.status }\n      );\n    }\n\n    throw PoofError.fromResponse(errorData, response.status);\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ErrorCode, ApiErrorResponse } from './types.js';\n\n/**\n * Base error class for all Poof SDK errors\n */\nexport class PoofError extends Error {\n  /** Machine-readable error code */\n  readonly code: string;\n  /** HTTP status code */\n  readonly status?: number;\n  /** Unique request ID for support */\n  readonly requestId?: string;\n  /** Additional details */\n  readonly details?: string;\n\n  constructor(\n    message: string,\n    code: string,\n    options?: { status?: number; requestId?: string; details?: string }\n  ) {\n    super(message);\n    this.name = 'PoofError';\n    this.code = code;\n    this.status = options?.status;\n    this.requestId = options?.requestId;\n    this.details = options?.details;\n\n    // Maintains proper stack trace for where error was thrown (V8 engines)\n    if ('captureStackTrace' in Error && typeof Error.captureStackTrace === 'function') {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  /** Create error from API response */\n  static fromResponse(response: ApiErrorResponse, status: number): PoofError {\n    const ErrorClass = ERROR_MAP[response.code] || PoofError;\n    return new ErrorClass(response.message, response.code, {\n      status,\n      requestId: response.request_id,\n      details: response.details,\n    });\n  }\n}\n\n/**\n * Thrown when the API key is invalid or missing\n */\nexport class AuthenticationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'AuthenticationError';\n  }\n}\n\n/**\n * Thrown when the account doesn't have permission\n */\nexport class PermissionError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PermissionError';\n  }\n}\n\n/**\n * Thrown when the account has insufficient credits\n */\nexport class PaymentRequiredError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PaymentRequiredError';\n  }\n}\n\n/**\n * Thrown when rate limit is exceeded\n */\nexport class RateLimitError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Thrown when request parameters are invalid\n */\nexport class ValidationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Thrown when a server error occurs\n */\nexport class ServerError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ServerError';\n  }\n}\n\n/** Map error codes to error classes */\nconst ERROR_MAP: Record<ErrorCode, typeof PoofError> = {\n  authentication_error: AuthenticationError,\n  permission_denied: PermissionError,\n  payment_required: PaymentRequiredError,\n  rate_limit_exceeded: RateLimitError,\n  validation_error: ValidationError,\n  missing_image: ValidationError,\n  image_too_large: ValidationError,\n  upstream_error: ServerError,\n  internal_server_error: ServerError,\n};\n","import type { ImageInput } from './types.js';\n\n/** Check if running in Node.js environment */\nexport const isNode = typeof process !== 'undefined' && process.versions?.node;\n\n/** Detect MIME type from buffer */\nfunction detectMimeType(buffer: Uint8Array): string {\n  // Check magic bytes\n  if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {\n    return 'image/png';\n  }\n  if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {\n    return 'image/jpeg';\n  }\n  if (buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46) {\n    // RIFF header, check for WEBP\n    if (buffer[8] === 0x57 && buffer[9] === 0x45 && buffer[10] === 0x42 && buffer[11] === 0x50) {\n      return 'image/webp';\n    }\n  }\n  if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46) {\n    return 'image/gif';\n  }\n  // Default to octet-stream\n  return 'application/octet-stream';\n}\n\n/** Get file extension from MIME type */\nfunction getExtension(mimeType: string): string {\n  const map: Record<string, string> = {\n    'image/png': 'png',\n    'image/jpeg': 'jpg',\n    'image/webp': 'webp',\n    'image/gif': 'gif',\n  };\n  return map[mimeType] || 'bin';\n}\n\n/** Convert various input types to a Blob suitable for FormData */\nexport async function toBlob(input: ImageInput): Promise<Blob> {\n  // Already a Blob or File\n  if (input instanceof Blob) {\n    return input;\n  }\n\n  // ArrayBuffer\n  if (input instanceof ArrayBuffer) {\n    const uint8 = new Uint8Array(input);\n    const mimeType = detectMimeType(uint8);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // Uint8Array or Node.js Buffer. Copy into a fresh ArrayBuffer-backed view:\n  // a view over a SharedArrayBuffer (or a Buffer pool slice) is not a valid BlobPart.\n  if (input instanceof Uint8Array || (isNode && Buffer.isBuffer(input))) {\n    const bytes = Uint8Array.from(input);\n    const mimeType = detectMimeType(bytes);\n    return new Blob([bytes], { type: mimeType });\n  }\n\n  // String - treat as file path (Node.js only)\n  if (typeof input === 'string') {\n    if (!isNode) {\n      throw new Error('File paths are only supported in Node.js. Use a Blob or File in the browser.');\n    }\n    \n    const fs = await import('node:fs/promises');\n    const path = await import('node:path');\n    \n    const buffer = await fs.readFile(input);\n    const uint8 = new Uint8Array(buffer);\n    const mimeType = detectMimeType(uint8);\n    const ext = path.extname(input).toLowerCase().slice(1);\n    \n    // Use file extension for mime type if available\n    const mimeFromExt: Record<string, string> = {\n      png: 'image/png',\n      jpg: 'image/jpeg',\n      jpeg: 'image/jpeg',\n      webp: 'image/webp',\n      gif: 'image/gif',\n    };\n    \n    const finalMimeType = mimeFromExt[ext] || mimeType;\n    return new Blob([buffer], { type: finalMimeType });\n  }\n\n  throw new Error(`Unsupported input type: ${typeof input}`);\n}\n\n/** Get filename for FormData */\nexport function getFilename(input: ImageInput, mimeType: string): string {\n  // File has a name\n  if (typeof File !== 'undefined' && input instanceof File) {\n    return input.name;\n  }\n\n  // String path\n  if (typeof input === 'string' && isNode) {\n    // Extract filename from path\n    const parts = input.split(/[/\\\\]/);\n    return parts[parts.length - 1] || `image.${getExtension(mimeType)}`;\n  }\n\n  // Generate name from mime type\n  return `image.${getExtension(mimeType)}`;\n}\n","import type {\n  PoofOptions,\n  ImageInput,\n  RemoveBackgroundOptions,\n  RemoveBackgroundResult,\n  AccountInfo,\n  ApiErrorResponse,\n} from './types.js';\nimport { PoofError } from './errors.js';\nimport { toBlob, getFilename } from './utils.js';\n\nconst DEFAULT_BASE_URL = 'https://api.poof.bg/v1';\nconst DEFAULT_TIMEOUT = 60000;\n\n/**\n * Poof API client for background removal\n *\n * @example\n * ```typescript\n * import { Poof } from '@poof-bg/js';\n *\n * const poof = new Poof({ apiKey: 'your-api-key' });\n * const result = await poof.removeBackground(imageFile);\n * ```\n */\nexport class Poof {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: PoofOptions) {\n    if (!options.apiKey) {\n      throw new Error('API key is required');\n    }\n\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl?.replace(/\\/$/, '') || DEFAULT_BASE_URL;\n    this.timeout = options.timeout || DEFAULT_TIMEOUT;\n  }\n\n  /**\n   * Remove background from an image\n   *\n   * @param input - Image input: File, Blob, Buffer, ArrayBuffer, Uint8Array, or file path (Node.js)\n   * @param options - Processing options\n   * @returns Processed image data and metadata\n   *\n   * @example\n   * ```typescript\n   * // Basic usage\n   * const result = await poof.removeBackground(file);\n   * const imageBlob = new Blob([result.data], { type: result.metadata.contentType });\n   *\n   * // With options\n   * const result = await poof.removeBackground(file, {\n   *   format: 'webp',\n   *   crop: true,\n   *   size: 'medium'\n   * });\n   *\n   * // Exact 500x500 output, subject cropped and centred, never stretched\n   * const result = await poof.removeBackground(file, { crop: true, width: 500, height: 500 });\n   *\n   * // Node.js: from file path\n   * const result = await poof.removeBackground('/path/to/image.png');\n   *\n   * // Node.js: save to file\n   * const fs = require('fs');\n   * fs.writeFileSync('output.png', Buffer.from(result.data));\n   * ```\n   */\n  async removeBackground(\n    input: ImageInput,\n    options: RemoveBackgroundOptions = {}\n  ): Promise<RemoveBackgroundResult> {\n    const blob = await toBlob(input);\n    const filename = getFilename(input, blob.type);\n\n    const formData = new FormData();\n    formData.append('image_file', blob, filename);\n\n    // Add optional parameters\n    if (options.format) formData.append('format', options.format);\n    if (options.channels) formData.append('channels', options.channels);\n    if (options.bgColor) formData.append('bg_color', options.bgColor);\n    if (options.size) formData.append('size', options.size);\n    if (options.crop !== undefined) formData.append('crop', String(options.crop));\n    if (options.padding) formData.append('padding', options.padding);\n    if (options.width !== undefined) formData.append('width', String(options.width));\n    if (options.height !== undefined) formData.append('height', String(options.height));\n    if (options.fit) formData.append('fit', options.fit);\n\n    const response = await this.fetch(`${this.baseUrl}/remove`, {\n      method: 'POST',\n      body: formData,\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    const data = await response.arrayBuffer();\n\n    const matteConfidence = response.headers.get('X-Matte-Confidence');\n    const matteAmbiguousRatio = response.headers.get('X-Matte-Ambiguous-Ratio');\n\n    return {\n      data,\n      metadata: {\n        requestId: response.headers.get('X-Request-ID') || '',\n        processingTimeMs: parseInt(response.headers.get('X-Processing-Time-Ms') || '0', 10),\n        width: parseInt(response.headers.get('X-Image-Width') || '0', 10),\n        height: parseInt(response.headers.get('X-Image-Height') || '0', 10),\n        contentType: response.headers.get('Content-Type') || 'image/png',\n        matteConfidence: matteConfidence !== null ? parseFloat(matteConfidence) : undefined,\n        matteAmbiguousRatio: matteAmbiguousRatio !== null ? parseFloat(matteAmbiguousRatio) : undefined,\n      },\n    };\n  }\n\n  /**\n   * Get account information\n   *\n   * @returns Account info including plan and credit usage\n   *\n   * @example\n   * ```typescript\n   * const account = await poof.me();\n   * console.log(`Plan: ${account.plan}`);\n   * console.log(`Credits: ${account.usedCredits}/${account.maxCredits}`);\n   * ```\n   */\n  async me(): Promise<AccountInfo> {\n    const response = await this.fetch(`${this.baseUrl}/me`, {\n      method: 'GET',\n      headers: {\n        Accept: 'application/json',\n      },\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json();\n  }\n\n  /** Make a fetch request with auth and timeout */\n  private async fetch(url: string, init: RequestInit): Promise<Response> {\n    const headers = new Headers(init.headers);\n    headers.set('x-api-key', this.apiKey);\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers,\n        signal: controller.signal,\n      });\n      return response;\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new PoofError('Request timeout', 'timeout', { status: 408 });\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /** Handle error response */\n  private async handleError(response: Response): Promise<never> {\n    let errorData: ApiErrorResponse;\n\n    try {\n      errorData = await response.json();\n    } catch {\n      throw new PoofError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        'unknown_error',\n        { status: response.status }\n      );\n    }\n\n    throw PoofError.fromResponse(errorData, response.status);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -13,21 +13,36 @@ interface PoofOptions {
 /** Output image format */
 type ImageFormat = 'png' | 'jpg' | 'webp';
 /** Output color channels */
-type Channels = 'rgba' | 'rgb';
+type Channels = 'rgba' | 'rgb' | 'alpha';
 /** Output image size preset */
-type ImageSize = 'full' | 'preview' | 'small' | 'medium' | 'large';
+type ImageSize = 'full' | 'preview' | 'medium' | 'hd';
+/**
+ * How the image is fitted into a fixed width/height (never stretched):
+ * 'contain' scales to fit inside and pads the rest, 'cover' scales to fill and
+ * crops the overflow around the subject, 'scale-down' is contain without ever
+ * enlarging a smaller image.
+ */
+type FitMode = 'contain' | 'cover' | 'scale-down';
 /** Options for background removal */
 interface RemoveBackgroundOptions {
     /** Output format (default: png) */
     format?: ImageFormat;
-    /** Color channels - rgba for transparency, rgb for opaque (default: rgba) */
+    /** Color channels - rgba for transparency, rgb for opaque, alpha for the grayscale mask only (default: rgba) */
     channels?: Channels;
-    /** Background color (hex, rgb, or color name). Only applies when channels is 'rgb' */
+    /** Background color (hex, rgb, or color name). Applies when channels is 'rgb' or 'rgba' */
     bgColor?: string;
     /** Output size preset (default: full) */
     size?: ImageSize;
-    /** Crop to subject bounds (default: false) */
-    crop?: boolean;
+    /** Crop to subject bounds: true/false or an aspect ratio like '1:1', '4:3', '16:9' (default: false) */
+    crop?: boolean | string;
+    /** Padding around the subject when crop is enabled, as a fraction ('0.1') or percentage ('10%') */
+    padding?: string;
+    /** Output width in pixels (1-6000). On its own, the height follows the aspect ratio. Overrides size */
+    width?: number;
+    /** Output height in pixels (1-6000). On its own, the width follows the aspect ratio. Overrides size */
+    height?: number;
+    /** How to fit into width x height without stretching (default: contain) */
+    fit?: FitMode;
 }
 /** Metadata returned with processed images */
 interface ProcessingMetadata {
@@ -41,6 +56,16 @@ interface ProcessingMetadata {
     height: number;
     /** Content type of the result */
     contentType: string;
+    /**
+     * Confidence in the alpha matte, 0-1. 1 means a fully decisive mask; lower
+     * values mean the model hedged. Heuristic, not a calibrated probability.
+     */
+    matteConfidence?: number;
+    /**
+     * Fraction of pixels with alpha between 0.1 and 0.9, 0-1. High values
+     * indicate large uncertain regions - useful for flagging results for review.
+     */
+    matteAmbiguousRatio?: number;
 }
 /** Result of background removal including image data and metadata */
 interface RemoveBackgroundResult {
@@ -110,6 +135,9 @@ declare class Poof {
      *   size: 'medium'
      * });
      *
+     * // Exact 500x500 output, subject cropped and centred, never stretched
+     * const result = await poof.removeBackground(file, { crop: true, width: 500, height: 500 });
+     *
      * // Node.js: from file path
      * const result = await poof.removeBackground('/path/to/image.png');
      *
@@ -219,4 +247,4 @@ declare class ServerError extends PoofError {
     });
 }
 
-export { type AccountInfo, type ApiErrorResponse, AuthenticationError, type Channels, type ErrorCode, type ImageFormat, type ImageInput, type ImageSize, PaymentRequiredError, PermissionError, Poof, PoofError, type PoofOptions, type ProcessingMetadata, RateLimitError, type RemoveBackgroundOptions, type RemoveBackgroundResult, ServerError, ValidationError };
+export { type AccountInfo, type ApiErrorResponse, AuthenticationError, type Channels, type ErrorCode, type FitMode, type ImageFormat, type ImageInput, type ImageSize, PaymentRequiredError, PermissionError, Poof, PoofError, type PoofOptions, type ProcessingMetadata, RateLimitError, type RemoveBackgroundOptions, type RemoveBackgroundResult, ServerError, ValidationError };

package/dist/index.d.ts

@@ -13,21 +13,36 @@ interface PoofOptions {
 /** Output image format */
 type ImageFormat = 'png' | 'jpg' | 'webp';
 /** Output color channels */
-type Channels = 'rgba' | 'rgb';
+type Channels = 'rgba' | 'rgb' | 'alpha';
 /** Output image size preset */
-type ImageSize = 'full' | 'preview' | 'small' | 'medium' | 'large';
+type ImageSize = 'full' | 'preview' | 'medium' | 'hd';
+/**
+ * How the image is fitted into a fixed width/height (never stretched):
+ * 'contain' scales to fit inside and pads the rest, 'cover' scales to fill and
+ * crops the overflow around the subject, 'scale-down' is contain without ever
+ * enlarging a smaller image.
+ */
+type FitMode = 'contain' | 'cover' | 'scale-down';
 /** Options for background removal */
 interface RemoveBackgroundOptions {
     /** Output format (default: png) */
     format?: ImageFormat;
-    /** Color channels - rgba for transparency, rgb for opaque (default: rgba) */
+    /** Color channels - rgba for transparency, rgb for opaque, alpha for the grayscale mask only (default: rgba) */
     channels?: Channels;
-    /** Background color (hex, rgb, or color name). Only applies when channels is 'rgb' */
+    /** Background color (hex, rgb, or color name). Applies when channels is 'rgb' or 'rgba' */
     bgColor?: string;
     /** Output size preset (default: full) */
     size?: ImageSize;
-    /** Crop to subject bounds (default: false) */
-    crop?: boolean;
+    /** Crop to subject bounds: true/false or an aspect ratio like '1:1', '4:3', '16:9' (default: false) */
+    crop?: boolean | string;
+    /** Padding around the subject when crop is enabled, as a fraction ('0.1') or percentage ('10%') */
+    padding?: string;
+    /** Output width in pixels (1-6000). On its own, the height follows the aspect ratio. Overrides size */
+    width?: number;
+    /** Output height in pixels (1-6000). On its own, the width follows the aspect ratio. Overrides size */
+    height?: number;
+    /** How to fit into width x height without stretching (default: contain) */
+    fit?: FitMode;
 }
 /** Metadata returned with processed images */
 interface ProcessingMetadata {
@@ -41,6 +56,16 @@ interface ProcessingMetadata {
     height: number;
     /** Content type of the result */
     contentType: string;
+    /**
+     * Confidence in the alpha matte, 0-1. 1 means a fully decisive mask; lower
+     * values mean the model hedged. Heuristic, not a calibrated probability.
+     */
+    matteConfidence?: number;
+    /**
+     * Fraction of pixels with alpha between 0.1 and 0.9, 0-1. High values
+     * indicate large uncertain regions - useful for flagging results for review.
+     */
+    matteAmbiguousRatio?: number;
 }
 /** Result of background removal including image data and metadata */
 interface RemoveBackgroundResult {
@@ -110,6 +135,9 @@ declare class Poof {
      *   size: 'medium'
      * });
      *
+     * // Exact 500x500 output, subject cropped and centred, never stretched
+     * const result = await poof.removeBackground(file, { crop: true, width: 500, height: 500 });
+     *
      * // Node.js: from file path
      * const result = await poof.removeBackground('/path/to/image.png');
      *
@@ -219,4 +247,4 @@ declare class ServerError extends PoofError {
     });
 }
 
-export { type AccountInfo, type ApiErrorResponse, AuthenticationError, type Channels, type ErrorCode, type ImageFormat, type ImageInput, type ImageSize, PaymentRequiredError, PermissionError, Poof, PoofError, type PoofOptions, type ProcessingMetadata, RateLimitError, type RemoveBackgroundOptions, type RemoveBackgroundResult, ServerError, ValidationError };
+export { type AccountInfo, type ApiErrorResponse, AuthenticationError, type Channels, type ErrorCode, type FitMode, type ImageFormat, type ImageInput, type ImageSize, PaymentRequiredError, PermissionError, Poof, PoofError, type PoofOptions, type ProcessingMetadata, RateLimitError, type RemoveBackgroundOptions, type RemoveBackgroundResult, ServerError, ValidationError };

package/dist/index.js

@@ -114,14 +114,10 @@ async function toBlob(input) {
     const mimeType = detectMimeType(uint8);
     return new Blob([input], { type: mimeType });
   }
-  if (input instanceof Uint8Array) {
-    const mimeType = detectMimeType(input);
-    return new Blob([input], { type: mimeType });
-  }
-  if (isNode && Buffer.isBuffer(input)) {
-    const uint8 = new Uint8Array(input);
-    const mimeType = detectMimeType(uint8);
-    return new Blob([input], { type: mimeType });
+  if (input instanceof Uint8Array || isNode && Buffer.isBuffer(input)) {
+    const bytes = Uint8Array.from(input);
+    const mimeType = detectMimeType(bytes);
+    return new Blob([bytes], { type: mimeType });
   }
   if (typeof input === "string") {
     if (!isNode) {
@@ -191,6 +187,9 @@ var Poof = class {
    *   size: 'medium'
    * });
    *
+   * // Exact 500x500 output, subject cropped and centred, never stretched
+   * const result = await poof.removeBackground(file, { crop: true, width: 500, height: 500 });
+   *
    * // Node.js: from file path
    * const result = await poof.removeBackground('/path/to/image.png');
    *
@@ -209,6 +208,10 @@ var Poof = class {
     if (options.bgColor) formData.append("bg_color", options.bgColor);
     if (options.size) formData.append("size", options.size);
     if (options.crop !== void 0) formData.append("crop", String(options.crop));
+    if (options.padding) formData.append("padding", options.padding);
+    if (options.width !== void 0) formData.append("width", String(options.width));
+    if (options.height !== void 0) formData.append("height", String(options.height));
+    if (options.fit) formData.append("fit", options.fit);
     const response = await this.fetch(`${this.baseUrl}/remove`, {
       method: "POST",
       body: formData
@@ -217,6 +220,8 @@ var Poof = class {
       await this.handleError(response);
     }
     const data = await response.arrayBuffer();
+    const matteConfidence = response.headers.get("X-Matte-Confidence");
+    const matteAmbiguousRatio = response.headers.get("X-Matte-Ambiguous-Ratio");
     return {
       data,
       metadata: {
@@ -224,7 +229,9 @@ var Poof = class {
         processingTimeMs: parseInt(response.headers.get("X-Processing-Time-Ms") || "0", 10),
         width: parseInt(response.headers.get("X-Image-Width") || "0", 10),
         height: parseInt(response.headers.get("X-Image-Height") || "0", 10),
-        contentType: response.headers.get("Content-Type") || "image/png"
+        contentType: response.headers.get("Content-Type") || "image/png",
+        matteConfidence: matteConfidence !== null ? parseFloat(matteConfidence) : void 0,
+        matteAmbiguousRatio: matteAmbiguousRatio !== null ? parseFloat(matteAmbiguousRatio) : void 0
       }
     };
   }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ErrorCode, ApiErrorResponse } from './types.js';\n\n/**\n * Base error class for all Poof SDK errors\n */\nexport class PoofError extends Error {\n  /** Machine-readable error code */\n  readonly code: string;\n  /** HTTP status code */\n  readonly status?: number;\n  /** Unique request ID for support */\n  readonly requestId?: string;\n  /** Additional details */\n  readonly details?: string;\n\n  constructor(\n    message: string,\n    code: string,\n    options?: { status?: number; requestId?: string; details?: string }\n  ) {\n    super(message);\n    this.name = 'PoofError';\n    this.code = code;\n    this.status = options?.status;\n    this.requestId = options?.requestId;\n    this.details = options?.details;\n\n    // Maintains proper stack trace for where error was thrown (V8 engines)\n    if ('captureStackTrace' in Error && typeof Error.captureStackTrace === 'function') {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  /** Create error from API response */\n  static fromResponse(response: ApiErrorResponse, status: number): PoofError {\n    const ErrorClass = ERROR_MAP[response.code] || PoofError;\n    return new ErrorClass(response.message, response.code, {\n      status,\n      requestId: response.request_id,\n      details: response.details,\n    });\n  }\n}\n\n/**\n * Thrown when the API key is invalid or missing\n */\nexport class AuthenticationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'AuthenticationError';\n  }\n}\n\n/**\n * Thrown when the account doesn't have permission\n */\nexport class PermissionError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PermissionError';\n  }\n}\n\n/**\n * Thrown when the account has insufficient credits\n */\nexport class PaymentRequiredError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PaymentRequiredError';\n  }\n}\n\n/**\n * Thrown when rate limit is exceeded\n */\nexport class RateLimitError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Thrown when request parameters are invalid\n */\nexport class ValidationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Thrown when a server error occurs\n */\nexport class ServerError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ServerError';\n  }\n}\n\n/** Map error codes to error classes */\nconst ERROR_MAP: Record<ErrorCode, typeof PoofError> = {\n  authentication_error: AuthenticationError,\n  permission_denied: PermissionError,\n  payment_required: PaymentRequiredError,\n  rate_limit_exceeded: RateLimitError,\n  validation_error: ValidationError,\n  missing_image: ValidationError,\n  image_too_large: ValidationError,\n  upstream_error: ServerError,\n  internal_server_error: ServerError,\n};\n","import type { ImageInput } from './types.js';\n\n/** Check if running in Node.js environment */\nexport const isNode = typeof process !== 'undefined' && process.versions?.node;\n\n/** Detect MIME type from buffer */\nfunction detectMimeType(buffer: Uint8Array): string {\n  // Check magic bytes\n  if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {\n    return 'image/png';\n  }\n  if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {\n    return 'image/jpeg';\n  }\n  if (buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46) {\n    // RIFF header, check for WEBP\n    if (buffer[8] === 0x57 && buffer[9] === 0x45 && buffer[10] === 0x42 && buffer[11] === 0x50) {\n      return 'image/webp';\n    }\n  }\n  if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46) {\n    return 'image/gif';\n  }\n  // Default to octet-stream\n  return 'application/octet-stream';\n}\n\n/** Get file extension from MIME type */\nfunction getExtension(mimeType: string): string {\n  const map: Record<string, string> = {\n    'image/png': 'png',\n    'image/jpeg': 'jpg',\n    'image/webp': 'webp',\n    'image/gif': 'gif',\n  };\n  return map[mimeType] || 'bin';\n}\n\n/** Convert various input types to a Blob suitable for FormData */\nexport async function toBlob(input: ImageInput): Promise<Blob> {\n  // Already a Blob or File\n  if (input instanceof Blob) {\n    return input;\n  }\n\n  // ArrayBuffer\n  if (input instanceof ArrayBuffer) {\n    const uint8 = new Uint8Array(input);\n    const mimeType = detectMimeType(uint8);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // Uint8Array\n  if (input instanceof Uint8Array) {\n    const mimeType = detectMimeType(input);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // Node.js Buffer\n  if (isNode && Buffer.isBuffer(input)) {\n    const uint8 = new Uint8Array(input);\n    const mimeType = detectMimeType(uint8);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // String - treat as file path (Node.js only)\n  if (typeof input === 'string') {\n    if (!isNode) {\n      throw new Error('File paths are only supported in Node.js. Use a Blob or File in the browser.');\n    }\n    \n    const fs = await import('node:fs/promises');\n    const path = await import('node:path');\n    \n    const buffer = await fs.readFile(input);\n    const uint8 = new Uint8Array(buffer);\n    const mimeType = detectMimeType(uint8);\n    const ext = path.extname(input).toLowerCase().slice(1);\n    \n    // Use file extension for mime type if available\n    const mimeFromExt: Record<string, string> = {\n      png: 'image/png',\n      jpg: 'image/jpeg',\n      jpeg: 'image/jpeg',\n      webp: 'image/webp',\n      gif: 'image/gif',\n    };\n    \n    const finalMimeType = mimeFromExt[ext] || mimeType;\n    return new Blob([buffer], { type: finalMimeType });\n  }\n\n  throw new Error(`Unsupported input type: ${typeof input}`);\n}\n\n/** Get filename for FormData */\nexport function getFilename(input: ImageInput, mimeType: string): string {\n  // File has a name\n  if (typeof File !== 'undefined' && input instanceof File) {\n    return input.name;\n  }\n\n  // String path\n  if (typeof input === 'string' && isNode) {\n    // Extract filename from path\n    const parts = input.split(/[/\\\\]/);\n    return parts[parts.length - 1] || `image.${getExtension(mimeType)}`;\n  }\n\n  // Generate name from mime type\n  return `image.${getExtension(mimeType)}`;\n}\n","import type {\n  PoofOptions,\n  ImageInput,\n  RemoveBackgroundOptions,\n  RemoveBackgroundResult,\n  AccountInfo,\n  ApiErrorResponse,\n} from './types.js';\nimport { PoofError } from './errors.js';\nimport { toBlob, getFilename } from './utils.js';\n\nconst DEFAULT_BASE_URL = 'https://api.poof.bg/v1';\nconst DEFAULT_TIMEOUT = 60000;\n\n/**\n * Poof API client for background removal\n *\n * @example\n * ```typescript\n * import { Poof } from '@poof-bg/js';\n *\n * const poof = new Poof({ apiKey: 'your-api-key' });\n * const result = await poof.removeBackground(imageFile);\n * ```\n */\nexport class Poof {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: PoofOptions) {\n    if (!options.apiKey) {\n      throw new Error('API key is required');\n    }\n\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl?.replace(/\\/$/, '') || DEFAULT_BASE_URL;\n    this.timeout = options.timeout || DEFAULT_TIMEOUT;\n  }\n\n  /**\n   * Remove background from an image\n   *\n   * @param input - Image input: File, Blob, Buffer, ArrayBuffer, Uint8Array, or file path (Node.js)\n   * @param options - Processing options\n   * @returns Processed image data and metadata\n   *\n   * @example\n   * ```typescript\n   * // Basic usage\n   * const result = await poof.removeBackground(file);\n   * const imageBlob = new Blob([result.data], { type: result.metadata.contentType });\n   *\n   * // With options\n   * const result = await poof.removeBackground(file, {\n   *   format: 'webp',\n   *   crop: true,\n   *   size: 'medium'\n   * });\n   *\n   * // Node.js: from file path\n   * const result = await poof.removeBackground('/path/to/image.png');\n   *\n   * // Node.js: save to file\n   * const fs = require('fs');\n   * fs.writeFileSync('output.png', Buffer.from(result.data));\n   * ```\n   */\n  async removeBackground(\n    input: ImageInput,\n    options: RemoveBackgroundOptions = {}\n  ): Promise<RemoveBackgroundResult> {\n    const blob = await toBlob(input);\n    const filename = getFilename(input, blob.type);\n\n    const formData = new FormData();\n    formData.append('image_file', blob, filename);\n\n    // Add optional parameters\n    if (options.format) formData.append('format', options.format);\n    if (options.channels) formData.append('channels', options.channels);\n    if (options.bgColor) formData.append('bg_color', options.bgColor);\n    if (options.size) formData.append('size', options.size);\n    if (options.crop !== undefined) formData.append('crop', String(options.crop));\n\n    const response = await this.fetch(`${this.baseUrl}/remove`, {\n      method: 'POST',\n      body: formData,\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    const data = await response.arrayBuffer();\n\n    return {\n      data,\n      metadata: {\n        requestId: response.headers.get('X-Request-ID') || '',\n        processingTimeMs: parseInt(response.headers.get('X-Processing-Time-Ms') || '0', 10),\n        width: parseInt(response.headers.get('X-Image-Width') || '0', 10),\n        height: parseInt(response.headers.get('X-Image-Height') || '0', 10),\n        contentType: response.headers.get('Content-Type') || 'image/png',\n      },\n    };\n  }\n\n  /**\n   * Get account information\n   *\n   * @returns Account info including plan and credit usage\n   *\n   * @example\n   * ```typescript\n   * const account = await poof.me();\n   * console.log(`Plan: ${account.plan}`);\n   * console.log(`Credits: ${account.usedCredits}/${account.maxCredits}`);\n   * ```\n   */\n  async me(): Promise<AccountInfo> {\n    const response = await this.fetch(`${this.baseUrl}/me`, {\n      method: 'GET',\n      headers: {\n        Accept: 'application/json',\n      },\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json();\n  }\n\n  /** Make a fetch request with auth and timeout */\n  private async fetch(url: string, init: RequestInit): Promise<Response> {\n    const headers = new Headers(init.headers);\n    headers.set('x-api-key', this.apiKey);\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers,\n        signal: controller.signal,\n      });\n      return response;\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new PoofError('Request timeout', 'timeout', { status: 408 });\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /** Handle error response */\n  private async handleError(response: Response): Promise<never> {\n    let errorData: ApiErrorResponse;\n\n    try {\n      errorData = await response.json();\n    } catch {\n      throw new PoofError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        'unknown_error',\n        { status: response.status }\n      );\n    }\n\n    throw PoofError.fromResponse(errorData, response.status);\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/client.ts"],"names":[],"mappings":";AAKO,IAAM,SAAA,GAAN,MAAM,UAAA,SAAkB,KAAA,CAAM;AAAA;AAAA,EAE1B,IAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA,EAEA,SAAA;AAAA;AAAA,EAEA,OAAA;AAAA,EAET,WAAA,CACE,OAAA,EACA,IAAA,EACA,OAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,WAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,SAAS,OAAA,EAAS,MAAA;AACvB,IAAA,IAAA,CAAK,YAAY,OAAA,EAAS,SAAA;AAC1B,IAAA,IAAA,CAAK,UAAU,OAAA,EAAS,OAAA;AAGxB,IAAA,IAAI,mBAAA,IAAuB,KAAA,IAAS,OAAO,KAAA,CAAM,sBAAsB,UAAA,EAAY;AACjF,MAAA,KAAA,CAAM,iBAAA,CAAkB,IAAA,EAAM,IAAA,CAAK,WAAW,CAAA;AAAA,IAChD;AAAA,EACF;AAAA;AAAA,EAGA,OAAO,YAAA,CAAa,QAAA,EAA4B,MAAA,EAA2B;AACzE,IAAA,MAAM,UAAA,GAAa,SAAA,CAAU,QAAA,CAAS,IAAI,CAAA,IAAK,UAAA;AAC/C,IAAA,OAAO,IAAI,UAAA,CAAW,QAAA,CAAS,OAAA,EAAS,SAAS,IAAA,EAAM;AAAA,MACrD,MAAA;AAAA,MACA,WAAW,QAAA,CAAS,UAAA;AAAA,MACpB,SAAS,QAAA,CAAS;AAAA,KACnB,CAAA;AAAA,EACH;AACF;AAKO,IAAM,mBAAA,GAAN,cAAkC,SAAA,CAAU;AAAA,EACjD,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AAAA,EACd;AACF;AAKO,IAAM,eAAA,GAAN,cAA8B,SAAA,CAAU;AAAA,EAC7C,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAKO,IAAM,oBAAA,GAAN,cAAmC,SAAA,CAAU;AAAA,EAClD,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AAAA,EACd;AACF;AAKO,IAAM,cAAA,GAAN,cAA6B,SAAA,CAAU;AAAA,EAC5C,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AAAA,EACd;AACF;AAKO,IAAM,eAAA,GAAN,cAA8B,SAAA,CAAU;AAAA,EAC7C,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAKO,IAAM,WAAA,GAAN,cAA0B,SAAA,CAAU;AAAA,EACzC,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAc,OAAA,EAAqE;AAC9G,IAAA,KAAA,CAAM,OAAA,EAAS,MAAM,OAAO,CAAA;AAC5B,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AAAA,EACd;AACF;AAGA,IAAM,SAAA,GAAiD;AAAA,EACrD,oBAAA,EAAsB,mBAAA;AAAA,EACtB,iBAAA,EAAmB,eAAA;AAAA,EACnB,gBAAA,EAAkB,oBAAA;AAAA,EAClB,mBAAA,EAAqB,cAAA;AAAA,EACrB,gBAAA,EAAkB,eAAA;AAAA,EAClB,aAAA,EAAe,eAAA;AAAA,EACf,eAAA,EAAiB,eAAA;AAAA,EACjB,cAAA,EAAgB,WAAA;AAAA,EAChB,qBAAA,EAAuB;AACzB,CAAA;;;AChHO,IAAM,MAAA,GAAS,OAAO,OAAA,KAAY,WAAA,IAAe,QAAQ,QAAA,EAAU,IAAA;AAG1E,SAAS,eAAe,MAAA,EAA4B;AAElD,EAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,GAAA,IAAQ,OAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,MAAM,EAAA,EAAM;AACxF,IAAA,OAAO,WAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,GAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,GAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,GAAA,EAAM;AAClE,IAAA,OAAO,YAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,OAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,MAAM,EAAA,EAAM;AAExF,IAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,OAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,EAAE,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,EAAE,MAAM,EAAA,EAAM;AAC1F,MAAA,OAAO,YAAA;AAAA,IACT;AAAA,EACF;AACA,EAAA,IAAI,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,IAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,EAAA,EAAM;AAClE,IAAA,OAAO,WAAA;AAAA,EACT;AAEA,EAAA,OAAO,0BAAA;AACT;AAGA,SAAS,aAAa,QAAA,EAA0B;AAC9C,EAAA,MAAM,GAAA,GAA8B;AAAA,IAClC,WAAA,EAAa,KAAA;AAAA,IACb,YAAA,EAAc,KAAA;AAAA,IACd,YAAA,EAAc,MAAA;AAAA,IACd,WAAA,EAAa;AAAA,GACf;AACA,EAAA,OAAO,GAAA,CAAI,QAAQ,CAAA,IAAK,KAAA;AAC1B;AAGA,eAAsB,OAAO,KAAA,EAAkC;AAE7D,EAAA,IAAI,iBAAiB,IAAA,EAAM;AACzB,IAAA,OAAO,KAAA;AAAA,EACT;AAGA,EAAA,IAAI,iBAAiB,WAAA,EAAa;AAChC,IAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,KAAK,CAAA;AAClC,IAAA,MAAM,QAAA,GAAW,eAAe,KAAK,CAAA;AACrC,IAAA,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,IAAA,EAAM,UAAU,CAAA;AAAA,EAC7C;AAIA,EAAA,IAAI,iBAAiB,UAAA,IAAe,MAAA,IAAU,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,EAAI;AACrE,IAAA,MAAM,KAAA,GAAQ,UAAA,CAAW,IAAA,CAAK,KAAK,CAAA;AACnC,IAAA,MAAM,QAAA,GAAW,eAAe,KAAK,CAAA;AACrC,IAAA,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,IAAA,EAAM,UAAU,CAAA;AAAA,EAC7C;AAGA,EAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,8EAA8E,CAAA;AAAA,IAChG;AAEA,IAAA,MAAM,EAAA,GAAK,MAAM,OAAO,aAAkB,CAAA;AAC1C,IAAA,MAAM,IAAA,GAAO,MAAM,OAAO,MAAW,CAAA;AAErC,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,QAAA,CAAS,KAAK,CAAA;AACtC,IAAA,MAAM,KAAA,GAAQ,IAAI,UAAA,CAAW,MAAM,CAAA;AACnC,IAAA,MAAM,QAAA,GAAW,eAAe,KAAK,CAAA;AACrC,IAAA,MAAM,GAAA,GAAM,KAAK,OAAA,CAAQ,KAAK,EAAE,WAAA,EAAY,CAAE,MAAM,CAAC,CAAA;AAGrD,IAAA,MAAM,WAAA,GAAsC;AAAA,MAC1C,GAAA,EAAK,WAAA;AAAA,MACL,GAAA,EAAK,YAAA;AAAA,MACL,IAAA,EAAM,YAAA;AAAA,MACN,IAAA,EAAM,YAAA;AAAA,MACN,GAAA,EAAK;AAAA,KACP;AAEA,IAAA,MAAM,aAAA,GAAgB,WAAA,CAAY,GAAG,CAAA,IAAK,QAAA;AAC1C,IAAA,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,IAAA,EAAM,eAAe,CAAA;AAAA,EACnD;AAEA,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,wBAAA,EAA2B,OAAO,KAAK,CAAA,CAAE,CAAA;AAC3D;AAGO,SAAS,WAAA,CAAY,OAAmB,QAAA,EAA0B;AAEvE,EAAA,IAAI,OAAO,IAAA,KAAS,WAAA,IAAe,KAAA,YAAiB,IAAA,EAAM;AACxD,IAAA,OAAO,KAAA,CAAM,IAAA;AAAA,EACf;AAGA,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,MAAA,EAAQ;AAEvC,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,OAAO,CAAA;AACjC,IAAA,OAAO,KAAA,CAAM,MAAM,MAAA,GAAS,CAAC,KAAK,CAAA,MAAA,EAAS,YAAA,CAAa,QAAQ,CAAC,CAAA,CAAA;AAAA,EACnE;AAGA,EAAA,OAAO,CAAA,MAAA,EAAS,YAAA,CAAa,QAAQ,CAAC,CAAA,CAAA;AACxC;;;AC/FA,IAAM,gBAAA,GAAmB,wBAAA;AACzB,IAAM,eAAA,GAAkB,GAAA;AAajB,IAAM,OAAN,MAAW;AAAA,EACC,MAAA;AAAA,EACA,OAAA;AAAA,EACA,OAAA;AAAA,EAEjB,YAAY,OAAA,EAAsB;AAChC,IAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,MAAA,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAAA,IACvC;AAEA,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA,EAAS,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA,IAAK,gBAAA;AACtD,IAAA,IAAA,CAAK,OAAA,GAAU,QAAQ,OAAA,IAAW,eAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiCA,MAAM,gBAAA,CACJ,KAAA,EACA,OAAA,GAAmC,EAAC,EACH;AACjC,IAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAAO,KAAK,CAAA;AAC/B,IAAA,MAAM,QAAA,GAAW,WAAA,CAAY,KAAA,EAAO,IAAA,CAAK,IAAI,CAAA;AAE7C,IAAA,MAAM,QAAA,GAAW,IAAI,QAAA,EAAS;AAC9B,IAAA,QAAA,CAAS,MAAA,CAAO,YAAA,EAAc,IAAA,EAAM,QAAQ,CAAA;AAG5C,IAAA,IAAI,QAAQ,MAAA,EAAQ,QAAA,CAAS,MAAA,CAAO,QAAA,EAAU,QAAQ,MAAM,CAAA;AAC5D,IAAA,IAAI,QAAQ,QAAA,EAAU,QAAA,CAAS,MAAA,CAAO,UAAA,EAAY,QAAQ,QAAQ,CAAA;AAClE,IAAA,IAAI,QAAQ,OAAA,EAAS,QAAA,CAAS,MAAA,CAAO,UAAA,EAAY,QAAQ,OAAO,CAAA;AAChE,IAAA,IAAI,QAAQ,IAAA,EAAM,QAAA,CAAS,MAAA,CAAO,MAAA,EAAQ,QAAQ,IAAI,CAAA;AACtD,IAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW,QAAA,CAAS,OAAO,MAAA,EAAQ,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAC,CAAA;AAC5E,IAAA,IAAI,QAAQ,OAAA,EAAS,QAAA,CAAS,MAAA,CAAO,SAAA,EAAW,QAAQ,OAAO,CAAA;AAC/D,IAAA,IAAI,OAAA,CAAQ,UAAU,MAAA,EAAW,QAAA,CAAS,OAAO,OAAA,EAAS,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAC,CAAA;AAC/E,IAAA,IAAI,OAAA,CAAQ,WAAW,MAAA,EAAW,QAAA,CAAS,OAAO,QAAA,EAAU,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAC,CAAA;AAClF,IAAA,IAAI,QAAQ,GAAA,EAAK,QAAA,CAAS,MAAA,CAAO,KAAA,EAAO,QAAQ,GAAG,CAAA;AAEnD,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,MAAM,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,OAAA,CAAA,EAAW;AAAA,MAC1D,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM;AAAA,KACP,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,IAAA,CAAK,YAAY,QAAQ,CAAA;AAAA,IACjC;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,WAAA,EAAY;AAExC,IAAA,MAAM,eAAA,GAAkB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,oBAAoB,CAAA;AACjE,IAAA,MAAM,mBAAA,GAAsB,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,yBAAyB,CAAA;AAE1E,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,QAAA,EAAU;AAAA,QACR,SAAA,EAAW,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,EAAA;AAAA,QACnD,gBAAA,EAAkB,SAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,sBAAsB,CAAA,IAAK,KAAK,EAAE,CAAA;AAAA,QAClF,KAAA,EAAO,SAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,eAAe,CAAA,IAAK,KAAK,EAAE,CAAA;AAAA,QAChE,MAAA,EAAQ,SAAS,QAAA,CAAS,OAAA,CAAQ,IAAI,gBAAgB,CAAA,IAAK,KAAK,EAAE,CAAA;AAAA,QAClE,WAAA,EAAa,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,WAAA;AAAA,QACrD,eAAA,EAAiB,eAAA,KAAoB,IAAA,GAAO,UAAA,CAAW,eAAe,CAAA,GAAI,MAAA;AAAA,QAC1E,mBAAA,EAAqB,mBAAA,KAAwB,IAAA,GAAO,UAAA,CAAW,mBAAmB,CAAA,GAAI;AAAA;AACxF,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,EAAA,GAA2B;AAC/B,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,MAAM,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,GAAA,CAAA,EAAO;AAAA,MACtD,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS;AAAA,QACP,MAAA,EAAQ;AAAA;AACV,KACD,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,IAAA,CAAK,YAAY,QAAQ,CAAA;AAAA,IACjC;AAEA,IAAA,OAAO,SAAS,IAAA,EAAK;AAAA,EACvB;AAAA;AAAA,EAGA,MAAc,KAAA,CAAM,GAAA,EAAa,IAAA,EAAsC;AACrE,IAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAQ,IAAA,CAAK,OAAO,CAAA;AACxC,IAAA,OAAA,CAAQ,GAAA,CAAI,WAAA,EAAa,IAAA,CAAK,MAAM,CAAA;AAEpC,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,MAAM,YAAY,UAAA,CAAW,MAAM,WAAW,KAAA,EAAM,EAAG,KAAK,OAAO,CAAA;AAEnE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,GAAG,IAAA;AAAA,QACH,OAAA;AAAA,QACA,QAAQ,UAAA,CAAW;AAAA,OACpB,CAAA;AACD,MAAA,OAAO,QAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,EAAc;AACzD,QAAA,MAAM,IAAI,SAAA,CAAU,iBAAA,EAAmB,WAAW,EAAE,MAAA,EAAQ,KAAK,CAAA;AAAA,MACnE;AACA,MAAA,MAAM,KAAA;AAAA,IACR,CAAA,SAAE;AACA,MAAA,YAAA,CAAa,SAAS,CAAA;AAAA,IACxB;AAAA,EACF;AAAA;AAAA,EAGA,MAAc,YAAY,QAAA,EAAoC;AAC5D,IAAA,IAAI,SAAA;AAEJ,IAAA,IAAI;AACF,MAAA,SAAA,GAAY,MAAM,SAAS,IAAA,EAAK;AAAA,IAClC,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,SAAA;AAAA,QACR,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,CAAA,EAAA,EAAK,SAAS,UAAU,CAAA,CAAA;AAAA,QAC/C,eAAA;AAAA,QACA,EAAE,MAAA,EAAQ,QAAA,CAAS,MAAA;AAAO,OAC5B;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,CAAU,YAAA,CAAa,SAAA,EAAW,QAAA,CAAS,MAAM,CAAA;AAAA,EACzD;AACF","file":"index.js","sourcesContent":["import type { ErrorCode, ApiErrorResponse } from './types.js';\n\n/**\n * Base error class for all Poof SDK errors\n */\nexport class PoofError extends Error {\n  /** Machine-readable error code */\n  readonly code: string;\n  /** HTTP status code */\n  readonly status?: number;\n  /** Unique request ID for support */\n  readonly requestId?: string;\n  /** Additional details */\n  readonly details?: string;\n\n  constructor(\n    message: string,\n    code: string,\n    options?: { status?: number; requestId?: string; details?: string }\n  ) {\n    super(message);\n    this.name = 'PoofError';\n    this.code = code;\n    this.status = options?.status;\n    this.requestId = options?.requestId;\n    this.details = options?.details;\n\n    // Maintains proper stack trace for where error was thrown (V8 engines)\n    if ('captureStackTrace' in Error && typeof Error.captureStackTrace === 'function') {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n\n  /** Create error from API response */\n  static fromResponse(response: ApiErrorResponse, status: number): PoofError {\n    const ErrorClass = ERROR_MAP[response.code] || PoofError;\n    return new ErrorClass(response.message, response.code, {\n      status,\n      requestId: response.request_id,\n      details: response.details,\n    });\n  }\n}\n\n/**\n * Thrown when the API key is invalid or missing\n */\nexport class AuthenticationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'AuthenticationError';\n  }\n}\n\n/**\n * Thrown when the account doesn't have permission\n */\nexport class PermissionError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PermissionError';\n  }\n}\n\n/**\n * Thrown when the account has insufficient credits\n */\nexport class PaymentRequiredError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'PaymentRequiredError';\n  }\n}\n\n/**\n * Thrown when rate limit is exceeded\n */\nexport class RateLimitError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'RateLimitError';\n  }\n}\n\n/**\n * Thrown when request parameters are invalid\n */\nexport class ValidationError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Thrown when a server error occurs\n */\nexport class ServerError extends PoofError {\n  constructor(message: string, code: string, options?: { status?: number; requestId?: string; details?: string }) {\n    super(message, code, options);\n    this.name = 'ServerError';\n  }\n}\n\n/** Map error codes to error classes */\nconst ERROR_MAP: Record<ErrorCode, typeof PoofError> = {\n  authentication_error: AuthenticationError,\n  permission_denied: PermissionError,\n  payment_required: PaymentRequiredError,\n  rate_limit_exceeded: RateLimitError,\n  validation_error: ValidationError,\n  missing_image: ValidationError,\n  image_too_large: ValidationError,\n  upstream_error: ServerError,\n  internal_server_error: ServerError,\n};\n","import type { ImageInput } from './types.js';\n\n/** Check if running in Node.js environment */\nexport const isNode = typeof process !== 'undefined' && process.versions?.node;\n\n/** Detect MIME type from buffer */\nfunction detectMimeType(buffer: Uint8Array): string {\n  // Check magic bytes\n  if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {\n    return 'image/png';\n  }\n  if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {\n    return 'image/jpeg';\n  }\n  if (buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46) {\n    // RIFF header, check for WEBP\n    if (buffer[8] === 0x57 && buffer[9] === 0x45 && buffer[10] === 0x42 && buffer[11] === 0x50) {\n      return 'image/webp';\n    }\n  }\n  if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46) {\n    return 'image/gif';\n  }\n  // Default to octet-stream\n  return 'application/octet-stream';\n}\n\n/** Get file extension from MIME type */\nfunction getExtension(mimeType: string): string {\n  const map: Record<string, string> = {\n    'image/png': 'png',\n    'image/jpeg': 'jpg',\n    'image/webp': 'webp',\n    'image/gif': 'gif',\n  };\n  return map[mimeType] || 'bin';\n}\n\n/** Convert various input types to a Blob suitable for FormData */\nexport async function toBlob(input: ImageInput): Promise<Blob> {\n  // Already a Blob or File\n  if (input instanceof Blob) {\n    return input;\n  }\n\n  // ArrayBuffer\n  if (input instanceof ArrayBuffer) {\n    const uint8 = new Uint8Array(input);\n    const mimeType = detectMimeType(uint8);\n    return new Blob([input], { type: mimeType });\n  }\n\n  // Uint8Array or Node.js Buffer. Copy into a fresh ArrayBuffer-backed view:\n  // a view over a SharedArrayBuffer (or a Buffer pool slice) is not a valid BlobPart.\n  if (input instanceof Uint8Array || (isNode && Buffer.isBuffer(input))) {\n    const bytes = Uint8Array.from(input);\n    const mimeType = detectMimeType(bytes);\n    return new Blob([bytes], { type: mimeType });\n  }\n\n  // String - treat as file path (Node.js only)\n  if (typeof input === 'string') {\n    if (!isNode) {\n      throw new Error('File paths are only supported in Node.js. Use a Blob or File in the browser.');\n    }\n    \n    const fs = await import('node:fs/promises');\n    const path = await import('node:path');\n    \n    const buffer = await fs.readFile(input);\n    const uint8 = new Uint8Array(buffer);\n    const mimeType = detectMimeType(uint8);\n    const ext = path.extname(input).toLowerCase().slice(1);\n    \n    // Use file extension for mime type if available\n    const mimeFromExt: Record<string, string> = {\n      png: 'image/png',\n      jpg: 'image/jpeg',\n      jpeg: 'image/jpeg',\n      webp: 'image/webp',\n      gif: 'image/gif',\n    };\n    \n    const finalMimeType = mimeFromExt[ext] || mimeType;\n    return new Blob([buffer], { type: finalMimeType });\n  }\n\n  throw new Error(`Unsupported input type: ${typeof input}`);\n}\n\n/** Get filename for FormData */\nexport function getFilename(input: ImageInput, mimeType: string): string {\n  // File has a name\n  if (typeof File !== 'undefined' && input instanceof File) {\n    return input.name;\n  }\n\n  // String path\n  if (typeof input === 'string' && isNode) {\n    // Extract filename from path\n    const parts = input.split(/[/\\\\]/);\n    return parts[parts.length - 1] || `image.${getExtension(mimeType)}`;\n  }\n\n  // Generate name from mime type\n  return `image.${getExtension(mimeType)}`;\n}\n","import type {\n  PoofOptions,\n  ImageInput,\n  RemoveBackgroundOptions,\n  RemoveBackgroundResult,\n  AccountInfo,\n  ApiErrorResponse,\n} from './types.js';\nimport { PoofError } from './errors.js';\nimport { toBlob, getFilename } from './utils.js';\n\nconst DEFAULT_BASE_URL = 'https://api.poof.bg/v1';\nconst DEFAULT_TIMEOUT = 60000;\n\n/**\n * Poof API client for background removal\n *\n * @example\n * ```typescript\n * import { Poof } from '@poof-bg/js';\n *\n * const poof = new Poof({ apiKey: 'your-api-key' });\n * const result = await poof.removeBackground(imageFile);\n * ```\n */\nexport class Poof {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: PoofOptions) {\n    if (!options.apiKey) {\n      throw new Error('API key is required');\n    }\n\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl?.replace(/\\/$/, '') || DEFAULT_BASE_URL;\n    this.timeout = options.timeout || DEFAULT_TIMEOUT;\n  }\n\n  /**\n   * Remove background from an image\n   *\n   * @param input - Image input: File, Blob, Buffer, ArrayBuffer, Uint8Array, or file path (Node.js)\n   * @param options - Processing options\n   * @returns Processed image data and metadata\n   *\n   * @example\n   * ```typescript\n   * // Basic usage\n   * const result = await poof.removeBackground(file);\n   * const imageBlob = new Blob([result.data], { type: result.metadata.contentType });\n   *\n   * // With options\n   * const result = await poof.removeBackground(file, {\n   *   format: 'webp',\n   *   crop: true,\n   *   size: 'medium'\n   * });\n   *\n   * // Exact 500x500 output, subject cropped and centred, never stretched\n   * const result = await poof.removeBackground(file, { crop: true, width: 500, height: 500 });\n   *\n   * // Node.js: from file path\n   * const result = await poof.removeBackground('/path/to/image.png');\n   *\n   * // Node.js: save to file\n   * const fs = require('fs');\n   * fs.writeFileSync('output.png', Buffer.from(result.data));\n   * ```\n   */\n  async removeBackground(\n    input: ImageInput,\n    options: RemoveBackgroundOptions = {}\n  ): Promise<RemoveBackgroundResult> {\n    const blob = await toBlob(input);\n    const filename = getFilename(input, blob.type);\n\n    const formData = new FormData();\n    formData.append('image_file', blob, filename);\n\n    // Add optional parameters\n    if (options.format) formData.append('format', options.format);\n    if (options.channels) formData.append('channels', options.channels);\n    if (options.bgColor) formData.append('bg_color', options.bgColor);\n    if (options.size) formData.append('size', options.size);\n    if (options.crop !== undefined) formData.append('crop', String(options.crop));\n    if (options.padding) formData.append('padding', options.padding);\n    if (options.width !== undefined) formData.append('width', String(options.width));\n    if (options.height !== undefined) formData.append('height', String(options.height));\n    if (options.fit) formData.append('fit', options.fit);\n\n    const response = await this.fetch(`${this.baseUrl}/remove`, {\n      method: 'POST',\n      body: formData,\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    const data = await response.arrayBuffer();\n\n    const matteConfidence = response.headers.get('X-Matte-Confidence');\n    const matteAmbiguousRatio = response.headers.get('X-Matte-Ambiguous-Ratio');\n\n    return {\n      data,\n      metadata: {\n        requestId: response.headers.get('X-Request-ID') || '',\n        processingTimeMs: parseInt(response.headers.get('X-Processing-Time-Ms') || '0', 10),\n        width: parseInt(response.headers.get('X-Image-Width') || '0', 10),\n        height: parseInt(response.headers.get('X-Image-Height') || '0', 10),\n        contentType: response.headers.get('Content-Type') || 'image/png',\n        matteConfidence: matteConfidence !== null ? parseFloat(matteConfidence) : undefined,\n        matteAmbiguousRatio: matteAmbiguousRatio !== null ? parseFloat(matteAmbiguousRatio) : undefined,\n      },\n    };\n  }\n\n  /**\n   * Get account information\n   *\n   * @returns Account info including plan and credit usage\n   *\n   * @example\n   * ```typescript\n   * const account = await poof.me();\n   * console.log(`Plan: ${account.plan}`);\n   * console.log(`Credits: ${account.usedCredits}/${account.maxCredits}`);\n   * ```\n   */\n  async me(): Promise<AccountInfo> {\n    const response = await this.fetch(`${this.baseUrl}/me`, {\n      method: 'GET',\n      headers: {\n        Accept: 'application/json',\n      },\n    });\n\n    if (!response.ok) {\n      await this.handleError(response);\n    }\n\n    return response.json();\n  }\n\n  /** Make a fetch request with auth and timeout */\n  private async fetch(url: string, init: RequestInit): Promise<Response> {\n    const headers = new Headers(init.headers);\n    headers.set('x-api-key', this.apiKey);\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...init,\n        headers,\n        signal: controller.signal,\n      });\n      return response;\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new PoofError('Request timeout', 'timeout', { status: 408 });\n      }\n      throw error;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /** Handle error response */\n  private async handleError(response: Response): Promise<never> {\n    let errorData: ApiErrorResponse;\n\n    try {\n      errorData = await response.json();\n    } catch {\n      throw new PoofError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        'unknown_error',\n        { status: response.status }\n      );\n    }\n\n    throw PoofError.fromResponse(errorData, response.status);\n  }\n}\n"]}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@poof-bg/js",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Official Poof SDK for background removal",
   "author": "Poof <support@poof.bg>",
   "license": "MIT",
   "homepage": "https://poof.bg",
   "repository": {
     "type": "git",
-    "url": "https://github.com/poof-bg/js"
+    "url": "git+https://github.com/poof-bg/js.git"
   },
   "bugs": {
     "url": "https://github.com/poof-bg/js/issues"