@wireai/activation 0.14.0 → 0.14.1

package/dist/index.d.mts

@@ -1979,7 +1979,13 @@ declare const permissionStorageKey: (appId: string) => string;
  * because re-showing a screen is a far cheaper failure than trusting another session's answers.
  */
 declare const readSettledPermissions: (raw: string | null | undefined, sessionId: string) => string[];
-/** Read the settled ids for `sessionId`. Never throws, never hangs past the shared read ceiling. */
+/**
+ * Read the settled ids for `sessionId`, collapsing "the store did not answer" to `[]`.
+ *
+ * Kept as the module's simple reader for callers that have no way to act on the difference. The
+ * one caller that CAN — `WireOnboarding`, which would otherwise re-ask and then overwrite the
+ * stored record — uses {@link loadSettledPermissionsOutcome} instead.
+ */
 declare const loadSettledPermissions: (storage: WireOnboardingStorage, key: string, sessionId: string) => Promise<string[]>;
 /** Persist the settled ids for `sessionId` - fire-and-forget, all errors swallowed. */
 declare const saveSettledPermissions: (storage: WireOnboardingStorage, key: string, sessionId: string, ids: readonly string[]) => void;

package/dist/index.d.ts

@@ -1979,7 +1979,13 @@ declare const permissionStorageKey: (appId: string) => string;
  * because re-showing a screen is a far cheaper failure than trusting another session's answers.
  */
 declare const readSettledPermissions: (raw: string | null | undefined, sessionId: string) => string[];
-/** Read the settled ids for `sessionId`. Never throws, never hangs past the shared read ceiling. */
+/**
+ * Read the settled ids for `sessionId`, collapsing "the store did not answer" to `[]`.
+ *
+ * Kept as the module's simple reader for callers that have no way to act on the difference. The
+ * one caller that CAN — `WireOnboarding`, which would otherwise re-ask and then overwrite the
+ * stored record — uses {@link loadSettledPermissionsOutcome} instead.
+ */
 declare const loadSettledPermissions: (storage: WireOnboardingStorage, key: string, sessionId: string) => Promise<string[]>;
 /** Persist the settled ids for `sessionId` - fire-and-forget, all errors swallowed. */
 declare const saveSettledPermissions: (storage: WireOnboardingStorage, key: string, sessionId: string, ids: readonly string[]) => void;

package/dist/index.js

@@ -3813,15 +3813,19 @@ var readSettledPermissions = (raw, sessionId) => {
     return [];
   }
 };
-var loadSettledPermissions = async (storage, key, sessionId) => {
+var loadSettledPermissionsOutcome = async (storage, key, sessionId) => {
   try {
     const raw = await withTimeout(storage.getItem(key), READ_TIMEOUT_MS);
-    if (raw === READ_TIMED_OUT) return [];
-    return readSettledPermissions(raw, sessionId);
+    if (raw === READ_TIMED_OUT) return { status: "unknown" };
+    return { status: "read", ids: readSettledPermissions(raw, sessionId) };
   } catch {
-    return [];
+    return { status: "unknown" };
   }
 };
+var loadSettledPermissions = async (storage, key, sessionId) => {
+  const outcome = await loadSettledPermissionsOutcome(storage, key, sessionId);
+  return outcome.status === "read" ? outcome.ids : [];
+};
 var saveSettledPermissions = (storage, key, sessionId, ids) => {
   try {
     const record = { sessionId, ids: [...ids] };
@@ -3976,16 +3980,33 @@ var WireOnboarding = ({
   const sessionId = (_c = session == null ? void 0 : session.id) != null ? _c : "";
   const wantsPermissionMemory = Boolean(storage) && ((_d = permissionScreens == null ? void 0 : permissionScreens.length) != null ? _d : 0) > 0;
   const [settledPermissions, setSettledPermissions] = React19.useState(void 0);
+  const [permissionMemoryUnreadable, setPermissionMemoryUnreadable] = React19.useState(false);
   React19.useEffect(() => {
-    if (!wantsPermissionMemory || !storage || !sessionId || settledPermissions !== void 0) return;
+    if (!wantsPermissionMemory || !storage || !sessionId) return;
+    if (settledPermissions !== void 0 || permissionMemoryUnreadable) return;
     let cancelled = false;
-    void loadSettledPermissions(storage, permissionsKey, sessionId).then((ids) => {
-      if (!cancelled) setSettledPermissions(ids);
+    void loadSettledPermissionsOutcome(storage, permissionsKey, sessionId).then((outcome) => {
+      if (cancelled) return;
+      if (outcome.status === "read") {
+        setSettledPermissions(outcome.ids);
+        return;
+      }
+      setPermissionMemoryUnreadable(true);
+      warnInDev(
+        "[wireai] the permission-screen memory could not be read (the storage adapter timed out or threw), so permission screens are suppressed for this session rather than re-asking a permission the OS grants once. Check the `storage` adapter passed to WireOnboarding."
+      );
     });
     return () => {
       cancelled = true;
     };
-  }, [wantsPermissionMemory, storage, permissionsKey, sessionId, settledPermissions]);
+  }, [
+    wantsPermissionMemory,
+    storage,
+    permissionsKey,
+    sessionId,
+    settledPermissions,
+    permissionMemoryUnreadable
+  ]);
   const settledPermissionsRef = React19.useRef(void 0);
   settledPermissionsRef.current = settledPermissions;
   const handlePermissionSettled = React19.useCallback(