@nosslabs/iap 8.1.0 → 8.2.0

package/dist/index.d.cts

@@ -1729,6 +1729,11 @@ interface IAP<TEntitlement extends EntitlementBase = EntitlementBase> {
      * A no-op after `destroy()`, rather than an error: a teardown racing a
      * "delete my data" tap is a real sequence, not a programming mistake.
      *
+     * It also throws if the storage backend cannot be reached at all — an
+     * uninstalled `@capacitor/preferences`, say. Individual key failures are
+     * logged and the rest still cleared, but reporting success having erased
+     * nothing is the one outcome a delete-everything control must not have.
+     *
      * It does **not** revoke the purchase. The store still owns it, and a
      * restore will bring the entitlement back — which is correct: the user
      * paid.

package/dist/index.d.ts

@@ -1729,6 +1729,11 @@ interface IAP<TEntitlement extends EntitlementBase = EntitlementBase> {
      * A no-op after `destroy()`, rather than an error: a teardown racing a
      * "delete my data" tap is a real sequence, not a programming mistake.
      *
+     * It also throws if the storage backend cannot be reached at all — an
+     * uninstalled `@capacitor/preferences`, say. Individual key failures are
+     * logged and the rest still cleared, but reporting success having erased
+     * nothing is the one outcome a delete-everything control must not have.
+     *
      * It does **not** revoke the purchase. The store still owns it, and a
      * restore will bring the entitlement back — which is correct: the user
      * paid.

package/dist/index.js

@@ -1,7 +1,6 @@
 import { Capacitor } from '@capacitor/core';
 import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
 import { z } from 'zod';
-import { Preferences } from '@capacitor/preferences';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -1977,39 +1976,122 @@ init_errors();
 var PreferencesAdapter = class {
   prefix;
   knownKeys = /* @__PURE__ */ new Set();
+  /**
+   * Boxed, and that is not incidental — see {@link PreferencesAdapter.preferences}.
+   */
+  plugin = null;
   constructor(namespace) {
     this.prefix = `${namespace}.`;
   }
+  /**
+   * The plugin, inside a box.
+   *
+   * The box is load-bearing. `registerPlugin()` hands back a **Proxy** that
+   * answers any property, `then` included — so resolving a promise *with*
+   * the plugin makes it look like a thenable, and promise assimilation
+   * calls `Preferences.then()`. On web that rejects with
+   * `"Preferences.then()" is not implemented on web`, from inside
+   * `await this.preferences()`, for every storage operation.
+   *
+   * Wrapping it in a plain object means the promise resolves with something
+   * that has no `then`, so nothing is assimilated.
+   */
+  preferences() {
+    this.plugin ??= import('@capacitor/preferences').then((mod) => ({ preferences: mod.Preferences })).catch((cause) => {
+      if (isModuleNotFound(cause)) throw notInstalled(cause);
+      this.plugin = null;
+      throw new IAPError({
+        code: IAPErrorCode.STORAGE_ERROR,
+        message: "Could not load @capacitor/preferences. The package is installed, so this is most likely a chunk that failed to load; it is worth retrying.",
+        cause,
+        recoverable: true
+      });
+    });
+    return this.plugin;
+  }
+  /**
+   * Resolve the plugin now, so a missing one is reported at `initialize()`.
+   *
+   * See the note on lazy loading above for why this is not left to the first
+   * `get()`.
+   */
+  async ensureAvailable() {
+    await this.preferences();
+  }
   async get(key) {
+    const { preferences } = await this.preferences();
     try {
-      const result = await Preferences.get({ key: this.prefix + key });
+      const result = await preferences.get({ key: this.prefix + key });
       return result.value;
     } catch (cause) {
       throw wrap(cause, `Preferences.get failed for "${key}".`);
     }
   }
   async set(key, value) {
+    const { preferences } = await this.preferences();
     try {
-      await Preferences.set({ key: this.prefix + key, value });
+      await preferences.set({ key: this.prefix + key, value });
       this.knownKeys.add(key);
     } catch (cause) {
       throw wrap(cause, `Preferences.set failed for "${key}".`);
     }
   }
   async remove(key) {
+    const { preferences } = await this.preferences();
     try {
-      await Preferences.remove({ key: this.prefix + key });
+      await preferences.remove({ key: this.prefix + key });
       this.knownKeys.delete(key);
     } catch (cause) {
       throw wrap(cause, `Preferences.remove failed for "${key}".`);
     }
   }
   async clear() {
+    const { preferences } = await this.preferences();
     const keys = [...this.knownKeys];
-    this.knownKeys.clear();
-    await Promise.all(keys.map((k) => Preferences.remove({ key: this.prefix + k })));
+    const failed = [];
+    const errors = [];
+    await Promise.all(
+      keys.map(async (key) => {
+        try {
+          await preferences.remove({ key: this.prefix + key });
+          this.knownKeys.delete(key);
+        } catch (cause) {
+          failed.push(key);
+          errors.push(cause);
+        }
+      })
+    );
+    if (failed.length > 0) {
+      throw wrap(errors[0], `Preferences.clear failed for ${failed.length} key(s).`);
+    }
   }
 };
+function isModuleNotFound(cause) {
+  let current = cause;
+  for (let depth = 0; depth < 5 && current; depth += 1) {
+    const code = current.code;
+    if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") return true;
+    const message = current instanceof Error ? current.message : String(current);
+    if (/cannot find (module|package)|could not resolve|failed to resolve/i.test(message)) {
+      return true;
+    }
+    const next = current.cause;
+    if (next === current) break;
+    current = next;
+  }
+  return false;
+}
+function notInstalled(cause) {
+  return new IAPError({
+    code: IAPErrorCode.INVALID_CONFIG,
+    message: 'storage.type is "preferences" (the default) but @capacitor/preferences is not installed. Install it (npm i @capacitor/preferences && npx cap sync), or choose storage that needs no plugin: storage.type "memory", or "custom" with your own adapter.',
+    // The per-code hint for INVALID_CONFIG sends the reader to check field
+    // paths against the config schema. There are none to check, and no
+    // config change fixes this — the message above already says what to do.
+    includeHint: false,
+    cause
+  });
+}
 function wrap(cause, message) {
   return new IAPError({
     code: IAPErrorCode.STORAGE_ERROR,
@@ -2110,12 +2192,7 @@ var EntitlementCache = class {
     try {
       await this.storage.set(ENTITLEMENTS_KEY, JSON.stringify(envelope));
     } catch (cause) {
-      throw new IAPError({
-        code: IAPErrorCode.STORAGE_ERROR,
-        message: "Failed to persist entitlement cache.",
-        cause,
-        recoverable: true
-      });
+      throw toIAPError(cause, "Failed to persist entitlement cache.", IAPErrorCode.STORAGE_ERROR);
     }
     return cachedAt;
   }
@@ -3062,6 +3139,7 @@ async function initializeIap(state, refreshEntitlements) {
     state.logger.debug("initialize() called more than once; ignoring.");
     return;
   }
+  await state.storage.ensureAvailable?.();
   const platform = getPlatform();
   if (!isNative()) {
     state.logger.info("Native purchases unavailable on web; entitlement queries still functional.");
@@ -3355,6 +3433,7 @@ async function resetIap(state) {
       recoverable: true
     });
   }
+  await state.storage.ensureAvailable?.();
   const previous = state.entitlements;
   state.entitlements = [];
   state.cachedAt = null;
@@ -3531,12 +3610,11 @@ var UnfinishedTransactionsStore = class {
     try {
       await this.storage.set(STORE_KEY2, JSON.stringify(entries));
     } catch (cause) {
-      throw new IAPError({
-        code: IAPErrorCode.STORAGE_ERROR,
-        message: "Failed to persist unfinished transactions list.",
+      throw toIAPError(
         cause,
-        recoverable: true
-      });
+        "Failed to persist unfinished transactions list.",
+        IAPErrorCode.STORAGE_ERROR
+      );
     }
   }
   async safeClear() {
@@ -3799,7 +3877,7 @@ function resolveLogger(level, candidate) {
 init_errors();
 
 // src/version.ts
-var VERSION = "8.1.0";
+var VERSION = "8.2.0";
 
 export { DEFAULT_PERMANENT_ERROR_CODES, HttpBackendAdapter, HttpClient, IAPError, IAPErrorCode, VERSION, createIAP, errorHint, isExpired, isIAPError, verifyPurchaseOnDevice };
 //# sourceMappingURL=index.js.map