n8n-nodes-supermachine 0.1.0

package/nodes/Supermachine/descriptions/AccountDescription.ts

@@ -0,0 +1,72 @@
+// File 4: nodes/Supermachine/descriptions/AccountDescription.ts
+import type { INodeProperties } from 'n8n-workflow';
+
+export const getAccountOperations: INodeProperties[] = [
+  {
+    displayName: 'Operation',
+    name: 'operation',
+    type: 'options',
+    noDataExpression: true,
+    displayOptions: {
+      show: {
+        resource: ['account'],
+      },
+    },
+    options: [
+      {
+        name: 'Get Profile',
+        value: 'getProfile',
+        description: 'Lấy thông tin tài khoản và credit còn lại',
+        action: 'Get account profile',
+      },
+      {
+        name: 'List Models',
+        value: 'listModels',
+        description: 'Liệt kê tất cả models có sẵn',
+        action: 'List available models',
+      },
+      {
+        name: 'Get Model Categories',
+        value: 'listModelCategories',
+        description: 'Lấy danh mục models',
+        action: 'List model categories',
+      },
+    ],
+    default: 'getProfile',
+  },
+];
+
+export const getAccountFields: INodeProperties[] = [
+  // Get Profile - không cần fields
+  {
+    displayName: 'Return All',
+    name: 'returnAll',
+    type: 'boolean',
+    displayOptions: {
+      show: {
+        resource: ['account'],
+        operation: ['listModels', 'listModelCategories'],
+      },
+    },
+    default: false,
+    description: 'Trả về tất cả kết quả hay chỉ giới hạn',
+  },
+  {
+    displayName: 'Limit',
+    name: 'limit',
+    type: 'number',
+    typeOptions: {
+      minValue: 1,
+      maxValue: 100,
+    },
+    displayOptions: {
+      show: {
+        resource: ['account'],
+        operation: ['listModels', 'listModelCategories'],
+        returnAll: [false],
+      },
+    },
+    default: 20,
+    description: 'Số lượng items trả về mỗi trang',
+  },
+];

package/nodes/Supermachine/descriptions/ImageDescription.ts

