@pubflow/core 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,119 @@
+# Changelog - @pubflow/core
+
+All notable changes to this project will be documented in this file.
+
+## [0.3.1] - 2025-10-25
+
+### Added
+- Added `PubflowConfig` as type alias for `PubflowInstanceConfig` (backward compatibility)
+- Added `validateOnStartup` field to `SessionConfig` interface (React Native support)
+- Added alternative field names to `PaginationMeta` interface:
+  - `page` (alternative to `currentPage`)
+  - `limit` (alternative to `perPage`)
+  - `total` (alternative to `totalItems`)
+  - `hasMore` (React Native compatibility)
+
+### Changed
+- Made all `PaginationMeta` fields optional for maximum flexibility
+- Updated documentation to reflect both naming conventions
+
+### Fixed
+- Fixed TypeScript compilation errors in `@pubflow/react-native` package
+- Fixed missing exports for React Native compatibility
+
+## [0.3.0] - 2025-10-25
+
+### Added
+- **snake_case Support**: User interface now supports BOTH camelCase and snake_case formats
+- Added snake_case alternatives for all user fields:
+  - `last_name` (alternative to `lastName`)
+  - `user_type` (alternative to `userType`)
+  - `user_name` (alternative to `userName`)
+  - `is_verified` (alternative to `isVerified`)
+  - `two_factor` (alternative to `twoFactor`)
+  - `created_at` (alternative to `createdAt`)
+  - `updated_at` (alternative to `updatedAt`)
+
+### Changed
+- Updated User interface documentation to indicate preferred format (snake_case)
+- Package description updated to reflect snake_case support
+
+### Migration Guide
+This is a **backward compatible** change. No breaking changes.
+
+**For existing applications:**
+- Applications using camelCase will continue to work without changes
+- Applications can now use snake_case format (recommended for new code)
+- Both formats can coexist in the same application
+
+**For new applications:**
+- Use snake_case format for consistency with backend (multi-flowless)
+- Example: `user.user_type` instead of `user.userType`
+
+**Fallback pattern for maximum compatibility:**
+```typescript
+const userType = user.userType || user.user_type || '';
+const lastName = user.lastName || user.last_name || '';
+```
+
+### Why snake_case?
+1. **Performance**: ~44% smaller response size (no dual format needed)
+2. **Industry Standard**: Used by Stripe, GitHub, Google, Twilio
+3. **Multi-language**: Native to Python, Go, Ruby, Rust
+4. **Database Alignment**: Matches database column naming
+5. **Consistency**: One format across the entire stack
+
+---
+
+## [0.2.0] - 2025-XX-XX
+
+### Added
+- Initial release with camelCase support
+- Core authentication functionality
+- Session management
+- Storage abstraction
+
+---
+
+## Migration from 0.2.0 to 0.3.0
+
+### No Action Required
+This is a **non-breaking change**. Your existing code will continue to work.
+
+### Optional: Adopt snake_case
+If you want to adopt the new snake_case format:
+
+1. Update your code to use snake_case fields:
+   ```typescript
+   // Before (still works)
+   const type = user.userType;
+   
+   // After (recommended)
+   const type = user.user_type;
+   
+   // Best (maximum compatibility)
+   const type = user.userType || user.user_type;
+   ```
+
+2. Update your package.json:
+   ```json
+   {
+     "dependencies": {
+       "@pubflow/core": "^0.3.0"
+     }
+   }
+   ```
+
+3. Run: `npm install` or `bun install`
+
+### Testing
+After updating, test your authentication flows:
+- Login
+- Session validation
+- User profile access
+- Dashboard routing (if based on user_type)
+
+---
+
+For more information, see: `static/general-docs/snake-case-migration-guide.md`
+

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from './config';
 export * from './schema/validator';
 export * from './storage/adapter';
 export type { User, SessionConfig, StorageConfig, PubflowInstanceConfig, PaginationMeta } from './types';
+export type { PubflowInstanceConfig as PubflowConfig } from './types';
 export type { LoginCredentials, LoginResult, SessionValidationResult, SessionRefreshResult, RegistrationData, RegistrationResult, PasswordResetRequestData, PasswordResetData, AuthResponse, SessionResponse, ValidationResponse, RefreshResponse } from './auth/types';
 export { ApiClient } from './api/client';
 export { AuthService } from './auth/service';

