@unchainedshop/plugins

Official plugin collection for the Unchained Engine. Provides ready-to-use adapters for payment, delivery, pricing, file storage, workers, and more.

Installation

npm install @unchainedshop/plugins

Available Plugins

Payment Adapters

Plugin	Import Path	Description
Invoice	payment/invoice	Simple invoice-based payment
Invoice Prepaid	payment/invoice-prepaid	Prepaid invoice payment
Stripe	payment/stripe	Stripe payment integration
Datatrans V2	payment/datatrans-v2	Datatrans payment gateway
Saferpay	payment/saferpay	Saferpay payment gateway
Braintree	payment/braintree	Braintree payments
Payrexx	payment/payrexx	Payrexx payment gateway
Apple IAP	payment/apple-iap	Apple In-App Purchase
Cryptopay	payment/cryptopay	Cryptocurrency payments

Delivery Adapters

Plugin	Import Path	Description
Post	delivery/post	Standard postal delivery
Stores	delivery/stores	Store pickup delivery
Send Message	delivery/send-message	Digital delivery via messaging

Pricing Adapters

Plugin	Import Path	Description
Product Catalog Price	pricing/product-catalog-price	Base catalog pricing
Product Price Rate Conversion	pricing/product-price-rateconversion	Currency conversion
Product Round	pricing/product-round	Price rounding
Product Discount	pricing/product-discount	Product-level discounts
Order Items	pricing/order-items	Order item pricing
Order Delivery	pricing/order-delivery	Delivery pricing
Order Payment	pricing/order-payment	Payment fee pricing
Order Discount	pricing/order-discount	Order-level discounts
Order Round	pricing/order-round	Order total rounding
Free Delivery	pricing/free-delivery	Free delivery conditions
Free Payment	pricing/free-payment	Free payment processing
Swiss Tax (CH)	pricing/tax/ch	Swiss VAT calculation

Filter Adapters

Plugin	Import Path	Description
Strict Equal	filters/strict-equal	Exact match filtering
Local Search	filters/local-search	Full-text search

File Storage Adapters

Plugin	Import Path	Description
GridFS	files/gridfs	MongoDB GridFS storage
MinIO	files/minio	MinIO/S3-compatible storage

Worker Adapters

Plugin	Import Path	Description
Email	worker/email	Email sending worker
Heartbeat	worker/heartbeat	Keep-alive heartbeat
HTTP Request	worker/http-request	HTTP request worker
Bulk Import	worker/bulk-import	Bulk data import
External	worker/external	External service calls
Twilio	worker/twilio	Twilio SMS integration
Push Notification	worker/push-notification	Push notifications
Update ECB Rates	worker/update-ecb-rates	ECB exchange rates
Update Coinbase Rates	worker/update-coinbase-rates	Crypto exchange rates
Update Token Ownership	worker/update-token-ownership	NFT ownership sync
Zombie Killer	worker/zombie-killer	Stale job cleanup
Error Notifications	worker/error-notifications	Error alerting

Event Adapters

Plugin	Import Path	Description
Node Event Emitter	events/node-event-emitter	Default Node.js emitter
Redis	events/redis	Redis pub/sub
AWS EventBridge	events/aws-eventbridge	AWS EventBridge

Warehousing Adapters

Plugin	Import Path	Description
Store	warehousing/store	Basic inventory
ETH Minter	warehousing/eth-minter	Ethereum NFT minting

Other Adapters

Plugin	Import Path	Description
Licensed Enrollment	enrollments/licensed	License-based subscriptions
Manual Quotation	quotations/manual	Manual quote handling

Usage

Import and register plugins during platform initialization:

import { startPlatform } from '@unchainedshop/platform';

// Import specific plugins
import '@unchainedshop/plugins/payment/stripe';
import '@unchainedshop/plugins/delivery/post';
import '@unchainedshop/plugins/pricing/product-catalog-price';

const platform = await startPlatform({
  // ...
});

Security

Payment Plugin Security

All payment plugins implement secure tokenization patterns for PCI DSS SAQ-A eligibility:

Plugin	Security Method
Stripe	PaymentIntent/SetupIntent tokenization
Datatrans	Secure Fields with HMAC-SHA-256 signatures
Saferpay	Redirect with SHA-256 transaction signatures
Braintree	Client SDK tokenization
Cryptopay	BIP-32 HD wallet address derivation

Signature Algorithms:

• HMAC-SHA-256: Datatrans, Payrexx, GridFS file uploads
• HMAC-SHA-512: PostFinance Checkout
• SHA-256: Saferpay

FIPS 140-3 Compatibility

All cryptographic operations use FIPS-approved algorithms. When deployed on FIPS-enabled Node.js (e.g., Chainguard node-fips), plugins operate in FIPS-compliant mode.

See SECURITY.md for complete security documentation.

Notes

Postfinance Checkout Plugin

Due to a TypeScript issue with the upstream "postfinancecheckout" package, the Postfinance plugin has been disabled from transpilation. To use it:

1. Import the source TypeScript files directly from src
2. Enable node_modules TypeScript compilation, or
3. Copy src/payment/postfinance-checkout to your project

License

EUPL-1.2