@proveanything/smartlinks 1.3.8 → 1.3.9

package/dist/cache.d.ts

@@ -0,0 +1,32 @@
+export interface CacheOptions {
+    /** TTL in milliseconds (default: 5 minutes) */
+    ttl?: number;
+    /** Storage backend */
+    storage?: 'memory' | 'session' | 'local';
+}
+/**
+ * Get cached value or fetch fresh.
+ *
+ * @param key - Cache key
+ * @param fetcher - Async function to fetch fresh data
+ * @param options - Cache options
+ * @returns Cached or fresh value
+ *
+ * @example
+ * ```typescript
+ * const apps = await cache.getOrFetch(
+ *   `apps:${collectionId}`,
+ *   () => collection.getApps(collectionId),
+ *   { ttl: 5 * 60 * 1000, storage: 'session' }
+ * );
+ * ```
+ */
+export declare function getOrFetch<T>(key: string, fetcher: () => Promise<T>, options?: CacheOptions): Promise<T>;
+/**
+ * Invalidate a cached key.
+ */
+export declare function invalidate(key: string): void;
+/**
+ * Clear all cached data.
+ */
+export declare function clear(): void;

package/dist/cache.js

@@ -0,0 +1,125 @@
+// =============================================================================
+// Cache Utilities - TTL-based caching for browser and Node environments
+// =============================================================================
+// In-memory cache store
+const memoryCache = new Map();
+/**
+ * Get cached value or fetch fresh.
+ *
+ * @param key - Cache key
+ * @param fetcher - Async function to fetch fresh data
+ * @param options - Cache options
+ * @returns Cached or fresh value
+ *
+ * @example
+ * ```typescript
+ * const apps = await cache.getOrFetch(
+ *   `apps:${collectionId}`,
+ *   () => collection.getApps(collectionId),
+ *   { ttl: 5 * 60 * 1000, storage: 'session' }
+ * );
+ * ```
+ */
+export async function getOrFetch(key, fetcher, options = {}) {
+    const { ttl = 5 * 60 * 1000, storage = 'memory' } = options;
+    const now = Date.now();
+    // Try to get from cache
+    const cached = getFromStorage(key, storage);
+    if (cached && cached.expiresAt > now) {
+        return cached.value;
+    }
+    // Fetch fresh data
+    const value = await fetcher();
+    // Store in cache
+    const entry = {
+        value,
+        expiresAt: now + ttl,
+    };
+    setToStorage(key, entry, storage);
+    return value;
+}
+/**
+ * Invalidate a cached key.
+ */
+export function invalidate(key) {
+    // Remove from all storage backends
+    memoryCache.delete(key);
+    try {
+        if (typeof sessionStorage !== 'undefined') {
+            sessionStorage.removeItem(`smartlinks:cache:${key}`);
+        }
+        if (typeof localStorage !== 'undefined') {
+            localStorage.removeItem(`smartlinks:cache:${key}`);
+        }
+    }
+    catch (_a) {
+        // Storage may not be available
+    }
+}
+/**
+ * Clear all cached data.
+ */
+export function clear() {
+    memoryCache.clear();
+    try {
+        if (typeof sessionStorage !== 'undefined') {
+            // Clear only smartlinks cache keys
+            const sessionKeys = Object.keys(sessionStorage).filter(k => k.startsWith('smartlinks:cache:'));
+            sessionKeys.forEach(k => sessionStorage.removeItem(k));
+        }
+        if (typeof localStorage !== 'undefined') {
+            const localKeys = Object.keys(localStorage).filter(k => k.startsWith('smartlinks:cache:'));
+            localKeys.forEach(k => localStorage.removeItem(k));
+        }
+    }
+    catch (_a) {
+        // Storage may not be available
+    }
+}
+// =============================================================================
+// Internal Helpers
+// =============================================================================
+function getFromStorage(key, storage) {
+    try {
+        if (storage === 'memory') {
+            return memoryCache.get(key) || null;
+        }
+        const storageKey = `smartlinks:cache:${key}`;
+        let stored = null;
+        if (storage === 'session' && typeof sessionStorage !== 'undefined') {
+            stored = sessionStorage.getItem(storageKey);
+        }
+        else if (storage === 'local' && typeof localStorage !== 'undefined') {
+            stored = localStorage.getItem(storageKey);
+        }
+        if (stored) {
+            return JSON.parse(stored);
+        }
+    }
+    catch (_a) {
+        // Storage errors - return null
+    }
+    return null;
+}
+function setToStorage(key, entry, storage) {
+    try {
+        if (storage === 'memory') {
+            memoryCache.set(key, entry);
+            return;
+        }
+        const storageKey = `smartlinks:cache:${key}`;
+        const serialized = JSON.stringify(entry);
+        if (storage === 'session' && typeof sessionStorage !== 'undefined') {
+            sessionStorage.setItem(storageKey, serialized);
+        }
+        else if (storage === 'local' && typeof localStorage !== 'undefined') {
+            localStorage.setItem(storageKey, serialized);
+        }
+        // Also keep in memory for faster access
+        memoryCache.set(key, entry);
+    }
+    catch (_a) {
+        // Storage quota exceeded or not available - keep in memory only
+        memoryCache.set(key, entry);
+    }
+}

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.3.8  |  Generated: 2026-02-05T19:14:34.871Z
+Version: 1.3.9  |  Generated: 2026-02-05T20:01:56.914Z
 
 This is a concise summary of all available API functions and types.
 
