edatalia-websign 3.2.9 → 3.3.1

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 All significant updates to this project will be documented here.  
 This changelog is public.
 
+## [3.3.1] - 2025-01-27
+
+### Fixed
+
+- Signotec double `setDisplayPDF` call when EBP is enabled
+
+## [3.3.0] - 2025-01-27
+
+### Added
+
+- **Middleware Mode:** New `useMiddleware` parameter to route signature data through an external middleware before completing the signature flow.
+- **Offline Mode:** New `offlineMode` and `offlineModeAutoFetch` parameters to enable offline signature capture using Service Worker with automatic sync when connection is restored.
+
 ## [3.2.8] - 2025-01-15
 
 ### Fixed

package/README.md

@@ -197,6 +197,9 @@ All parameters below are part of the `config` object:
 | `properties` | `Object` | Specifies pdf signature properties like author, reason, contact and location |
 | `displayCanvasSignatureButtonsInDTU` | `boolean` | When set to true, this parameter enables display of signature action buttons directly within the DTU device canvas interface, allowing users to perform signature-related operations from the DTU screen itself |
 | `enableBridge` | `boolean` | When set to true, this parameter tries to communicate with WebSign Bridge, see more in the [corresponding section](#-websign-bridge-desktop-helper) |
+| `useMiddleware` | `boolean` | Routes signature data through an external middleware via callback before completing the flow |
+| `offlineMode` | `boolean` | Enables offline signature capture using Service Worker |
+| `offlineModeAutoFetch` | `boolean` | Auto-syncs pending requests in background without prompting the user |
 ---
 
 
@@ -322,6 +325,36 @@ const config = {
 
 WebSign Bridge is a lightweight desktop companion that enhances WebSign with native capabilities via a local service. It enables high‑performance operations and access to the local environment when your app runs in the browser.
 
+---
+
+## 📴 Offline Mode
+
+WebSign supports intermittent connectivity scenarios. Although it's called "offline mode", the user needs connection to receive the signed PDF. However, if connection is lost at the moment of signing, the request is stored locally and processed when WebSign is launched again.
+
+### Setup
+
+1. Copy the Service Worker file to your project root:
+
+```bash
+cp node_modules/edatalia-websign/dist/offline-sw.js ./public/
+```
+
+2. Enable offline mode in your config:
+
+```js
+const config = {
+  offlineMode: true,
+  offlineModeAutoFetch: true, // auto-sync pending requests without prompting
+  // ... other config
+};
+```
+
+### Requirements
+
+- **HTTPS with valid SSL certificate**: Service Workers require a secure context. For local development, use tools like `mkcert` to generate a trusted certificate.
+
+---
+
 ### Why use the Bridge?
 
 ⚡ Speed-ups in signature workflows (reduced latency on device I/O and PDF handling)