@proveanything/smartlinks 1.14.5 → 1.14.7

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.14.5  |  Generated: 2026-05-16T12:39:31.377Z
+Version: 1.14.7  |  Generated: 2026-05-16T13:30:13.413Z
 
 This is a concise summary of all available API functions and types.
 
@@ -150,9 +150,9 @@ Return whether proxy mode is currently enabled.
   iframeAutoResize?: boolean // default true when in iframe
   logger?: Logger // optional console-like or function to enable verbose logging
   /**
-   * When true, bypasses the idempotency guard and forces a full re-initialization.
-   * Use only when you intentionally need to reset all SDK state (e.g. in tests or
-   * when switching accounts) → `void`
+   * When true, the bearer token is automatically saved to localStorage after login
+   * and restored on the next page load. Eliminates the need to manually persist
+   * the token across refreshes. Clear it by calling setBearerToken(undefined) → `void`
 Call this once (e.g. at app startup) to configure baseURL/auth.
 
 **setNgrokSkipBrowserWarning**(flag: boolean) → `void`

package/dist/http.d.ts

@@ -16,6 +16,12 @@ export declare function initializeApi(options: {
     extraHeaders?: Record<string, string>;
     iframeAutoResize?: boolean;
     logger?: Logger;
+    /**
+     * When true, the bearer token is automatically saved to localStorage after login
+     * and restored on the next page load. Eliminates the need to manually persist
+     * the token across refreshes. Clear it by calling setBearerToken(undefined) or logout().
+     */
+    persistToken?: boolean;
     /**
      * When true, bypasses the idempotency guard and forces a full re-initialization.
      * Use only when you intentionally need to reset all SDK state (e.g. in tests or

package/dist/http.js

@@ -48,13 +48,16 @@ function getSourceDomain() {
 const httpCache = new Map();
 let cacheEnabled = true;
 /** Default TTL used when no per-resource rule matches (milliseconds). */
-let cacheDefaultTtlMs = 60000; // 60 seconds
+let cacheDefaultTtlMs = 15000; // 15 seconds
 /** Maximum number of entries before the oldest (LRU) entry is evicted. */
 let cacheMaxEntries = 200;
 /** Persistence backend for the L2 cache. 'none' (default) disables IndexedDB persistence. */
 let cachePersistence = 'none';
 /** When true (default), clear in-memory and sessionStorage caches on page load/refresh. */
 let cacheClearOnPageLoad = true;
+/** When true, the bearer token is saved to localStorage and restored automatically on init. */
+let tokenPersistenceEnabled = false;
+const TOKEN_STORAGE_KEY = 'sl:token';
 /**
  * How long L2 (IndexedDB) entries are considered valid as an offline stale fallback,
  * measured from the original network fetch time (default: 7 days).
@@ -137,6 +140,11 @@ function clearSessionCachesOnPageLoad() {
 // Auto-clear session caches on page load (browser only)
 if (typeof window !== 'undefined' && cacheClearOnPageLoad) {
     clearSessionCachesOnPageLoad();
+    // Also clear on bfcache restoration (mobile browsers restore JS context without reloading)
+    window.addEventListener('pageshow', (e) => {
+        if (e.persisted)
+            clearSessionCachesOnPageLoad();
+    });
 }
 /**
  * Return cached data for a key if it exists and is within TTL.
@@ -339,6 +347,7 @@ function normalizeErrorResponse(responseBody, statusCode) {
  */
 import { iframe } from './iframe';
 export function initializeApi(options) {
+    var _a;
     // Normalize baseURL by removing trailing slashes.
     const normalizedBaseURL = options.baseURL.replace(/\/+$/g, "");
     // ------------------------------------------------------------------
@@ -355,6 +364,9 @@ export function initializeApi(options) {
     }
     baseURL = normalizedBaseURL;
     apiKey = options.apiKey;
+    // Enable token persistence before restoring the token.
+    if (options.persistToken !== undefined)
+        tokenPersistenceEnabled = options.persistToken;
     // Only overwrite bearerToken when the caller explicitly supplies one,
     // OR when this is the very first initialization (start with a clean slate).
     // Re-initialization calls that omit bearerToken must NOT clear a token that
@@ -363,7 +375,13 @@ export function initializeApi(options) {
         bearerToken = options.bearerToken;
     }
     else if (!initialized) {
-        bearerToken = undefined;
+        // On first init with no explicit token, restore from localStorage if persistence is on.
+        if (tokenPersistenceEnabled && typeof localStorage !== 'undefined') {
+            bearerToken = (_a = localStorage.getItem(TOKEN_STORAGE_KEY)) !== null && _a !== void 0 ? _a : undefined;
+        }
+        else {
+            bearerToken = undefined;
+        }
     }
     // else: preserve the existing runtime bearerToken.
     proxyMode = !!options.proxyMode;
@@ -413,6 +431,21 @@ export function setBearerToken(token) {
     if (token === bearerToken)
         return;
     bearerToken = token;
+    // Persist or clear from localStorage when token persistence is enabled.
+    if (tokenPersistenceEnabled && typeof localStorage !== 'undefined') {
+        if (token) {
+            try {
+                localStorage.setItem(TOKEN_STORAGE_KEY, token);
+            }
+            catch (_a) { }
+        }
+        else {
+            try {
+                localStorage.removeItem(TOKEN_STORAGE_KEY);
+            }
+            catch (_b) { }
+        }
+    }
     httpCache.clear();
     if (cachePersistence !== 'none')
         idbClear().catch(() => { });

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.14.5  |  Generated: 2026-05-16T12:39:31.377Z
+Version: 1.14.7  |  Generated: 2026-05-16T13:30:13.413Z
 
 This is a concise summary of all available API functions and types.
 
@@ -150,9 +150,9 @@ Return whether proxy mode is currently enabled.
   iframeAutoResize?: boolean // default true when in iframe
   logger?: Logger // optional console-like or function to enable verbose logging
   /**
-   * When true, bypasses the idempotency guard and forces a full re-initialization.
-   * Use only when you intentionally need to reset all SDK state (e.g. in tests or
-   * when switching accounts) → `void`
+   * When true, the bearer token is automatically saved to localStorage after login
+   * and restored on the next page load. Eliminates the need to manually persist
+   * the token across refreshes. Clear it by calling setBearerToken(undefined) → `void`
 Call this once (e.g. at app startup) to configure baseURL/auth.
 
 **setNgrokSkipBrowserWarning**(flag: boolean) → `void`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.14.5",
+  "version": "1.14.7",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",