package/dist/types.d.ts

@@ -3,6 +3,11 @@
  */
 /**
  * User type - Extended to include all Flowless backend fields
+ *
+ * @version 0.3.0 - Added snake_case support for multi-flowless compatibility
+ *
+ * This interface supports BOTH camelCase and snake_case formats for backward compatibility.
+ * The backend (multi-flowless) sends snake_case by default, but this interface accepts both.
  */
 export interface User {
     /**
@@ -18,33 +23,53 @@ export interface User {
      */
     name: string;
     /**
-     * User last name
+     * User last name (camelCase format - legacy)
      */
     lastName?: string;
     /**
-     * User type
+     * User last name (snake_case format - preferred)
+     */
+    last_name?: string;
+    /**
+     * User type (camelCase format - legacy)
      */
     userType: string;
+    /**
+     * User type (snake_case format - preferred)
+     */
+    user_type?: string;
     /**
      * User profile picture URL
      */
     picture?: string;
     /**
-     * Username (unique identifier)
+     * Username (camelCase format - legacy)
      */
     userName?: string;
     /**
-     * Email verification status
+     * Username (snake_case format - preferred)
+     */
+    user_name?: string;
+    /**
+     * Email verification status (camelCase format - legacy)
      */
     isVerified?: boolean;
+    /**
+     * Email verification status (snake_case format - preferred)
+     */
+    is_verified?: boolean;
     /**
      * Phone number for SMS authentication
      */
     phone?: string;
     /**
-     * Two-factor authentication enabled
+     * Two-factor authentication enabled (camelCase format - legacy)
      */
     twoFactor?: boolean;
+    /**
+     * Two-factor authentication enabled (snake_case format - preferred)
+     */
+    two_factor?: boolean;
     /**
      * User language preference (e.g., 'es', 'en', 'fr')
      */
@@ -54,13 +79,21 @@ export interface User {
      */
     metadata?: string;
     /**
-     * Account creation timestamp
+     * Account creation timestamp (camelCase format - legacy)
      */
     createdAt?: string;
     /**
-     * Last update timestamp
+     * Account creation timestamp (snake_case format - preferred)
+     */
+    created_at?: string;
+    /**
+     * Last update timestamp (camelCase format - legacy)
      */
     updatedAt?: string;
+    /**
+     * Last update timestamp (snake_case format - preferred)
+     */
+    updated_at?: string;
     /**
      * Additional user data for extensibility
      *
@@ -102,6 +135,10 @@ export interface SessionConfig {
      * Whether to validate session automatically
      */
     autoValidate?: boolean;
+    /**
+     * Whether to validate session on startup (React Native)
+     */
+    validateOnStartup?: boolean;
     /**
      * Session validation interval in milliseconds
      */
@@ -171,22 +208,46 @@ export interface PubflowInstanceConfig {
 }
 /**
  * Pagination metadata
+ *
+ * @version 0.3.1 - Made all fields optional for maximum flexibility
+ *
+ * Supports multiple naming conventions:
+ * - Standard: currentPage, totalPages, totalItems, perPage
+ * - Alternative: page, limit, total, hasMore (React Native compatibility)
+ *
+ * At least one set of fields should be provided.
  */
 export interface PaginationMeta {
     /**
-     * Current page number
+     * Current page number (standard format)
+     */
+    currentPage?: number;
+    /**
+     * Current page number (alternative format - React Native)
      */
-    currentPage: number;
+    page?: number;
     /**
      * Total number of pages
      */
-    totalPages: number;
+    totalPages?: number;
+    /**
+     * Total number of items (standard format)
+     */
+    totalItems?: number;
+    /**
+     * Total number of items (alternative format - React Native)
+     */
+    total?: number;
+    /**
+     * Number of items per page (standard format)
+     */
+    perPage?: number;
     /**
-     * Total number of items
+     * Number of items per page (alternative format - React Native)
      */
-    totalItems: number;
+    limit?: number;
     /**
-     * Number of items per page
+     * Whether there are more pages available (React Native)
      */
-    perPage: number;
+    hasMore?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pubflow/core",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Core functionality for Pubflow framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",