krisspy-sdk 0.6.0 → 0.7.0

package/README.md

@@ -17,14 +17,37 @@ pnpm add @krisspy/sdk
 ## Quick Start
 
 ```typescript
-import { createClient } from '@krisspy/sdk'
+import { createClient } from 'krisspy-sdk'
 
 const krisspy = createClient({
   backendId: 'your-backend-id',
-  apiKey: 'your-api-key', // optional for public access
+  apiKey: 'your-api-key',
 })
 ```
 
+### React Native / Expo
+
+When using AsyncStorage, call `initialize()` before accessing auth state:
+
+```typescript
+import { createClient } from 'krisspy-sdk'
+import AsyncStorage from '@react-native-async-storage/async-storage'
+
+const krisspy = createClient({
+  backendId: 'your-backend-id',
+  apiKey: 'your-api-key',
+  storage: AsyncStorage,
+})
+
+// Required — waits for cached session to load from AsyncStorage
+await krisspy.initialize()
+
+// Now safe to use
+const user = krisspy.auth.user()
+```
+
+On web (localStorage is synchronous), `initialize()` resolves instantly — calling it is optional but harmless.
+
 ## Authentication
 
 ### Sign Up
@@ -227,15 +250,19 @@ console.log('Products:', data)
 const krisspy = createClient({
   // Required
   backendId: 'your-backend-id',
+  apiKey: 'your-api-key',
 
   // Optional
   url: 'https://api.krisspy.ai', // Custom API URL
-  apiKey: 'your-api-key',        // For authenticated requests
+  storage: AsyncStorage,          // React Native: session persistence
   headers: {                      // Custom headers
     'X-Custom-Header': 'value'
   },
   debug: true,                    // Enable debug logging
 })
