@insforge/sdk 1.2.1-dev.1 → 1.2.2

package/README.md

@@ -46,7 +46,8 @@ const insforge = createClient({
 const { data, error } = await insforge.auth.signUp({
   email: 'user@example.com',
   password: 'securePassword123',
-  name: 'John Doe' // optional
+  name: 'John Doe', // optional
+  redirectTo: 'http://localhost:3000/sign-in' // optional, recommended for link-based verification
 });
 
 // Sign in with email/password
@@ -61,8 +62,8 @@ await insforge.auth.signInWithOAuth({
   redirectTo: 'http://localhost:3000/dashboard'
 });
 
-// Get current user
-const { data: user } = await insforge.auth.getCurrentUser();
+// Get current user (call this during browser app startup)
+const { data: currentUser } = await insforge.auth.getCurrentUser();
 
 // Get any user's profile by ID (public endpoint)
 const { data: profile, error } = await insforge.auth.getProfile('user-id-here');
@@ -78,6 +79,51 @@ const { data: updatedProfile, error } = await insforge.auth.setProfile({
 await insforge.auth.signOut();
 ```
 
+### Email Verification And Password Reset
+
+```javascript
+// Resend a verification email
+await insforge.auth.resendVerificationEmail({
+  email: 'user@example.com',
+  redirectTo: 'http://localhost:3000/sign-in' // optional, recommended for link-based verification
+});
+
+// Verify email with a 6-digit code
+await insforge.auth.verifyEmail({
+  email: 'user@example.com',
+  otp: '123456'
+});
+
+// Send password reset email
+await insforge.auth.sendResetPasswordEmail({
+  email: 'user@example.com',
+  redirectTo: 'http://localhost:3000/reset-password' // optional, recommended for link-based reset
+});
+
+// Code-based reset flow: exchange the code, then reset the password
+const { data: resetToken } = await insforge.auth.exchangeResetPasswordToken({
+  email: 'user@example.com',
+  code: '123456'
+});
+
+if (resetToken) {
+  await insforge.auth.resetPassword({
+    newPassword: 'newSecurePassword123',
+    otp: resetToken.token
+  });
+}
+```
+
+For link-based verification and password reset, users click the emailed browser links:
+- `GET /api/auth/email/verify-link`
+- `GET /api/auth/email/reset-password-link`
+
+Those backend endpoints validate the token first, then redirect the browser to your `redirectTo` URL.
+
+- Verification links redirect with `insforge_status=success|error`, `insforge_type=verify_email`, and optional `insforge_error`
+- Recommended: use your sign-in page as the verification `redirectTo`, then show a confirmation message and ask the user to sign in with email and password
+- Reset links redirect with `token` when ready, plus `insforge_status=ready|error`, `insforge_type=reset_password`, and optional `insforge_error`
+
 ### Database Operations
 
 ```javascript
@@ -201,14 +247,14 @@ const insforge = createClient({
 The SDK is written in TypeScript and provides full type definitions:
 
 ```typescript
-import { createClient, InsForgeClient, User, Session } from '@insforge/sdk';
+import { createClient, InsForgeClient } from '@insforge/sdk';
 
 const insforge: InsForgeClient = createClient({
   baseUrl: 'http://localhost:7130'
 });
 
 // Type-safe API calls
-const response: { data: User | null; error: Error | null } =
+const response =
   await insforge.auth.getCurrentUser();
 ```
 

package/dist/index.js

@@ -1112,7 +1112,7 @@ var Auth = class {
     } catch (error) {
       return wrapError(
         error,
-        "An unexpected error occurred while sending verification code"
+        "An unexpected error occurred while sending verification email"
       );
     }
   }
@@ -1145,7 +1145,7 @@ var Auth = class {
     } catch (error) {
       return wrapError(
         error,
-        "An unexpected error occurred while sending password reset code"
+        "An unexpected error occurred while sending password reset email"
       );
     }
   }