n8n-nodes-sudomock 0.5.0 → 0.6.0

package/README.md

@@ -31,11 +31,12 @@ n8n community node for the SudoMock API. Integrate mockup rendering into your n8
 
 - **Render Mockup**: Generate mockups with artwork, personalized text, or both. Text overrides support styled segments, fonts, size, color, stroke color, and overflow, shrink, or clip fitting. Optionally run asynchronously with the **Run Asynchronously** toggle, which returns a `job_id` to track with **Get Job**.
 - **Render Video**: Turn a mockup (or an existing image URL) into a short product video (always asynchronous). Choose a supported duration, optional audio/motion, an optional one-off webhook, and optionally **Wait for Completion** to return the finished clip.
+- **Remove Background**: Isolate the subject of an image onto a transparent background. The cutout remains stored, and the returned signed PNG URL is valid for 7 days. Costs 25 credits, refunded automatically if processing fails. The same cleanup is available inline on both render operations with the per-artwork **Remove Background** toggle.
 
 ### Fonts and Order Artwork
 
 - **Fonts**: List available fonts, fetch one by UUID, upload a custom TTF or OTF from a public URL, and delete your custom fonts
-- **Order Artwork**: Store customer artwork and previews for fulfillment, then delete them by URL or mockup UUID when needed
+- **Artwork: Delete Stored Files**: Delete stored order artwork by URL or mockup UUID
 
 ### Async Jobs
 
@@ -238,6 +239,7 @@ Generate a mockup by filling smart objects with your designs.
   - Fit Mode: `fill`, `contain`, or `cover` (recommended)
   - **Additional Options** (optional):
     - Rotation: -360 to 360 degrees
+    - Remove Background: clean the artwork before placing it (adds 25 credits per artwork)
     - Color Overlay: Hex color code
     - Color Blend Mode: Various blend modes
     - Brightness: -150 to 150
@@ -284,6 +286,38 @@ Export Options:
 
 ---
 
+### Remove Background
+
+Isolate the subject of an image onto a transparent background. The cutout remains stored, and the returned signed PNG URL is valid for 7 days.
+
+**Parameters:**
+
+- **Image URL** (required): public URL of the image to process
+
+**Example:**
+
+```
+Image URL: https://cdn.example.com/product-photo.jpg
+```
+
+**Output:**
+
+```json
+{
+  "success": true,
+  "data": {
+    "url": "https://cdn.sudomock.com/bg-cutouts/abc123.png",
+    "width": 2000,
+    "height": 2000,
+    "credits_charged": 25
+  }
+}
+```
+
+The returned signed URL is valid for 7 days and can be fed straight into **Render Mockup** or **2D: Render Mockup** as artwork during that window. The cutout remains stored. Processing costs 25 credits per image and is refunded automatically if it fails. To clean artwork as part of a render instead, use the per-artwork **Remove Background** toggle on either render operation.
+
+---
+
 ### Delete Mockup
 
 Delete a specific mockup template.
@@ -311,7 +345,7 @@ Create, prepare, render, and manage reusable mockups from product images without
 2. **2D: Get Mockup** returns `draft`, `ready`, or `failed` status. Poll this operation until the mockup is `ready`; the ready response includes each print area's UUID and points.
 3. **2D: List Mockups** returns your 2D mockups.
 4. **2D: Set Print Areas** accepts one or more print areas. Each print area is a quad with four `[x, y]` coordinate pairs.
-5. **2D: Render Mockup** accepts the mockup UUID and one or more ready print area UUIDs. Each print area includes either an artwork URL or Base64 artwork, with optional color, adjustments, and placement. Export options support PNG or JPG at 1024, 2048, or 4096 pixels, plus quality and DPI. Each render costs 5 credits and returns `print_files`, where `print_files[0]` is the CDN URL.
+5. **2D: Render Mockup** accepts the mockup UUID and one or more ready print area UUIDs. Each print area includes either an artwork URL or Base64 artwork, with optional background removal (adds 25 credits per artwork), color, adjustments, and placement. Export options support PNG or JPG at 1024, 2048, or 4096 pixels, plus quality and DPI. Each render costs 5 credits and returns `print_files`, where `print_files[0]` is the CDN URL.
 6. **2D: Delete Mockup** deletes the selected 2D mockup.
 
 Create must reach `ready` through **2D: Get Mockup** before **2D: Render Mockup**.

package/dist/nodes/SudoMock/SudoMock.node.js

@@ -117,12 +117,6 @@ class SudoMock {
                         description: 'Delete stored order artwork by URL or mockup UUID',
                         action: 'Delete stored artwork',
                     },