+
+// React Native only — wait for cached session
+await krisspy.initialize()
 ```
 
 ## License

package/dist/index.d.mts

@@ -238,7 +238,16 @@ declare class KrisspyAuth {
     private listeners;
     private refreshInterval?;
     private storage;
+    /** Resolves when session restoration is complete (including async storage) */
+    private _initialized;
+    private _resolveInit;
     constructor(http: HttpClient, backendId: string, storage?: StorageAdapter);
+    /**
+     * Wait until session has been restored from storage.
+     * On web (localStorage), this resolves immediately.
+     * On React Native (AsyncStorage), this waits for the async read to complete.
+     */
+    initialize(): Promise<void>;
     /**
      * Get current session from storage
      */
@@ -975,6 +984,17 @@ declare class KrisspyClient {
     private dataMode;
     private debug;
     constructor(options: KrisspyClientOptions);
+    /**
+     * Wait until the client is fully initialized (session restored from storage).
+     * **Required on React Native / Expo** when using AsyncStorage.
+     * On web (localStorage), this resolves instantly.
+     *
+     * @example
+     * const krisspy = createClient({ backendId: '...', apiKey: '...' });
+     * await krisspy.initialize(); // wait for cached session to load
+     * const user = krisspy.auth.user(); // now safe to use
+     */
+    initialize(): Promise<void>;
     /**
      * Auth module for user authentication
      *
@@ -1213,11 +1233,19 @@ declare class KrisspyClient {
  * @returns KrisspyClient instance
  *
  * @example
+ * // Web (localStorage is sync — works immediately)
+ * const krisspy = createClient({
+ *   backendId: 'abc123',
+ *   apiKey: 'your-api-key',
+ * })
+ *
+ * // React Native / Expo (AsyncStorage is async — call initialize())
  * const krisspy = createClient({
  *   backendId: 'abc123',
  *   apiKey: 'your-api-key',
- *   url: 'https://krisspy-cloud-backend.thankfulhill-66fc9e74.westeurope.azurecontainerapps.io', // optional
+ *   storage: AsyncStorage,
  * })
+ * await krisspy.initialize() // wait for cached session to load
  */
 declare function createClient(options: KrisspyClientOptions): KrisspyClient;
 

package/dist/index.d.ts

@@ -238,7 +238,16 @@ declare class KrisspyAuth {
     private listeners;
     private refreshInterval?;
     private storage;
+    /** Resolves when session restoration is complete (including async storage) */
+    private _initialized;
+    private _resolveInit;
     constructor(http: HttpClient, backendId: string, storage?: StorageAdapter);
+    /**
+     * Wait until session has been restored from storage.
+     * On web (localStorage), this resolves immediately.
+     * On React Native (AsyncStorage), this waits for the async read to complete.
+     */
+    initialize(): Promise<void>;
     /**
      * Get current session from storage
      */
@@ -975,6 +984,17 @@ declare class KrisspyClient {
     private dataMode;
     private debug;
     constructor(options: KrisspyClientOptions);
+    /**
+     * Wait until the client is fully initialized (session restored from storage).
+     * **Required on React Native / Expo** when using AsyncStorage.
+     * On web (localStorage), this resolves instantly.
+     *
+     * @example
+     * const krisspy = createClient({ backendId: '...', apiKey: '...' });
+     * await krisspy.initialize(); // wait for cached session to load
+     * const user = krisspy.auth.user(); // now safe to use
+     */
+    initialize(): Promise<void>;
     /**
      * Auth module for user authentication
      *
@@ -1213,11 +1233,19 @@ declare class KrisspyClient {
  * @returns KrisspyClient instance
  *
  * @example
+ * // Web (localStorage is sync — works immediately)
+ * const krisspy = createClient({
+ *   backendId: 'abc123',
+ *   apiKey: 'your-api-key',
+ * })
+ *
+ * // React Native / Expo (AsyncStorage is async — call initialize())
  * const krisspy = createClient({
  *   backendId: 'abc123',
  *   apiKey: 'your-api-key',
- *   url: 'https://krisspy-cloud-backend.thankfulhill-66fc9e74.westeurope.azurecontainerapps.io', // optional
+ *   storage: AsyncStorage,
  * })
+ * await krisspy.initialize() // wait for cached session to load
  */
 declare function createClient(options: KrisspyClientOptions): KrisspyClient;
 

package/dist/index.js

@@ -273,8 +273,19 @@ var KrisspyAuth = class {
     this.http = http;
     this.backendId = backendId;
     this.storage = resolveStorage(storage);
+    this._initialized = new Promise((resolve) => {
+      this._resolveInit = resolve;
+    });
     this.restoreSession();
   }
+  /**
+   * Wait until session has been restored from storage.
+   * On web (localStorage), this resolves immediately.
+   * On React Native (AsyncStorage), this waits for the async read to complete.
+   */
+  async initialize() {
+    return this._initialized;
+  }
   /**
    * Get current session from storage
    */
@@ -285,12 +296,18 @@ var KrisspyAuth = class {
         result.then((stored) => {
           if (stored) this.hydrateSession(stored);
         }).catch(() => {
+        }).finally(() => {
+          this._resolveInit();
         });
-      } else if (result) {
-        this.hydrateSession(result);
+      } else {
+        if (result) {
+          this.hydrateSession(result);
+        }
+        this._resolveInit();
       }
     } catch (err) {
       console.warn("[Krisspy Auth] Failed to restore session:", err);
+      this._resolveInit();
     }
   }
   hydrateSession(stored) {
@@ -1780,6 +1797,19 @@ var KrisspyClient = class {
       }
     });
   }
+  /**
+   * Wait until the client is fully initialized (session restored from storage).
+   * **Required on React Native / Expo** when using AsyncStorage.
+   * On web (localStorage), this resolves instantly.
+   *
+   * @example
+   * const krisspy = createClient({ backendId: '...', apiKey: '...' });
+   * await krisspy.initialize(); // wait for cached session to load
+   * const user = krisspy.auth.user(); // now safe to use
+   */
+  async initialize() {
+    await this._auth.initialize();
+  }
   /**
    * Auth module for user authentication
    *

package/dist/index.mjs

@@ -239,8 +239,19 @@ var KrisspyAuth = class {
     this.http = http;
     this.backendId = backendId;
     this.storage = resolveStorage(storage);
+    this._initialized = new Promise((resolve) => {
+      this._resolveInit = resolve;
+    });
     this.restoreSession();
   }
+  /**
+   * Wait until session has been restored from storage.
+   * On web (localStorage), this resolves immediately.
+   * On React Native (AsyncStorage), this waits for the async read to complete.
+   */
+  async initialize() {
+    return this._initialized;
+  }
   /**
    * Get current session from storage
    */
@@ -251,12 +262,18 @@ var KrisspyAuth = class {
         result.then((stored) => {
           if (stored) this.hydrateSession(stored);
         }).catch(() => {
+        }).finally(() => {
+          this._resolveInit();
         });
-      } else if (result) {
-        this.hydrateSession(result);
+      } else {
+        if (result) {
+          this.hydrateSession(result);
+        }
+        this._resolveInit();
       }
     } catch (err) {
       console.warn("[Krisspy Auth] Failed to restore session:", err);
+      this._resolveInit();
     }
   }
   hydrateSession(stored) {
@@ -1746,6 +1763,19 @@ var KrisspyClient = class {
       }
     });
   }
+  /**
+   * Wait until the client is fully initialized (session restored from storage).
+   * **Required on React Native / Expo** when using AsyncStorage.
+   * On web (localStorage), this resolves instantly.
+   *
+   * @example
+   * const krisspy = createClient({ backendId: '...', apiKey: '...' });
+   * await krisspy.initialize(); // wait for cached session to load
+   * const user = krisspy.auth.user(); // now safe to use
+   */
+  async initialize() {
+    await this._auth.initialize();
+  }
   /**
    * Auth module for user authentication
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "krisspy-sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Krisspy Cloud SDK - Database, Auth, Storage, and Functions for your apps",
   "main": "dist/index.js",
   "module": "dist/index.mjs",