n8n-nodes-commercetools 1.0.13 → 1.0.15

package/README.md

@@ -26,7 +26,7 @@ Operations are **auto-generated** from the official commercetools Postman collec
 
 ## Highlights
 
-- Full CRUD coverage for Products, Customers, Carts, Orders, Business Units, Categories, Channels, Associate Roles, Inventory, Reviews, Shopping Lists, Types, Custom Objects, Payments, Payment Methods, Shipping Methods, Zones, Subscriptions, States, Quotes, Quote Requests, Staged Quotes, Messages, API Extensions, Approval Rules, Approval Flows, Associate Endpoints, Standalone Prices, Stores, Product Tailoring, Customer Groups, Product Selections, Cart Discounts, and Discount Codes
+- Full CRUD coverage for Products, Customers, Carts, Orders, Business Units, Categories, Channels, Associate Roles, Inventory, Reviews, Shopping Lists, Types, Custom Objects, Payments, Payment Methods, Shipping Methods, Zones, Subscriptions, States, Quotes, Quote Requests, Staged Quotes, Messages, API Extensions, Approval Rules, Approval Flows, Associate Endpoints, Standalone Prices, Stores, Product Tailoring, Customer Groups, Product Selections, Cart Discounts, Discount Codes, Product Discounts, Product Types, Product Projections, Tax Categories, Attribute Groups, API Clients, Recurring Orders, Recurrence Policies, Discount Groups, and In-Store Endpoints
 - Auto-generated operations from the official Postman collection — always in sync
 - Product image upload: downloads from a URL, posts raw binary to commercetools
 - Product, Order, and Business Unit search with structured query, sort, limit, and offset fields
@@ -96,6 +96,27 @@ Select a **Resource** and **Operation** to interact with the commercetools API.
 | **Product Selection** | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
 | **Cart Discount**     | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
 | **Discount Code**     | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Product Discount**          | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Product Type**              | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Product Projection**        | Get by ID, Get by Key, Query, HEAD checks |
+| **Tax Category**              | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Attribute Group**           | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **API Client**                | Create, Get by ID, Query, Delete, HEAD checks |
+| **Recurring Order**           | Create, Get by ID, Query, Update, Delete, HEAD checks |
+| **Recurrence Policy**         | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Discount Group**            | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Store Business Unit**       | Get by ID, Get by Key, Query, Update, HEAD checks |
+| **Store Cart Discount**       | Get by ID, Get by Key, Query, HEAD checks |
+| **Store Cart**                | Create, Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Store Customer**            | Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Store Order**               | Create, Get by ID, Get by Key, Query, Update, HEAD checks |
+| **Store Quote Request**       | Get by ID, Get by Key, Query, Update, HEAD checks |
+| **Store Quote**               | Get by ID, Get by Key, Query, Update, HEAD checks |
+| **Store Shopping List**       | Get by ID, Get by Key, Query, Update, Delete, HEAD checks |
+| **Store Staged Quote**        | Get by ID, Get by Key, Query, Update, HEAD checks |
+| **Store Product Projection**  | Get by ID, Get by Key, Query, HEAD checks |
+| **Store Shipping Method**     | Get matching methods for Cart, HEAD checks |
+| **Store Product Tailoring**   | Create, Get by Key, Update, Delete, Upload Image, HEAD checks |
 
 #### How field generation works
 
@@ -226,6 +247,10 @@ Listens for real-time commercetools events via webhook subscription. On activati
 
 **Product Selection** — created, deleted, product added/removed/excluded, variant selection/exclusion changed
 
+**Cart Discounts** — no message triggers (change subscriptions only)
+
+**Discount Codes** — no message triggers (change subscriptions only)
+
 #### Subscription routing
 
 Events are routed to the correct commercetools subscription arrays automatically using the generated event registry (produced by `generateCtpRegistry.ts` from the `@commercetools/platform-sdk` type declarations):