@@ -0,0 +1,355 @@
+import { INodeProperties } from 'n8n-workflow';
+
+export const getImageOperations: INodeProperties[] = [
+  {
+    displayName: 'Operation',
+    name: 'operation',
+    type: 'options',
+    noDataExpression: true,
+    displayOptions: {
+      show: {
+        resource: ['image'],
+      },
+    },
+    options: [
+      {
+        name: 'Generate an Image',
+        value: 'generate',
+        description: 'Tạo ảnh mới từ text prompt',
+        action: 'Generate an image',
+      },
+      {
+        name: 'Get Image Job Status',
+        value: 'getStatus',
+        description: 'Lấy status và kết quả job theo batchId',
+        action: 'Get image job status',
+      },
+      {
+        name: 'List Generated Images',
+        value: 'listImages',
+        description: 'Liệt kê tất cả ảnh theo batchId',
+        action: 'List generated images',
+      },
+    ],
+    default: 'generate',
+  },
+];
+
+export const getImageFields: INodeProperties[] = [
+  // ═══════════════════════════════════════════════════════════
+  // GENERATE OPERATION
+  // ═══════════════════════════════════════════════════════════
+  {
+    displayName: 'Model Name or ID',
+    name: 'model',
+    type: 'options',
+    typeOptions: {
+      loadOptionsMethod: 'getModels',
+    },
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['generate'],
+      },
+    },
+    default: '',
+    description:
+      'Model AI dùng để generate ảnh. Chọn từ danh sách. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+    required: true,
+  },
+  {
+    displayName: 'Prompt',
+    name: 'prompt',
+    type: 'string',
+    typeOptions: {
+      rows: 4,
+    },
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['generate'],
+      },
+    },
+    default: '',
+    placeholder: 'A beautiful sunset over mountains, photorealistic, 8k',
+    description: 'Mô tả ảnh muốn tạo (bằng tiếng Anh cho kết quả tốt nhất)',
+    required: true,
+  },
+  {
+    displayName: 'Width',
+    name: 'width',
+    type: 'number',
+    typeOptions: {
+      minValue: 256,
+      maxValue: 2048,
+    },
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['generate'],
+      },
+    },
+    default: 1024,
+    description: 'Chiều rộng ảnh tính bằng pixels (256-2048)',
+  },
+  {
+    displayName: 'Height',
+    name: 'height',
+    type: 'number',
+    typeOptions: {
+      minValue: 256,
+      maxValue: 2048,
+    },
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['generate'],
+      },
+    },
+    default: 768,
+    description: 'Chiều cao ảnh tính bằng pixels (256-2048)',
+  },
+  {
+    displayName: 'Additional Fields',
+    name: 'additionalFields',
+    type: 'collection',
+    placeholder: 'Add Field',
+    default: {},
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['generate'],
+      },
+    },
+    options: [
+      {
+        displayName: 'Negative Prompt',
+        name: 'negativePrompt',
+        type: 'string',
+        typeOptions: { rows: 2 },
+        default: '',
+        placeholder: 'blurry, low quality, distorted',
+        description: 'Những gì KHÔNG muốn xuất hiện trong ảnh',
+      },
+      {
+        displayName: 'Number of Results',
+        name: 'numberResults',
+        type: 'number',
+        typeOptions: { minValue: 1, maxValue: 4 },
+        default: 1,
+        description: 'Số ảnh tạo cùng lúc (1-4). Mỗi ảnh tốn 1 credit.',
+      },
+      {
+        displayName: 'Output Format',
+        name: 'outputFormat',
+        type: 'options',
+        options: [
+          { name: 'PNG', value: 'PNG' },
+          { name: 'WEBP', value: 'WEBP' },
+          { name: 'JPEG', value: 'JPEG' },
+        ],
+        default: 'PNG',
+        description: 'Định dạng file ảnh đầu ra',
+      },
+      {
+        displayName: 'Seed',
+        name: 'seed',
+        type: 'number',
+        typeOptions: { minValue: 0, maxValue: 2147483647 },
+        default: 0,
+        description: 'Seed cố định để tái tạo kết quả giống nhau (0 = random)',
+      },
+      {
+        displayName: 'Steps',
+        name: 'steps',
+        type: 'number',
+        typeOptions: { minValue: 1, maxValue: 80 },
+        default: 30,
+        description: 'Số bước inference. Nhiều hơn = chất lượng cao hơn nhưng chậm hơn (20-50 recommended).',
+      },
+      {
+        displayName: 'CFG Scale',
+        name: 'cfgScale',
+        type: 'number',
+        typeOptions: { 
+          minValue: 1, 
+          maxValue: 20,
+          numberPrecision: 1,
+        },
+        default: 7,
+        description: 'Độ tuân thủ prompt. Cao hơn = tuân thủ strict hơn (7-9 recommended).',
+      },
+      {
+        displayName: 'LoRAs',
+        name: 'loras',
+        type: 'fixedCollection',
+        typeOptions: {
+          multipleValues: true,
+        },
+        default: {},
+        description: 'Thêm LoRA để điều chỉnh style. ⚠️ Phải chọn Model trước!',
+        options: [
+          {
+            name: 'loraValues',
+            displayName: 'LoRA',
+            values: [
+              {
+                displayName: 'LoRA Name or ID',
+                name: 'loraId',
+                type: 'options',
+                typeOptions: {
+                  loadOptionsMethod: 'getLoras',
+                  loadOptionsDependsOn: ['model'],
+                },
+                default: '',
+                description: 'Chọn LoRA. Dropdown sẽ load sau khi chọn Model. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+              },
+              {
+                displayName: 'Strength',
+                name: 'strength',
+                type: 'number',
+                typeOptions: { 
+                  minValue: 0, 
+                  maxValue: 2,
+                  numberPrecision: 1,
+                },
+                default: 1,
+                description: 'Độ mạnh của LoRA (0-2). Default: 1.0',
+              },
+            ],
+          },
+        ],
+      },
+      {
+        displayName: 'Character Category',
+        name: 'characterCategory',
+        type: 'options',
+        typeOptions: {
+          loadOptionsMethod: 'getCharacterCategories',
+        },
+        default: '',
+        description: 'Chọn category để filter characters (Female, Male, Young Adult, Middle Aged). Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+      },
+      {
+        displayName: 'Character',
+        name: 'characterId',
+        type: 'options',
+        typeOptions: {
+          loadOptionsMethod: 'getCharacters',
+          loadOptionsDependsOn: ['model', 'characterCategory'],
+        },
+        displayOptions: {
+          show: {
+            characterCategory: ['3', '4', '5', '6'],
+          },
+        },
+        default: '',
+        description: 'Chọn character. ⚠️ Phải chọn Model và Category trước! Embed code sẽ hiện trong description. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+      },
+      {
+        displayName: 'Image to Image',
+        name: 'img2img',
+        type: 'fixedCollection',
+        default: {},
+        description: 'Dùng ảnh có sẵn làm base để generate',
+        options: [
+          {
+            name: 'img2imgValues',
+            displayName: 'Image to Image Settings',
+            values: [
+              {
+                displayName: 'Source Image URL',
+                name: 'sourceImageUrl',
+                type: 'string',
+                default: '',
+                placeholder: 'https://example.com/image.png',
+                description: 'URL của ảnh gốc dùng làm base',
+              },
+              {
+                displayName: 'Denoising Strength',
+                name: 'denoisingStrength',
+                type: 'number',
+                typeOptions: { 
+                  minValue: 0, 
+                  maxValue: 1,
+                  numberPrecision: 2,
+                },
+                default: 0.75,
+                description: 'Mức độ thay đổi so với ảnh gốc (0=giữ nguyên, 1=thay đổi hoàn toàn)',
+              },
+            ],
+          },
+        ],
+      },
+      {
+        displayName: 'Callback URL',
+        name: 'callbackUrl',
+        type: 'string',
+        default: '',
+        placeholder: 'https://your-n8n.com/webhook/supermachine-callback',
+        description: 'Webhook URL để nhận kết quả async. Copy URL từ Supermachine Trigger node.',
+      },
+    ],
+  },
+
+  // ═══════════════════════════════════════════════════════════
+  // GET STATUS & LIST IMAGES OPERATIONS
+  // ═══════════════════════════════════════════════════════════
+  {
+    displayName: 'Batch ID',
+    name: 'batchId',
+    type: 'string',
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['getStatus', 'listImages'],
+      },
+    },
+    default: '',
+    placeholder: '1994761',
+    description: 'batchId nhận được từ Generate operation response',
+    required: true,
+  },
+  {
+    displayName: 'Return All',
+    name: 'returnAll',
+    type: 'boolean',
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['listImages'],
+      },
+    },
+    default: false,
+    description: 'Whether to return all results or only up to a given limit',
+  },
+  {
+    displayName: 'Limit',
+    name: 'limit',
+    type: 'number',
+    typeOptions: { minValue: 1, maxValue: 100 },
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['listImages'],
+        returnAll: [false],
+      },
+    },
+    default: 20,
+    description: 'Max number of results to return',
+  },
+  {
+    displayName: 'Page',
+    name: 'page',
+    type: 'number',
+    typeOptions: { minValue: 1 },
+    displayOptions: {
+      show: {
+        resource: ['image'],
+        operation: ['listImages'],
+      },
+    },
+    default: 1,
+    description: 'Số trang để fetch (bắt đầu từ 1)',
+  },
+];

