n8n-nodes-n8ndesigner-salla-n8nai 0.3.160 → 0.3.161

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 N8NDesigner
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the " Software\), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED \AS IS\, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 n8n Designer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,140 +1,38 @@
-# n8n-nodes-salla
-
-Community nodes for n8n that integrate Salla stores through the N8NDesigner Actions API. The package delivers two production-ready actions and two webhook triggers aligned with the branding and behaviour requested by N8NDesigner.
-
-## Recent Updates
-
-- 0.2.4 &mdash; Removed the optional webhook path override from **Salla Triggers** so executions always target the default `/salla/<event>` suffix.
-
-## Requirements
-
-- Node.js 18 or newer
-- n8n 1.0 or newer (self-hosted or desktop)
-- Access to the N8NDesigner backend with a valid mak_... token and Salla merchant ID
-
-## Installation & Build
-
-`ash
-npm install
-npm run build
-`
-
-The build step compiles TypeScript sources into dist/ using 	sup. Publish with 
-pm publish or generate a tarball via 
-pm pack.
-
-## Credentials Setup
-
-Create a credential named **Salla (N8NDesigner Actions)** inside n8n and supply:
-
-- **Base URL**: defaults to https://app.n8ndesigner.com
-- **Salla Merchant ID**: e.g. 1596416913
-- **MAK Key**: backend-issued bearer token (mak_...)
-
-Every node automatically attaches Authorization: Bearer <makKey> and Content-Type: application/json headers.
-
-## Actions
-
-### Update Order Status
-
-Updates a Salla order workflow state by slug or numeric status ID and supports an optional note (max 500 characters). Either slug or status_id is required; if both are present they are sent together.
-
-Example curl equivalent (QA data):
-
-`ash
-curl -X PATCH 'https://app.n8ndesigner.com/api/actions/orders/562285006' \
-  -H 'Authorization: Bearer mak_xxxxxxxxxx' \
-  -H 'Content-Type: application/json' \
-  -d '{
-     salla_merchant_id: 1596416913,
-    slug: under_review,
-    note: Order triaged from n8n
-  }'
-`
-
-### Delete Customer
-
-Permanently deletes a customer. The node sends the merchant ID in both the body and query string so it works with the current and future controllers.
-
-`ash
-curl -X DELETE 'https://app.n8ndesigner.com/api/actions/customers/1924459692?salla_merchant_id=1596416913' \
-  -H 'Authorization: Bearer mak_xxxxxxxxxx' \
-  -H 'Content-Type: application/json' \
-  -d '{
-    salla_merchant_id: 1596416913
-  }'
-`
-
-Both action nodes return a normalized payload:
-
-`json
-{
-  ok: true,
-  status: 200,
-  data: { ... },
-  raw: { ... }
-}
-`
-
-Failures surface the backend-provided message (including Arabic validation strings) without additional wrapping, and each request times out after 12 seconds with up to two exponential retries on 429, 5xx, or transient network errors.
-
-## Triggers
-
-### Salla Triggers
-
-One unified webhook node that subscribes to the full Salla event catalogue exposed by the merchant proxy. Pick the desired event from the **Trigger On** dropdown (orders, customers, products, shipping, offers, and more) and the node automatically listens on `/webhook/<auto-id>/salla/<event>`. Every delivery emits a normalized payload:
-
-```json
-{
-  "ok": true,
-  "event": "order.status.updated",
-  "merchant": "1596416913",
-  "created_at": "2025-10-26T17:49:35.000Z",
-  "data": { ... original body or body.data ... },
-  "raw": {
-    "headers": { "X-Salla-Event": "order.status.updated", ... },
-    "body": { ...full request body... },
-    "query": { ... }
-  }
-}
-```
-
-Incoming notifications are validated against the selected event, de-duplicated by `X-Salla-Event-Id` (10 minute TTL), and acknowledgements for ignored or duplicate payloads return HTTP 200 with a descriptive body.
-
-The **Webhook Path** field is optional—leave it blank to keep the default `/salla/<event>` suffix, or provide your own (it will be slugified and appended after `/webhook/<auto-id>/` when the workflow is saved).
-
-### Deprecated triggers
-
-- Customer Created (Salla) — **Deprecated** (use `Salla Triggers` with `customer.created`)
-- Order Status Updated (Salla) — **Deprecated** (use `Salla Triggers` with `order.status.updated`)
-
-Existing workflows keep working, but new automations should migrate to **Salla Triggers**.
-
-## Proxy Fallback Helper
-
-For QA you can call the legacy merchant proxy through the shared helper:
-
-`	s
-const proxyResponse = await client.proxy({
-  method: 'GET',
-  path: '/v2/customers',
-  payload: { keyword: 'test@example.com' },
-});
-`
-
-The helper automatically targets POST https://app.n8ndesigner.com/api/merchant/salla and reuses the timeout and retry policy.
-
-## Testing Notes
-
-QA references supplied by N8NDesigner:
-
-- SALLA_MID=1596416913
-- ORDER_ID=562285006
-- customer_id=1924459692
-
-Use the action nodes to update the order to under_review (expect HTTP 200 within ~2 seconds) and to delete the disposable customer (expect HTTP 204). Trigger payload samples live under 	ests/Fixtures/salla/*.json (add-ons for future test automation).
-
-## Packaging
-
-Run 
-pm pack to produce an npm tarball suitable for publishing or direct installation inside n8n.
+# n8n Designer – Salla Nodes (Actions + Triggers)
+
+A community node package that lets you **receive and handle Salla webhook events** and run **Salla Actions** inside n8n workflows, with support for multi-endpoint workflows and event-based routing.
+
+This package is built for merchants and automation builders who want to connect Salla stores to n8n with a clean, workflow-first experience.
+
+## Key Features
+- **Salla Trigger**: Receive Salla events inside n8n and use them to start workflows.
+- **Salla Actions**: Perform Salla operations through configurable nodes.
+- **Workflow-friendly design**: Designed for multi-step automations and event-based routing patterns.
+- **Consistent node UX**: Clear node naming and grouping for easier navigation in the node list.
+
+## Installation
+
+### n8n Self-hosted
+Install via npm in your n8n environment:
+
+```bash
+npm install n8n-nodes-n8ndesigner-salla-n8nai
+```
+
+Then restart n8n.
+
+> Note: Availability in n8n Cloud depends on n8n’s community node policies.
+
+## Usage
+1. Add the **Salla Trigger** node to start a workflow from Salla events.
+2. Add **Salla Actions** nodes to perform operations as part of the same workflow.
+3. Use standard n8n nodes (IF, Switch, HTTP Request, Set, Code, etc.) to route and transform data.
+
+## Support & Contact
+- Website: https://n8ndesigner.com/
+- Email: support@n8ndesigner.com
+- Telegram Community: t.me/+nrnxntkvDn1kNTBk
+- News Channel: t.me/+QPFFnJNnnrM5NmVk
+
+## License
+MIT — Copyright (c) 2025 n8n Designer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-n8ndesigner-salla-n8nai",
-  "version": "0.3.160",
+  "version": "0.3.161",
   "description": "Salla nodes for n8n (Actions + Triggers)",
   "license": "MIT",
   "type": "commonjs",
@@ -12,12 +12,13 @@
     "README.md",
     "LICENSE"
   ],
-  "keywords": [
-    "n8n-community-node",
-    "n8n",
-    "salla",
-    "ecommerce"
-  ],
+  "keywords": [
+    "n8ndesigner",
+    "salla-nodes",
+    "n8nai",
+    "n8n-salla",
+    "n8n-designer"
+  ],
   "author": "N8NDesigner",
   "scripts": {
     "build": "echo \"Skipping build; dist already compiled\"",