@djangocfg/api 1.2.1 → 1.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/api",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "author": {
     "name": "DjangoCFG",
     "url": "https://djangocfg.com"
@@ -68,7 +68,7 @@
     "@types/node": "^22.15.3",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.1",
-    "@djangocfg/typescript-config": "^1.2.1",
+    "@djangocfg/typescript-config": "^1.2.2",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "tsup": "^8.5.0",

package/src/cfg/services_deprecated/README.md

@@ -0,0 +1,53 @@
+# ⚠️ DEPRECATED: Services
+
+This directory contains **deprecated** service implementations.
+
+## Migration Guide
+
+**Old approach (deprecated):**
+```typescript
+import { AuthService } from '@djangocfg/api';
+
+// Direct service calls
+const result = await AuthService.verifyOTP(email, code);
+```
+
+**New approach (recommended):**
+```typescript
+import { AccountsProvider, useAccountsContext } from '@djangocfg/api/cfg/contexts';
+
+function MyComponent() {
+  return (
+    <AccountsProvider>
+      <ProfileComponent />
+    </AccountsProvider>
+  );
+}
+
+function ProfileComponent() {
+  const { profile, isLoading, error } = useAccountsContext();
+  // Use context data with SWR caching
+}
+```
+
+## Why migrate?
+
+1. **SWR Integration**: Contexts use SWR for automatic caching, revalidation, and optimistic updates
+2. **React-first**: Built for React components with hooks
+3. **Type-safe**: Full TypeScript support with generated types
+4. **Better UX**: Automatic loading states, error handling, and data synchronization
+
+## Available Contexts
+
+- `AccountsProvider` / `useAccountsContext` - User profile management
+- More contexts coming soon...
+
+## Deprecation Timeline
+
+- ✅ **Now**: Both services and contexts are available
+- 🔄 **Future**: Services will be removed in next major version
+- 📝 **Action**: Migrate to contexts before upgrading
+
+## Need Help?
+
+Check the contexts documentation in `/packages/api/src/cfg/contexts/README.md`

package/src/index.ts

@@ -31,8 +31,8 @@ export * from './cfg/generated';
 export { api } from './cfg/BaseClient';
 export { api as default } from './cfg/BaseClient';
 
-// Export all services (recommended usage)
-export * from './cfg/services';
+// Export all services (deprecated - use contexts instead)
+export * from './cfg/services_deprecated';
 
 // Export all contexts (React contexts for data management)
 export * from './cfg/contexts';