@colixsystems/widget-sdk 0.221.0 → 0.221.1

package/README.md

@@ -84,7 +84,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.221.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+`v0.221.1` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+
+### What's new in 0.221.1 (contract 1.177.1)
+
+**`useFileSignature`: one failed poll no longer outlives the next answer.** `error` is the last call that failed, and a `refresh()` or `verify()` that succeeds now clears it. While `status` is `'pending'` an `error` means a poll failed: keep polling and keep showing the order. Fix only; nothing was added or removed.
 
 ### What's new in 0.221.0 (contract 1.177.0)
 

package/dist/contract.cjs

@@ -1559,7 +1559,10 @@ const HOOKS = [
       "be cancelled. cancel() resolves to what became of the order, which is " +
       "then still pending or already complete: read status after it, never " +
       "assume 'cancelled'. nameRefusal is set when the order failed because " +
-      "the signer's name cannot be shown on the document. Reads " +
+      "the signer's name cannot be shown on the document. error is the last " +
+      "call that failed, and a refresh() or verify() that succeeds clears it: " +
+      "while status is 'pending' an error means one poll failed, so keep " +
+      "polling and keep showing the order. Reads " +
       "ctx.filestore.signatures.{initiate,status,cancel,verify}.",
     returnShape: {
       status: "'pending' | 'complete' | 'failed' | 'cancelled' | null",
@@ -5868,7 +5871,10 @@ const CONTRACT = deepFreeze({
   //    and attach to it in one handler. A FILE column's file goes in its
   //    row's record space; useCamera / useImageEditor point at
   //    useFilestoreUpload, since widget code cannot reach ctx.assets.
-  version: "1.177.0",
+  // 1.177.1: fix (sc-10410) — a `refresh()` or `verify()` that succeeds
+  //    clears `useFileSignature`'s `error`; it used to keep one failed poll's
+  //    error for the rest of the order.
+  version: "1.177.1",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/contract.js

@@ -1559,7 +1559,10 @@ const HOOKS = [
       "be cancelled. cancel() resolves to what became of the order, which is " +
       "then still pending or already complete: read status after it, never " +
       "assume 'cancelled'. nameRefusal is set when the order failed because " +
-      "the signer's name cannot be shown on the document. Reads " +
+      "the signer's name cannot be shown on the document. error is the last " +
+      "call that failed, and a refresh() or verify() that succeeds clears it: " +
+      "while status is 'pending' an error means one poll failed, so keep " +
+      "polling and keep showing the order. Reads " +
       "ctx.filestore.signatures.{initiate,status,cancel,verify}.",
     returnShape: {
       status: "'pending' | 'complete' | 'failed' | 'cancelled' | null",
@@ -5864,7 +5867,10 @@ const CONTRACT = deepFreeze({
   //    and attach to it in one handler. A FILE column's file goes in its
   //    row's record space; useCamera / useImageEditor point at
   //    useFilestoreUpload, since widget code cannot reach ctx.assets.
-  version: "1.177.0",
+  // 1.177.1: fix (sc-10410) — a `refresh()` or `verify()` that succeeds
+  //    clears `useFileSignature`'s `error`; it used to keep one failed poll's
+  //    error for the rest of the order.
+  version: "1.177.1",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/signing-hooks.js

@@ -40,7 +40,9 @@ const userIdOf = (ctx) => (ctx.user && ctx.user.id) || "";
  * with `hintCode: "sealing"`. `hintCode` is where the order stands;
  * `nameRefusal` (`{ reason, characters }`) is set when it failed because the
  * signer's name cannot be shown. `autoStartToken` is set only while opening
- * BankID can still help. Reads
+ * BankID can still help. `error` is the last call that failed; a `refresh()`
+ * or `verify()` that succeeds clears it, so one failed poll does not outlive
+ * the next answer. Reads
  * `ctx.filestore.signatures.{initiate,status,cancel,verify}`. When `fileId` is
  * null/empty the hook collapses to a no-op.
  *
@@ -128,7 +130,8 @@ export function useFileSignature(fileId, existingSignatureId = null) {
       const res = await sigRef.current.status(id);
       // A cancel or a new order since this poll was sent: its answer is old news.
       if (answersRef.current !== asked) return;
-      apply(forScope, (base) => ({ order: signOrderStateAfterAnswer(base.order, res) }));
+      // An answer means the order can be reached again: an earlier failure is over.
+      apply(forScope, (base) => ({ order: signOrderStateAfterAnswer(base.order, res), error: null }));
     } catch (err) {
       if (answersRef.current !== asked) return;
       apply(forScope, () => ({ error: toPermissionError(err) }));
@@ -156,7 +159,7 @@ export function useFileSignature(fileId, existingSignatureId = null) {
     if (!id) return null;
     try {
       const v = await sigRef.current.verify(id);
-      apply(forScope, () => ({ verdict: v }));
+      apply(forScope, () => ({ verdict: v, error: null }));
       return v;
     } catch (err) {
       const refusal = toPermissionError(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colixsystems/widget-sdk",
-  "version": "0.221.0",
+  "version": "0.221.1",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "homepage": "https://github.com/Colix-AB/AppStudio",
   "type": "module",

package/src/contract.js

@@ -1559,7 +1559,10 @@ const HOOKS = [
       "be cancelled. cancel() resolves to what became of the order, which is " +
       "then still pending or already complete: read status after it, never " +
       "assume 'cancelled'. nameRefusal is set when the order failed because " +
-      "the signer's name cannot be shown on the document. Reads " +
+      "the signer's name cannot be shown on the document. error is the last " +
+      "call that failed, and a refresh() or verify() that succeeds clears it: " +
+      "while status is 'pending' an error means one poll failed, so keep " +
+      "polling and keep showing the order. Reads " +
       "ctx.filestore.signatures.{initiate,status,cancel,verify}.",
     returnShape: {
       status: "'pending' | 'complete' | 'failed' | 'cancelled' | null",
@@ -5864,7 +5867,10 @@ const CONTRACT = deepFreeze({
   //    and attach to it in one handler. A FILE column's file goes in its
   //    row's record space; useCamera / useImageEditor point at
   //    useFilestoreUpload, since widget code cannot reach ctx.assets.
-  version: "1.177.0",
+  // 1.177.1: fix (sc-10410) — a `refresh()` or `verify()` that succeeds
+  //    clears `useFileSignature`'s `error`; it used to keep one failed poll's
+  //    error for the rest of the order.
+  version: "1.177.1",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,