@mostajs/pdf-sign-ui 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,24 @@
 
 Le format suit [Keep a Changelog](https://keepachangelog.com/fr/) ; versionnage [SemVer](https://semver.org/lang/fr/).
 
+## [0.3.0] — 2026-09-26
+
+### Ajouté
+- `buildSignRequest` transmet **`timestampUrl`** (horodatage RFC 3161, `@mostajs/pdf-sign` 0.3.0).
+  L'option s'y perdait **en silence** : le document sortait sans horodatage alors que l'appelant
+  croyait la date attestée par un tiers — donc opposable. Découvert en production.
+- **Avertissement sur les clés perdues.** C'est la DEUXIÈME option évanouie de la même façon après
+  `openPassword` en 0.2.0, et le commentaire du code mettait pourtant en garde contre ce piège
+  exact. Un jeu de clés fermé est défendable ; le fermer **en silence** ne l'est pas.
+  `buildSignRequest` nomme désormais les options qu'il ignore.
+
+  On avertit sans lever : lever casserait un appelant passant une clé supplémentaire inoffensive,
+  alors que le but est seulement que la perte cesse d'être invisible.
+
+### Modifié
+- `peerDependencies["@mostajs/pdf-sign"]` : `^0.2.0` → `^0.3.0`.
+
+
 ## 0.2.0 — 2026-09-21
 
 ### Ajouté

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/pdf-sign-ui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Couche de présentation de @mostajs/pdf-sign — logique headless (validation du formulaire de signature, préréglages de documents officiels/SIH, view-models de vérification, contrôleur). Framework-agnostique, zéro dépendance.",
   "license": "AGPL-3.0-or-later",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
@@ -22,7 +22,7 @@
     "example": "node examples/verify-viewmodel.mjs"
   },
   "peerDependencies": {
-    "@mostajs/pdf-sign": "^0.2.0",
+    "@mostajs/pdf-sign": "^0.3.0",
     "react": ">=18"
   },
   "peerDependenciesMeta": {

package/src/headless.js

@@ -68,6 +68,33 @@ function isBox(b) {
  * @param {object} data
  * @returns {import("@mostajs/pdf-sign").SignOptions}
  */
+/**
+ * Les clés que `buildSignRequest` sait recopier. Tout le reste est PERDU.
+ *
+ * ⚠️ Deux options s'y sont déjà évanouies sans bruit : `openPassword` — le document sortait
+ * déverrouillé alors que l'appelant le croyait fermé — puis `timestampUrl` — le document sortait
+ * sans horodatage alors que l'appelant croyait la date attestée. Deux fois, le même mécanisme, et
+ * deux fois découvert en production.
+ *
+ * Fermer le jeu est un choix défendable ; le fermer EN SILENCE ne l'est pas. On avertit donc, sans
+ * lever : lever casserait un appelant qui passe une clé supplémentaire inoffensive, alors que le
+ * but est seulement que la perte cesse d'être invisible.
+ */
+const CLES_CONNUES = new Set([
+  'input', 'output', 'p12', 'passphrase', 'passphraseFile', 'engine',
+  'reason', 'name', 'location', 'contact', 'preset',
+  'page', 'box', 'stampImage', 'permissions', 'restrict',
+  'openPassword', 'timestampUrl',
+]);
+
+function signalerClesPerdues(data) {
+  const perdues = Object.keys(data || {}).filter((k) => !CLES_CONNUES.has(k) && data[k] !== undefined);
+  if (perdues.length) {
+    console.warn('[pdf-sign-ui] option(s) ignorée(s) par buildSignRequest, donc PERDUE(S) : '
+      + perdues.join(', ') + '. Ajoutez-les au jeu de clés ou retirez-les de l’appel.');
+  }
+}
+
 export function buildSignRequest(data = {}) {
   const preset = data.preset ? getPreset(data.preset) : undefined;
   const reason = data.reason || preset?.reason;
@@ -99,7 +126,12 @@ export function buildSignRequest(data = {}) {
     // et le document sort sans elle — sans erreur. `openPassword` a été perdu ainsi jusqu'en
     // 0.2.0 : le document s'ouvrait alors que l'appelant le croyait verrouillé.
     openPassword: data.openPassword || undefined,
+    // Horodatage RFC 3161 (`@mostajs/pdf-sign` 0.3.0) : fait passer la signature de PAdES-B à
+    // PAdES-T. Perdu ici en silence lors de sa première intégration — exactement comme
+    // `openPassword` avant lui. D'où l'avertissement ci-dessous.
+    timestampUrl: data.timestampUrl || undefined,
   };
+  signalerClesPerdues(data);
   return prune(req);
 }