@xuda.io/ai_module 1.1.5654 → 1.1.5655

package/index.mjs

@@ -594,9 +594,17 @@ const transparent_image_model = function () {
   return _conf?.transparent_image_model || 'img-1';
 };
 
+// UI-210: read the status and the param off whichever shape the error arrives in. The
+// first pass only looked at `err.status` and `err.param`, which is the openai-node
+// BadRequestError shape; the same refusal wrapped by a retry helper or an http client
+// surfaces as `err.response.status` / `err.error.param` and slipped straight past the
+// guard, so the call that was supposed to degrade threw instead. The message test is the
+// backstop for anything that carries neither.
 const _is_transparent_background_rejected = function (err) {
-  if (err?.status !== 400) return false;
-  return err?.param === 'background' || /transparent background is not supported/i.test(err?.message || '');
+  const status = err?.status ?? err?.statusCode ?? err?.response?.status;
+  if (status !== 400) return false;
+  const param = err?.param ?? err?.error?.param ?? err?.response?.data?.error?.param;
+  return param === 'background' || /transparent background is not supported/i.test(err?.message || err?.error?.message || '');
 };
 
 // images.edit asking for a transparent background, degrading to an opaque render if the
@@ -13654,11 +13662,32 @@ const pad_transparent_subject = async function (base64, { canvas = 1024, scale =
   try {
     const input = Buffer.from(base64, 'base64');
 
+    // UI-210: an OPAQUE render must not be padded. edit_image_transparent degrades to an
+    // opaque image whenever the model refuses `background: 'transparent'` (UI-138), and
+    // that render is a full rectangle of artwork with its own backdrop. Compositing it onto
+    // a transparent canvas would leave a hard-edged photo floating in the middle of the
+    // card with see-through margins around it, which looks far worse than the edge-to-edge
+    // framing this exists to fix. The padding only makes sense for a cutout.
+    const meta_in = await sharp(input).metadata();
+    if (!meta_in.hasAlpha) {
+      console.log('[pad_transparent_subject] opaque render, leaving it edge to edge');
+      return base64;
+    }
+    const { data: alpha, info: alpha_info } = await sharp(input).ensureAlpha().extractChannel('alpha').raw().toBuffer({ resolveWithObject: true });
+    let clear = 0;
+    for (let i = 0; i < alpha.length; i++) if (alpha[i] < 8) clear++;
+    // A real cutout leaves a good share of the frame empty. Anything below this is a
+    // near-opaque render with at most a stray soft edge, so treat it as opaque.
+    if (clear / (alpha_info.width * alpha_info.height) < 0.05) {
+      console.log('[pad_transparent_subject] no usable cutout, leaving it edge to edge');
+      return base64;
+    }
+
     let trimmed = input;
     try {
       trimmed = await sharp(input).trim().png().toBuffer();
     } catch (err) {
-      // Nothing to trim (or a fully opaque image): pad the original instead.
+      // Nothing to trim: pad the original instead.
     }
 
     const inner = Math.max(1, Math.round(canvas * scale));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xuda.io/ai_module",
-  "version": "1.1.5654",
+  "version": "1.1.5655",
   "description": "Xuda AI Module",
   "main": "index.mjs",
   "type": "module",