@umituz/react-native-gamification 1.4.1 → 1.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-gamification",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "Generic gamification system for React Native apps - achievements, points, levels, streaks with customizable UI components",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -51,4 +51,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}

package/src/store/gamificationStore.ts

@@ -3,9 +3,7 @@
  * Zustand store with persist middleware
  */
 
-import { create } from "zustand";
-import { persist, createJSONStorage } from "zustand/middleware";
-import AsyncStorage from "@react-native-async-storage/async-storage";
+import { createStore } from "@umituz/react-native-storage";
 import type {
   GamificationState,
   GamificationActions,
@@ -34,134 +32,131 @@ const DEFAULT_STATE: GamificationState = {
 
 let currentConfig: GamificationConfig | null = null;
 
-export const useGamificationStore = create<
-  GamificationState & GamificationActions
->()(
-  persist(
-    (set, get) => ({
-      ...DEFAULT_STATE,
-
-      initialize: async (config: GamificationConfig) => {
-        currentConfig = config;
-        const state = get();
-
-        // Initialize achievements from config
-        const achievements: Achievement[] = config.achievements.map((def) => ({
-          ...def,
-          isUnlocked: false,
-          progress: 0,
-        }));
-
-        // Merge with existing unlocked achievements
-        const mergedAchievements = achievements.map((ach) => {
-          const existing = state.achievements.find((a) => a.id === ach.id);
-          if (existing) {
-            return { ...ach, isUnlocked: existing.isUnlocked, progress: existing.progress };
-          }
-          return ach;
-        });
-
-        set({ achievements: mergedAchievements, isInitialized: true });
-      },
-
-      addPoints: (amount: number) => {
-        set((state) => ({ points: state.points + amount }));
-      },
-
-      completeTask: () => {
-        const state = get();
-        const pointsToAdd = currentConfig?.pointsPerAction ?? 15;
-
-        set({
-          totalTasksCompleted: state.totalTasksCompleted + 1,
-          points: state.points + pointsToAdd,
-        });
-
-        // Update streak
-        get().updateStreak();
-
-        // Check achievements
-        get().checkAchievements();
-      },
-
-      updateStreak: () => {
-        const state = get();
-        const now = new Date();
-        const lastDate = state.streak.lastActivityDate
-          ? new Date(state.streak.lastActivityDate)
-          : null;
-
-        let newStreak = state.streak.current;
-
-        if (!lastDate || !isSameDay(lastDate, now)) {
-          if (isStreakActive(state.streak.lastActivityDate)) {
-            newStreak = state.streak.current + 1;
-          } else {
-            newStreak = 1;
-          }
+export const useGamificationStore = createStore<GamificationState, GamificationActions>({
+  name: "gamification-storage",
+  initialState: DEFAULT_STATE,
+  persist: true,
+  version: 1,
+  partialize: (state) => ({
+    points: state.points,
+    totalTasksCompleted: state.totalTasksCompleted,
+    achievements: state.achievements,
+    streak: state.streak,
+    isLoading: false,
+    isInitialized: false,
+  }),
+  actions: (set, get) => ({
+    initialize: async (config: GamificationConfig) => {
+      currentConfig = config;
+      const state = get();
+
+      // Initialize achievements from config
+      const achievements: Achievement[] = config.achievements.map((def) => ({
+        ...def,
+        isUnlocked: false,
+        progress: 0,
+      }));
+
+      // Merge with existing unlocked achievements
+      const mergedAchievements = achievements.map((ach) => {
+        const existing = state.achievements.find((a) => a.id === ach.id);
+        if (existing) {
+          return { ...ach, isUnlocked: existing.isUnlocked, progress: existing.progress };
         }
+        return ach;
+      });
+
+      set({ achievements: mergedAchievements, isInitialized: true });
+    },
+
+    addPoints: (amount: number) => {
+      const state = get();
+      set({ points: state.points + amount });
+    },
+
+    completeTask: () => {
+      const state = get();
+      const pointsToAdd = currentConfig?.pointsPerAction ?? 15;
+
+      set({
+        totalTasksCompleted: state.totalTasksCompleted + 1,
+        points: state.points + pointsToAdd,
+      });
+
+      // Update streak
+      get().updateStreak();
+
+      // Check achievements
+      get().checkAchievements();
+    },
+
+    updateStreak: () => {
+      const state = get();
+      const now = new Date();
+      const lastDate = state.streak.lastActivityDate
+        ? new Date(state.streak.lastActivityDate)
+        : null;
+
+      let newStreak = state.streak.current;
+
+      if (!lastDate || !isSameDay(lastDate, now)) {
+        if (isStreakActive(state.streak.lastActivityDate)) {
+          newStreak = state.streak.current + 1;
+        } else {
+          newStreak = 1;
+        }
+      }
+
+      set({
+        streak: {
+          current: newStreak,
+          longest: Math.max(state.streak.longest, newStreak),
+          lastActivityDate: now.toISOString(),
+        },
+      });
+    },
+
+    checkAchievements: () => {
+      if (!currentConfig) return [];
+
+      const state = get();
+      const newlyUnlocked: Achievement[] = [];
+
+      const updatedAchievements = state.achievements.map((ach) => {
+        if (ach.isUnlocked) return ach;
+
+        const progress = updateAchievementProgress(
+          ach,
+          state.totalTasksCompleted,
+          state.streak.current
+        );
+
+        const shouldUnlock = checkAchievementUnlock(
+          ach,
+          state.totalTasksCompleted,
+          state.streak.current
+        );
+
+        if (shouldUnlock && !ach.isUnlocked) {
+          const unlocked = {
+            ...ach,
+            isUnlocked: true,
+            unlockedAt: new Date().toISOString(),
+            progress: 100,
+          };
+          newlyUnlocked.push(unlocked);
+          return unlocked;
+        }
+
+        return { ...ach, progress };
+      });
+
+      set({ achievements: updatedAchievements });
+      return newlyUnlocked;
+    },
 
-        set({
-          streak: {
-            current: newStreak,
-            longest: Math.max(state.streak.longest, newStreak),
-            lastActivityDate: now.toISOString(),
-          },
-        });
-      },
-
-      checkAchievements: () => {
-        if (!currentConfig) return [];
-
-        const state = get();
-        const newlyUnlocked: Achievement[] = [];
-
-        const updatedAchievements = state.achievements.map((ach) => {
-          if (ach.isUnlocked) return ach;
-
-          const progress = updateAchievementProgress(
-            ach,
-            state.totalTasksCompleted,
-            state.streak.current
-          );
-
-          const shouldUnlock = checkAchievementUnlock(
-            ach,
-            state.totalTasksCompleted,
-            state.streak.current
-          );
-
-          if (shouldUnlock && !ach.isUnlocked) {
-            const unlocked = {
-              ...ach,
-              isUnlocked: true,
-              unlockedAt: new Date().toISOString(),
-              progress: 100,
-            };
-            newlyUnlocked.push(unlocked);
-            return unlocked;
-          }
-
-          return { ...ach, progress };
-        });
-
-        set({ achievements: updatedAchievements });
-        return newlyUnlocked;
-      },
-
-      reset: async () => {
-        set(DEFAULT_STATE);
-      },
-    }),
-    {
-      name: "gamification-storage",
-      storage: createJSONStorage(() => AsyncStorage),
-      partialize: (state) => ({
-        points: state.points,
-        totalTasksCompleted: state.totalTasksCompleted,
-        achievements: state.achievements,
-        streak: state.streak,
-      }),
-    }
-  )
-);
+    reset: async () => {
+      set(DEFAULT_STATE);
+    },
+  }),
+});

package/LICENSE

@@ -1,29 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Ümit UZ
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-
-
-
-
-
-
-

package/README.md

@@ -1,283 +0,0 @@
-# @umituz/react-native-gamification
-
-Comprehensive gamification system for React Native apps with achievements, points, levels, streaks, leaderboards, rewards, and progress tracking.
-
-## Features
-
-- 🏆 **Achievements** - Track and unlock user achievements
-- 💰 **Points System** - Award and manage user points
-- 📈 **Levels** - Experience-based leveling system
-- 🔥 **Streaks** - Track consecutive activities
-- 🏅 **Leaderboards** - Competitive rankings
-- 🎁 **Rewards** - Unlockable rewards system
-- 📊 **Progress Tracking** - Monitor user progress across metrics
-
-## Installation
-
-```bash
-npm install @umituz/react-native-gamification
-```
-
-## Peer Dependencies
-
-- `react` >= 18.2.0
-- `react-native` >= 0.74.0
-- `@umituz/react-native-storage` (latest)
-- `zustand` >= 4.0.0
-
-## Quick Start
-
-```typescript
-import { useGamification, useGamificationInitializer } from '@umituz/react-native-gamification';
-
-function App() {
-  const userId = 'user-123';
-  useGamificationInitializer(userId);
-  
-  const { 
-    achievements, 
-    pointBalance, 
-    level,
-    addPoints,
-    addExperience 
-  } = useGamification();
-
-  // Add points when user completes an action
-  const handleActionComplete = async () => {
-    await addPoints(10, 'action_completed', 'action-id', 'actions', 'Completed action');
-  };
-
-  return (
-    // Your app UI
-  );
-}
-```
-
-## Usage
-
-### Initialization
-
-```typescript
-import { useGamification, useGamificationInitializer } from '@umituz/react-native-gamification';
-
-function MyComponent() {
-  const userId = 'user-123';
-  
-  // Initialize gamification system
-  useGamificationInitializer(userId);
-  
-  const gamification = useGamification();
-  
-  // Check if initialized
-  if (!gamification.isInitialized) {
-    return <Loading />;
-  }
-  
-  return <YourContent />;
-}
-```
-
-### Achievements
-
-```typescript
-import { useAchievements } from '@umituz/react-native-gamification';
-
-function AchievementsScreen() {
-  const { 
-    achievements, 
-    unlockAchievement,
-    updateAchievementProgress 
-  } = useAchievements();
-
-  // Update progress
-  await updateAchievementProgress('achievement-id', 50);
-
-  // Unlock achievement
-  await unlockAchievement('achievement-id');
-
-  return (
-    <View>
-      {achievements.map(achievement => (
-        <AchievementCard key={achievement.id} achievement={achievement} />
-      ))}
-    </View>
-  );
-}
-```
-
-### Points
-
-```typescript
-import { usePoints } from '@umituz/react-native-gamification';
-
-function PointsDisplay() {
-  const { 
-    pointBalance, 
-    addPoints, 
-    deductPoints 
-  } = usePoints();
-
-  // Add points
-  await addPoints(100, 'purchase', 'purchase-id', 'purchases', 'Made a purchase');
-
-  // Deduct points
-  await deductPoints(50, 'reward_claim', 'reward-id', 'Claimed reward');
-
-  return (
-    <Text>Total Points: {pointBalance?.total || 0}</Text>
-  );
-}
-```
-
-### Levels
-
-```typescript
-import { useLevel } from '@umituz/react-native-gamification';
-
-function LevelDisplay() {
-  const { 
-    level, 
-    addExperience 
-  } = useLevel();
-
-  // Add experience
-  await addExperience(50, 'action_completed');
-
-  return (
-    <View>
-      <Text>Level: {level?.currentLevel || 1}</Text>
-      <Text>XP: {level?.currentExperience || 0} / {level?.experienceToNextLevel || 100}</Text>
-      <ProgressBar progress={level?.levelProgress || 0} />
-    </View>
-  );
-}
-```
-
-### Streaks
-
-```typescript
-import { useStreaks } from '@umituz/react-native-gamification';
-
-function StreakDisplay() {
-  const { 
-    streaks, 
-    updateStreakActivity 
-  } = useStreaks();
-
-  // Update streak
-  await updateStreakActivity('daily_login', new Date().toISOString());
-
-  const loginStreak = streaks.find(s => s.type === 'daily_login');
-
-  return (
-    <Text>Login Streak: {loginStreak?.currentStreak || 0} days</Text>
-  );
-}
-```
-
-### Rewards
-
-```typescript
-import { useRewards } from '@umituz/react-native-gamification';
-
-function RewardsScreen() {
-  const { 
-    rewards, 
-    claimReward,
-    getAvailableRewards 
-  } = useRewards();
-
-  const availableRewards = getAvailableRewards();
-
-  const handleClaim = async (rewardId: string) => {
-    const claim = await claimReward(rewardId);
-    if (claim) {
-      console.log('Reward claimed!');
-    }
-  };
-
-  return (
-    <View>
-      {availableRewards.map(reward => (
-        <RewardCard 
-          key={reward.id} 
-          reward={reward}
-          onClaim={() => handleClaim(reward.id)}
-        />
-      ))}
-    </View>
-  );
-}
-```
-
-### Progress Tracking
-
-```typescript
-import { useProgress } from '@umituz/react-native-gamification';
-
-function ProgressTracker() {
-  const { 
-    progress, 
-    updateProgress 
-  } = useProgress();
-
-  // Update progress
-  await updateProgress({
-    userId: 'user-123',
-    metric: 'goals_completed',
-    increment: 1,
-    category: 'goals',
-    period: 'all-time'
-  });
-
-  const goalsProgress = progress.find(p => p.metric === 'goals_completed');
-
-  return (
-    <View>
-      <Text>Goals Completed: {goalsProgress?.currentValue || 0}</Text>
-      <ProgressBar progress={goalsProgress?.progress || 0} />
-    </View>
-  );
-}
-```
-
-## Custom Repository
-
-You can provide a custom repository implementation for app-specific storage:
-
-```typescript
-import { useGamificationRepository } from '@umituz/react-native-gamification';
-import { MyCustomRepository } from './MyCustomRepository';
-
-function App() {
-  const customRepository = new MyCustomRepository();
-  
-  useGamificationRepository(customRepository);
-  
-  // Rest of your app
-}
-```
-
-## Architecture
-
-This package follows Domain-Driven Design (DDD) principles:
-
-- **Domain Layer** - Entities and repository interfaces
-- **Infrastructure Layer** - Repository implementations and stores
-- **Presentation Layer** - React hooks for easy integration
-
-## License
-
-MIT
-
-## Author
-
-Ümit UZ <umit@umituz.com>
-
-
-
-
-
-
-
-