-                    {
-                        name: 'Artwork: Store Files',
-                        value: 'storeArtworks',
-                        description: 'Store customer artwork and an optional preview for order fulfillment',
-                        action: 'Store artwork',
-                    },
                     {
                         name: 'Delete Mockup',
                         value: 'deleteMockup',
@@ -183,6 +177,12 @@ class SudoMock {
                         description: 'List your async render, upload, and video jobs',
                         action: 'List jobs',
                     },
+                    {
+                        name: 'Remove Background',
+                        value: 'removeBackground',
+                        description: 'Remove the background from an image and get a transparent-PNG cutout through a signed URL valid for 7 days. The cutout remains stored. Costs 25 credits; auto-refunded on failure.',
+                        action: 'Remove an image background',
+                    },
                     {
                         name: 'Render Mockup',
                         value: 'render',
@@ -530,6 +530,13 @@ class SudoMock {
                                 default: '',
                                 description: 'Base64 artwork data for this print area',
                             },
+                            {
+                                displayName: 'Remove Background',
+                                name: 'removeBackground',
+                                type: 'boolean',
+                                default: false,
+                                description: 'Whether to remove the artwork background before placing it. Adds 25 credits per artwork.',
+                            },
                             {
                                 displayName: 'Color',
                                 name: 'color',
@@ -965,6 +972,13 @@ class SudoMock {
                                         default: 0,
                                         description: 'Custom position left offset in pixels',
                                     },
+                                    {
+                                        displayName: 'Remove Background',
+                                        name: 'removeBackground',
+                                        type: 'boolean',
+                                        default: false,
+                                        description: 'Whether to remove the artwork background before placing it. Adds 25 credits per artwork.',
+                                    },
                                     {
                                         displayName: 'Color Overlay (Hex)',
                                         name: 'colorHex',
@@ -1564,58 +1578,21 @@ class SudoMock {
                 ],
             },
             // ============================================
-            // ARTWORK PARAMETERS
+            // BACKGROUND REMOVAL PARAMETERS
             // ============================================
             {
-                displayName: 'Mockup UUID',
-                name: 'artworkMockupUuid',
+                displayName: 'Image URL',
+                name: 'removeBackgroundImageUrl',
                 type: 'string',
                 required: true,
-                displayOptions: { show: { operation: ['storeArtworks'] } },
+                displayOptions: { show: { operation: ['removeBackground'] } },
                 default: '',
-                description: 'Mockup UUID the stored artwork belongs to',
-            },
-            {
-                displayName: 'Artwork Items',
-                name: 'artworkItems',
-                type: 'fixedCollection',
-                typeOptions: { multipleValues: true },
-                displayOptions: { show: { operation: ['storeArtworks'] } },
-                default: {},
-                placeholder: 'Add Artwork',
-                description: 'Up to 10 artwork files to keep for order fulfillment',
-                options: [
-                    {
-                        name: 'items',
-                        displayName: 'Artwork',
-                        values: [
-                            {
-                                displayName: 'Smart Object UUID',
-                                name: 'smartObjectUuid',
-                                type: 'string',
-                                required: true,
-                                default: '',
-                            },
-                            {
-                                displayName: 'Base64 Artwork',
-                                name: 'base64',
-                                type: 'string',
-                                required: true,
-                                default: '',
-                                description: 'Raw base64 image bytes without a data URL prefix',
-                            },
-                        ],
-                    },
-                ],
-            },
-            {
-                displayName: 'Preview URL',
-                name: 'artworkPreviewUrl',
-                type: 'string',
-                displayOptions: { show: { operation: ['storeArtworks'] } },
-                default: '',
-                description: 'Optional render URL to keep with the order',
+                placeholder: 'https://cdn.example.com/product-photo.jpg',
+                description: 'Public URL of the image to isolate onto a transparent background',
             },
+            // ============================================
+            // ARTWORK PARAMETERS
+            // ============================================
             {
                 displayName: 'Delete By',
                 name: 'artworkDeleteMode',
@@ -2146,6 +2123,9 @@ class SudoMock {
                         else {
                             printArea.artwork_url = area.artworkUrl;
                         }
+                        if (area.removeBackground) {
+                            printArea.remove_background = true;
+                        }
                         if (area.color) {
                             printArea.color = area.color;
                         }
@@ -2269,30 +2249,15 @@ class SudoMock {
                     });
                 }
                 // ========================================
-                // ARTWORKS
+                // BACKGROUND REMOVAL
                 // ========================================
-                else if (operation === 'storeArtworks') {
-                    const items = this.getNodeParameter('artworkItems.items', i, []);
-                    const previewUrl = this.getNodeParameter('artworkPreviewUrl', i, '');
-                    if (items.length === 0 && !previewUrl) {
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Add at least one artwork item or a preview URL');
-                    }
-                    if (items.length > 10) {
-                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Artwork Items supports up to 10 files');
-                    }
-                    const body = {
-                        mockup_uuid: this.getNodeParameter('artworkMockupUuid', i),
-                        items: items.map((item) => ({
-                            smart_object_uuid: item.smartObjectUuid,
-                            base64: item.base64,
-                        })),
-                    };
-                    if (previewUrl)
-                        body.preview_url = previewUrl;
+                else if (operation === 'removeBackground') {
                     const response = await this.helpers.httpRequestWithAuthentication.call(this, 'sudoMockApi', {
                         method: 'POST',
-                        url: 'https://api.sudomock.com/api/v1/artworks',
-                        body,
+                        url: 'https://api.sudomock.com/api/v1/remove-background',
+                        body: {
+                            url: this.getNodeParameter('removeBackgroundImageUrl', i),
+                        },
                         json: true,
                     });
                     returnData.push({
@@ -2300,6 +2265,9 @@ class SudoMock {
                         pairedItem: { item: i },
                     });
                 }
+                // ========================================
+                // ARTWORKS
+                // ========================================
                 else if (operation === 'deleteArtworks') {
                     const mode = this.getNodeParameter('artworkDeleteMode', i);
                     const body = {};
@@ -2356,6 +2324,10 @@ class SudoMock {
                                     asset.content_type = opts.contentType;
                                 }
                             }
+                            // Background removal surcharge, billed per unique artwork source
+                            if (opts.removeBackground) {
+                                asset.remove_background = true;
+                            }
                             // Custom size override
                             const size = {};
                             if (opts.sizeWidth !== undefined && opts.sizeWidth > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-sudomock",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "n8n community node for SudoMock mockup rendering API - POD automation",
   "license": "MIT",
   "homepage": "https://sudomock.com",