@@ -347,7 +372,13 @@ npm run lint:fix
 ```
 scripts/generate.ts                       (entry point: npm run generate)
 │
-├── parseCollection.ts
+├── parseCollection.ts                    (thin orchestrator)
+│     ├── collection/postmanTypes.ts      PostmanItem, PostmanCollection interfaces
+│     ├── collection/types.ts             BodyField, ParsedOperation interfaces
+│     ├── collection/helpers.ts           slugify, formatLabel, isLocalizedObject
+│     ├── collection/fieldExtractors.ts   extractFields, extractActionBodyFields
+│     ├── collection/findFolder.ts        findFolder (module-level cache — PERF-5)
+│     └── collection/walkItems.ts         walkItems (top-level exported function)
 │     Downloads Postman collection.json → ParsedOperation[]
 │     Detects per operation:
 │       isSearch        POST .../search
@@ -359,7 +390,13 @@ scripts/generate.ts                       (entry point: npm run generate)
 │       bodyFields      extracted from Postman body.raw JSON
 │       actionBodyFields fields from inside actions[0]
 │
-├── generateProperties.ts
+├── generateProperties.ts                 (thin orchestrator — PERF-4: Map index built once)
+│     ├── properties/helpers.ts           Constants + shared property builders
+│     ├── properties/resourceAndOperation.ts  Resource + Operation dropdowns
+│     ├── properties/idFields.ts          ID / Key / Container / path param fields
+│     ├── properties/versionAndActions.ts Actions (JSON) + Actions (UI) fixedCollection
+│     ├── properties/bodyFields.ts        Create / Misc-POST / Search body fields
+│     └── properties/imageAndQuery.ts     Image upload fields + query-param Filters
 │     ParsedOperation[] → INodeProperties[]
 │     Emits in order:
 │       1.  Resource dropdown
@@ -383,7 +420,11 @@ scripts/generate.ts                       (entry point: npm run generate)
 │     Extracts: *MessagePayload type literals,
 │               MessageSubscriptionResourceTypeId values,
 │               ChangeSubscriptionResourceTypeId values
-│     │     Filters to allowedResources: [product, customer, cart, order, business-unit, category, channel, associate-role, inventory-entry, review, shopping-list, type, payment, quote, quote-request, staged-quote, approval-rule, approval-flow, standalone-price, store, product-tailoring, customer-group, product-selection]
+│     Filters to allowedResources: [product, customer, cart, order, business-unit,
+│       category, channel, associate-role, inventory-entry, review, shopping-list,
+│       type, payment, quote, quote-request, staged-quote, approval-rule,
+│       approval-flow, standalone-price, store, product-tailoring,
+│       customer-group, product-selection]
 │     → nodes/Commercetools/generated/ctp-event-registry.json
 │
 └── generateSubscriptionProperties.ts
@@ -396,6 +437,33 @@ scripts/generate.ts                       (entry point: npm run generate)
 
 Generated files are committed to the repository. The built node works without running `generate` unless the Postman collection or SDK has changed.
 
+### Node source layout
+
+```
+nodes/Commercetools/
+├── Commercetools.node.ts           Thin action-node orchestrator (~175 lines)
+├── CommercetoolsTrigger.node.ts    Webhook trigger — receives and routes events
+├── generated/                      Auto-generated (do not edit manually)
+│   ├── properties.ts
+│   ├── operations.json
+│   ├── ctp-event-registry.json
+│   └── subscription.properties.ts
+├── lambda/
+│   ├── awsHandler.js               Lambda: SQS → n8n webhook forwarder
+│   └── gcpHandler.js               Cloud Function: Pub/Sub → n8n webhook forwarder
+└── utils/
+    ├── urlBuilder.utils.ts         URL construction + path-param substitution
+    ├── bodyBuilder.utils.ts        Request body assembly for all operation types
+    ├── imageUpload.utils.ts        SSRF-guarded image download + CT binary POST
+    ├── subscription.utils.ts       Subscription CRUD + body building + event routing
+    ├── webhookMethods.utils.ts     Webhook lifecycle: checkExists / create / delete
+    ├── cloudVerification.utils.ts  AWS + GCP infrastructure existence checks
+    ├── awsInfra.utils.ts           AWS SQS / Lambda / IAM provisioning
+    ├── awsDelete.utils.ts          AWS infrastructure teardown
+    ├── gcpInfra.utils.ts           GCP Pub/Sub / Cloud Functions provisioning
+    └── gcpDelete.utils.ts          GCP infrastructure teardown
+```
+
 ---
 
 ## Auto-Update Pipeline
@@ -425,6 +493,12 @@ New API endpoints and fields appear in the node automatically without manual dev
 | Business Unit Search: `Search Not Ready`                   | Business Unit Search must be activated on your project — call `PUT /{projectKey}/business-units/search/indexing-status` with `{ "activated": true }` then wait for indexing to complete |
 | GCP: private key / PEM errors                              | Use the **Service Account JSON** field; paste the entire `.json` key file, not individual fields              |
 | GCP: deploy timeout on first activation                    | GCP API enablement takes time on cold projects — retry after a minute                                         |
+| GCP: `gcpRegion` missing error on activation               | Open the credential and select a GCP Region — the field is required for Cloud Functions deployment            |
+| AWS: wrong queue ARN in GovCloud / China regions           | ARN is now fetched from `GetQueueAttributes` (not constructed manually) — update to v1.0.14 to fix            |
+| AWS: `credentials are invalid` or `permissions denied`     | Verify the IAM user has SQS, Lambda, IAM, STS, and CloudWatch Logs permissions                               |
+| Trigger: malformed webhook payload crashes execution        | Update to v1.0.14 — invalid JSON payloads are now silently dropped instead of crashing the context           |
+| Subscription: `subscriptionId is empty` error              | The subscription ID was not persisted in static data — deactivate and reactivate the workflow                 |
+| Update operation: zero value (`0`) silently dropped        | Update to v1.0.14 — `quantity: 0` and `centAmount: 0` are now sent correctly                                 |
 | Node not visible in n8n                                    | Run `npm install` then `npm run dev`                                                                          |
 | Trigger: `"A message with the name 'PaymentMethodCreated' is unknown for the TypeId 'payment'"` | CT Subscriptions API does not support `payment-method` as a resourceTypeId. Use CT API Extensions or a schedule-based polling trigger instead. |
 
@@ -432,14 +506,13 @@ New API endpoints and fields appear in the node automatically without manual dev
 
 ## Changelog
 
-| Version | Changes                                                                                          |
-| ------- | ------------------------------------------------------------------------------------------------ |
-| v1.0.12 | Added Approval Rules, Approval Flows, and Associate Endpoints                                    |
-| v1.0.11 | Added Quotes, Quote Requests, Staged Quotes, Messages, and API Extensions                        |
-| v1.0.10 | Added Claude AI agents and skills for automated development assistance                           |
-| v1.0.9  | Added Zones, Subscriptions, and States                                                           |
-| v1.0.8  | Added Custom Objects, Payments, Payment Methods, and Shipping Methods                            |
-                                                                      
+| Version | Changes                                                                                                                     |
+| ------- | ----------------------------------------------------------------------------------------------------------------------------|
+| v1.0.14 | Two-pass refactor: modular `scripts/` and `nodes/` structure; 60+ bug fixes across AWS/GCP provisioning, subscription management, body building, SSRF guard, and error handling; all files under 300 lines |
+| v1.0.13 | Added Standalone Prices, Stores, Product Tailoring, Customer Groups, Product Selections, Cart Discounts, and Discount Codes |
+| v1.0.12 | Added Approval Rules, Approval Flows, and Associate Endpoints                                                               |
+| v1.0.11 | Added Quotes, Quote Requests, Staged Quotes, Messages, and API Extensions                                                   |
+| v1.0.10 | Added Claude AI agents and skills for automated development assistance                                                      |