@@ -1489,6 +1489,165 @@ interface ErrorResponse {
 }
 ```
 
+### iframeResponder
+
+**CachedData** (interface)
+```typescript
+interface CachedData {
+  collection?: Record<string, any>;
+  product?: Record<string, any>;
+  proof?: Record<string, any>;
+  user?: {
+  uid: string;
+  email?: string;
+  displayName?: string;
+  accountData?: Record<string, any>;
+  } | null;
+  apps?: AppConfig[];
+}
+```
+
+**IframeResponderOptions** (interface)
+```typescript
+interface IframeResponderOptions {
+  collectionId: string;
+  appId: string;
+  productId?: string;
+  proofId?: string;
+  version?: string;
+  appUrl?: string;
+  initialPath?: string;
+  isAdmin?: boolean;
+  cache?: CachedData;
+  onAuthLogin?: (
+  token: string,
+  user: any,
+  accountData?: Record<string, any>
+  ) => Promise<void>;
+  onAuthLogout?: () => Promise<void>;
+  onRouteChange?: (path: string, state: Record<string, string>) => void;
+  onResize?: (height: number) => void;
+  onError?: (error: Error) => void;
+  onReady?: () => void;
+}
+```
+
+**RouteChangeMessage** (interface)
+```typescript
+interface RouteChangeMessage {
+  type: 'smartlinks-route-change';
+  path: string;
+  context: Record<string, string>;
+  state: Record<string, string>;
+  appId?: string;
+}
+```
+
+**SmartlinksIframeMessage** (interface)
+```typescript
+interface SmartlinksIframeMessage {
+  _smartlinksIframeMessage: true;
+  type:
+  | 'smartlinks:resize'
+  | 'smartlinks:redirect'
+  | 'smartlinks:authkit:login'
+  | 'smartlinks:authkit:logout'
+  | 'smartlinks:authkit:redirect';
+  payload: Record<string, any>;
+  messageId?: string;
+}
+```
+
+**ProxyRequest** (interface)
+```typescript
+interface ProxyRequest {
+  _smartlinksProxyRequest: true;
+  id: string;
+  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+  path: string;
+  body?: any;
+  headers?: Record<string, string>;
+}
+```
+
+**CustomProxyRequest** (interface)
+```typescript
+interface CustomProxyRequest {
+  _smartlinksProxyRequest: true;
+  _smartlinksCustomProxyRequest: true;
+  id: string;
+  request: 'REDIRECT' | string;
+  params: Record<string, any>;
+}
+```
+
+**ProxyResponse** (interface)
+```typescript
+interface ProxyResponse {
+  _smartlinksProxyResponse: true;
+  id: string;
+  data?: any;
+  error?: string;
+}
+```
+
+**UploadStartMessage** (interface)
+```typescript
+interface UploadStartMessage {
+  _smartlinksProxyUpload: true;
+  phase: 'start';
+  id: string;
+  fields: [string, string][];
+  fileInfo: { type?: string; name?: string; key?: string };
+  path: string;
+  headers?: Record<string, string>;
+}
+```
+
+**UploadChunkMessage** (interface)
+```typescript
+interface UploadChunkMessage {
+  _smartlinksProxyUpload: true;
+  phase: 'chunk';
+  id: string;
+  seq: number;
+  chunk: ArrayBuffer;
+}
+```
+
+**UploadEndMessage** (interface)
+```typescript
+interface UploadEndMessage {
+  _smartlinksProxyUpload: true;
+  phase: 'end';
+  id: string;
+}
+```
+
+**UploadAckMessage** (interface)
+```typescript
+interface UploadAckMessage {
+  _smartlinksProxyUpload: true;
+  phase: 'ack';
+  id: string;
+  seq: number;
+}
+```
+
+**UploadDoneMessage** (interface)
+```typescript
+interface UploadDoneMessage {
+  _smartlinksProxyUpload: true;
+  phase: 'done';
+  id: string;
+  ok: boolean;
+  data?: any;
+  error?: string;
+}
+```
+
+**UploadMessage** = ``
+
 ### interaction
 
 **AdminInteractionsQueryRequest** (interface)