package/nodes/Supermachine/descriptions/ToolsDescription.ts

@@ -0,0 +1,241 @@
+import { INodeProperties } from 'n8n-workflow';
+
+export const getToolsOperations: INodeProperties[] = [
+  {
+    displayName: 'Operation',
+    name: 'operation',
+    type: 'options',
+    noDataExpression: true,
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+      },
+    },
+    options: [
+      {
+        name: 'Instruct Edit an Image',
+        value: 'instructEdit',
+        description: 'Chỉnh sửa ảnh theo text instruction',
+        action: 'Instruct edit an image',
+      },
+      {
+        name: 'Upscale an Image',
+        value: 'upscale',
+        description: 'Tăng độ phân giải ảnh',
+        action: 'Upscale an image',
+      },
+      {
+        name: 'Face Swap an Image',
+        value: 'faceSwap',
+        description: 'Hoán đổi khuôn mặt trong ảnh',
+        action: 'Face swap an image',
+      },
+    ],
+    default: 'instructEdit',
+  },
+];
+
+export const getToolsFields: INodeProperties[] = [
+  // ─── INSTRUCT EDIT ───────────────────────────────────────
+  {
+    displayName: 'Input Image URL',
+    name: 'inputImageUrl',
+    type: 'string',
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['instructEdit'],
+      },
+    },
+    default: '',
+    placeholder: 'https://riku-assets.com/generations/xxx.png',
+    description: 'URL ảnh gốc muốn chỉnh sửa (từ List Images hoặc URL ngoài)',
+    required: true,
+  },
+  {
+    displayName: 'Edit Instruction',
+    name: 'editPrompt',
+    type: 'string',
+    typeOptions: { rows: 3 },
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['instructEdit'],
+      },
+    },
+    default: '',
+    placeholder: 'Add a red hat to the person, keep the background the same',
+    description: 'Mô tả thay đổi muốn áp dụng lên ảnh',
+    required: true,
+  },
+  {
+    displayName: 'Additional Fields',
+    name: 'additionalFields',
+    type: 'collection',
+    placeholder: 'Add Field',
+    default: {},
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['instructEdit'],
+      },
+    },
+    options: [
+      {
+        displayName: 'Model Name or ID',
+        name: 'model',
+        type: 'options',
+        typeOptions: {
+          loadOptionsMethod: 'getModels',
+        },
+        default: '',
+        description: 'Model AI dùng để edit ảnh',
+      },
+      {
+        displayName: 'Steps',
+        name: 'steps',
+        type: 'number',
+        typeOptions: { minValue: 1, maxValue: 50 },
+        default: 20,
+        description: 'Số bước inference',
+      },
+      {
+        displayName: 'CFG Scale',
+        name: 'cfgScale',
+        type: 'number',
+        typeOptions: { minValue: 1, maxValue: 10 },
+        default: 7,
+        description: 'Độ tuân thủ instruction',
+      },
+      {
+        displayName: 'Callback URL',
+        name: 'callbackUrl',
+        type: 'string',
+        default: '',
+        placeholder: 'https://your-n8n.com/webhook/supermachine-callback',
+        description: 'Webhook URL nhận kết quả async',
+      },
+    ],
+  },
+
+  // ─── UPSCALE ─────────────────────────────────────────────
+  {
+    displayName: 'Input Image URL',
+    name: 'inputImageUrl',
+    type: 'string',
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['upscale'],
+      },
+    },
+    default: '',
+    placeholder: 'https://riku-assets.com/generations/xxx.png',
+    description: 'URL ảnh muốn upscale',
+    required: true,
+  },
+  {
+    displayName: 'Upscale Factor',
+    name: 'upscaleFactor',
+    type: 'options',
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['upscale'],
+      },
+    },
+    options: [
+      { name: '2x', value: 2 },
+      { name: '4x', value: 4 },
+      { name: '8x', value: 8 },
+    ],
+    default: 2,
+    description: 'Tăng kích thước ảnh bao nhiêu lần',
+  },
+  {
+    displayName: 'Additional Fields',
+    name: 'additionalFields',
+    type: 'collection',
+    placeholder: 'Add Field',
+    default: {},
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['upscale'],
+      },
+    },
+    options: [
+      {
+        displayName: 'Callback URL',
+        name: 'callbackUrl',
+        type: 'string',
+        default: '',
+        placeholder: 'https://your-n8n.com/webhook/supermachine-callback',
+        description: 'Webhook URL nhận kết quả async',
+      },
+    ],
+  },
+
+  // ─── FACE SWAP ───────────────────────────────────────────
+  {
+    displayName: 'Target Image URL',
+    name: 'inputImageUrl',
+    type: 'string',
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['faceSwap'],
+      },
+    },
+    default: '',
+    placeholder: 'https://riku-assets.com/generations/xxx.png',
+    description: 'URL ảnh đích (ảnh sẽ được swap khuôn mặt vào)',
+    required: true,
+  },
+  {
+    displayName: 'Face Image URL',
+    name: 'faceImageUrl',
+    type: 'string',
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['faceSwap'],
+      },
+    },
+    default: '',
+    placeholder: 'https://example.com/face.png',
+    description: 'URL ảnh khuôn mặt nguồn muốn swap vào ảnh đích',
+    required: true,
+  },
+  {
+    displayName: 'Additional Fields',
+    name: 'additionalFields',
+    type: 'collection',
+    placeholder: 'Add Field',
+    default: {},
+    displayOptions: {
+      show: {
+        resource: ['tools'],
+        operation: ['faceSwap'],
+      },
+    },
+    options: [
+      {
+        displayName: 'Strength',
+        name: 'strength',
+        type: 'number',
+        typeOptions: { minValue: 0, maxValue: 1 },
+        default: 0.8,
+        description: 'Độ mạnh face swap (0.0 - 1.0)',
+      },
+      {
+        displayName: 'Callback URL',
+        name: 'callbackUrl',
+        type: 'string',
+        default: '',
+        placeholder: 'https://your-n8n.com/webhook/supermachine-callback',
+        description: 'Webhook URL nhận kết quả async',
+      },
+    ],
+  },
+];

package/nodes/Supermachine/descriptions/index.ts

@@ -0,0 +1,3 @@
+export * from './AccountDescription';
+export * from './ImageDescription';
+export * from './ToolsDescription';

package/nodes/Supermachine/index.ts

@@ -0,0 +1,3 @@
+import { Supermachine } from './Supermachine.node';
+
+export = Supermachine;