@anuma/sdk 2.0.1 → 2.1.0

package/dist/react/index.cjs

@@ -21447,7 +21447,7 @@ function startObserve(entry, walletAddress) {
   isInitialEmission = false;
 }
 function subscribeUserSettings(database, walletAddress, listener) {
-  if (!walletAddress) return () => void 0;
+  if (!database || !walletAddress) return () => void 0;
   const perDb = getOrCreatePerDb(database);
   let entry = perDb.get(walletAddress);
   if (!entry) {
@@ -21477,17 +21477,18 @@ function subscribeUserSettings(database, walletAddress, listener) {
   };
 }
 function getUserSettingsSnapshot(database, walletAddress) {
-  if (!walletAddress) return EMPTY_SNAPSHOT;
+  if (!database || !walletAddress) return EMPTY_SNAPSHOT;
   return pool.get(database)?.get(walletAddress)?.snapshot ?? EMPTY_SNAPSHOT;
 }
 function patchUserSettingsSnapshot(database, walletAddress, patch) {
-  if (!walletAddress) return;
+  if (!database || !walletAddress) return;
   const entry = pool.get(database)?.get(walletAddress);
   if (!entry) return;
   patchSnapshot(entry, patch);
 }
 
 // src/react/useSettings.ts
+var DB_NOT_READY = "Database not ready";
 function useSettings(options) {
   const { database, walletAddress } = options;
   const subscribe = (0, import_react9.useCallback)(
@@ -21500,24 +21501,25 @@ function useSettings(options) {
   );
   const snapshot = (0, import_react9.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
   const storageCtx = (0, import_react9.useMemo)(
-    () => ({
+    () => database ? {
       database,
       userPreferencesCollection: database.get("userPreferences"),
       modelPreferencesCollection: database.get("modelPreferences")
-    }),
+    } : null,
     [database]
   );
   const legacyStorageCtx = (0, import_react9.useMemo)(
-    () => ({
+    () => database ? {
       database,
       modelPreferencesCollection: database.get("modelPreferences")
-    }),
+    } : null,
     [database]
   );
   const getModelPreference = (0, import_react9.useCallback)(
     async (address) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!legacyStorageCtx) throw new Error(DB_NOT_READY);
         const result = await getModelPreferenceOp(legacyStorageCtx, address);
         return result;
       } catch (error) {
@@ -21530,6 +21532,7 @@ function useSettings(options) {
     async (address, models) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!legacyStorageCtx) throw new Error(DB_NOT_READY);
         const result = await setModelPreferenceOp(legacyStorageCtx, address, models);
         if (walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { modelPreference: result });
@@ -21545,6 +21548,7 @@ function useSettings(options) {
     async (address) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!legacyStorageCtx) throw new Error(DB_NOT_READY);
         const deleted = await deleteModelPreferenceOp(legacyStorageCtx, address);
         if (deleted && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { modelPreference: null });
@@ -21560,6 +21564,7 @@ function useSettings(options) {
     async (address) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await getUserPreferenceOp(storageCtx, address);
         return result;
       } catch (error) {
@@ -21572,6 +21577,7 @@ function useSettings(options) {
     async (address, opts) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await setUserPreferenceOp(storageCtx, address, opts);
         if (walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: result });
@@ -21587,6 +21593,7 @@ function useSettings(options) {
     async (address, profile) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await updateProfileOp(storageCtx, address, profile);
         if (result && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: result });
@@ -21602,6 +21609,7 @@ function useSettings(options) {
     async (address, personality) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await updatePersonalityOp(storageCtx, address, personality);
         if (result && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: result });
@@ -21617,6 +21625,7 @@ function useSettings(options) {
     async (address, models) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await updateModelsOp(storageCtx, address, models);
         if (result && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: result });
@@ -21632,6 +21641,7 @@ function useSettings(options) {
     async (address) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const deleted = await deleteUserPreferenceOp(storageCtx, address);
         if (deleted && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: null });

package/dist/react/index.d.mts

@@ -8855,7 +8855,14 @@ interface UpdateModelPreferenceOptions {
  * @inline
  */
 interface BaseUseSettingsOptions {
-    database: Database;
+    /**
+     * The WatermelonDB instance. May be `null` while the database is not yet
+     * bound (e.g. during cold start / logged-out renders on mobile, where the
+     * wrapper holds `null` until the wallet resolves). When `null`, the hook is
+     * inert: `userPreference`/`modelPreference` are `null`, `isLoading` is
+     * `false`, and mutation callbacks reject with a clear error.
+     */
+    database: Database | null;
     walletAddress?: string;
 }
 interface BaseUseSettingsResult {

package/dist/react/index.d.ts

@@ -8855,7 +8855,14 @@ interface UpdateModelPreferenceOptions {
  * @inline
  */
 interface BaseUseSettingsOptions {
-    database: Database;
+    /**
+     * The WatermelonDB instance. May be `null` while the database is not yet
+     * bound (e.g. during cold start / logged-out renders on mobile, where the
+     * wrapper holds `null` until the wallet resolves). When `null`, the hook is
+     * inert: `userPreference`/`modelPreference` are `null`, `isLoading` is
+     * `false`, and mutation callbacks reject with a clear error.
+     */
+    database: Database | null;
     walletAddress?: string;
 }
 interface BaseUseSettingsResult {

package/dist/react/index.mjs

@@ -14142,7 +14142,7 @@ function startObserve(entry, walletAddress) {
   isInitialEmission = false;
 }
 function subscribeUserSettings(database, walletAddress, listener) {
-  if (!walletAddress) return () => void 0;
+  if (!database || !walletAddress) return () => void 0;
   const perDb = getOrCreatePerDb(database);
   let entry = perDb.get(walletAddress);
   if (!entry) {
@@ -14172,17 +14172,18 @@ function subscribeUserSettings(database, walletAddress, listener) {
   };
 }
 function getUserSettingsSnapshot(database, walletAddress) {
-  if (!walletAddress) return EMPTY_SNAPSHOT;
+  if (!database || !walletAddress) return EMPTY_SNAPSHOT;
   return pool.get(database)?.get(walletAddress)?.snapshot ?? EMPTY_SNAPSHOT;
 }
 function patchUserSettingsSnapshot(database, walletAddress, patch) {
-  if (!walletAddress) return;
+  if (!database || !walletAddress) return;
   const entry = pool.get(database)?.get(walletAddress);
   if (!entry) return;
   patchSnapshot(entry, patch);
 }
 
 // src/react/useSettings.ts
+var DB_NOT_READY = "Database not ready";
 function useSettings(options) {
   const { database, walletAddress } = options;
   const subscribe = useCallback7(
@@ -14195,24 +14196,25 @@ function useSettings(options) {
   );
   const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
   const storageCtx = useMemo7(
-    () => ({
+    () => database ? {
       database,
       userPreferencesCollection: database.get("userPreferences"),
       modelPreferencesCollection: database.get("modelPreferences")
-    }),
+    } : null,
     [database]
   );
   const legacyStorageCtx = useMemo7(
-    () => ({
+    () => database ? {
       database,
       modelPreferencesCollection: database.get("modelPreferences")
-    }),
+    } : null,
     [database]
   );
   const getModelPreference = useCallback7(
     async (address) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!legacyStorageCtx) throw new Error(DB_NOT_READY);
         const result = await getModelPreferenceOp(legacyStorageCtx, address);
         return result;
       } catch (error) {
@@ -14225,6 +14227,7 @@ function useSettings(options) {
     async (address, models) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!legacyStorageCtx) throw new Error(DB_NOT_READY);
         const result = await setModelPreferenceOp(legacyStorageCtx, address, models);
         if (walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { modelPreference: result });
@@ -14240,6 +14243,7 @@ function useSettings(options) {
     async (address) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!legacyStorageCtx) throw new Error(DB_NOT_READY);
         const deleted = await deleteModelPreferenceOp(legacyStorageCtx, address);
         if (deleted && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { modelPreference: null });
@@ -14255,6 +14259,7 @@ function useSettings(options) {
     async (address) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await getUserPreferenceOp(storageCtx, address);
         return result;
       } catch (error) {
@@ -14267,6 +14272,7 @@ function useSettings(options) {
     async (address, opts) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await setUserPreferenceOp(storageCtx, address, opts);
         if (walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: result });
@@ -14282,6 +14288,7 @@ function useSettings(options) {
     async (address, profile) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await updateProfileOp(storageCtx, address, profile);
         if (result && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: result });
@@ -14297,6 +14304,7 @@ function useSettings(options) {
     async (address, personality) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await updatePersonalityOp(storageCtx, address, personality);
         if (result && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: result });
@@ -14312,6 +14320,7 @@ function useSettings(options) {
     async (address, models) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const result = await updateModelsOp(storageCtx, address, models);
         if (result && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: result });
@@ -14327,6 +14336,7 @@ function useSettings(options) {
     async (address) => {
       try {
         if (!address) throw new Error("Wallet address is required");
+        if (!storageCtx) throw new Error(DB_NOT_READY);
         const deleted = await deleteUserPreferenceOp(storageCtx, address);
         if (deleted && walletAddress && address === walletAddress) {
           patchUserSettingsSnapshot(database, walletAddress, { userPreference: null });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",