@wowsql/sdk 3.6.0 → 3.7.0

package/dist/auth.d.ts

@@ -146,6 +146,74 @@ export declare class ProjectAuthClient {
         success: boolean;
         message: string;
     }>;
+    /**
+     * Send OTP code to user's email.
+     *
+     * Supports login, signup, and password_reset purposes.
+     *
+     * @param email - User's email address
+     * @param purpose - Purpose of OTP - 'login', 'signup', or 'password_reset' (default: 'login')
+     * @returns Object with success status and message
+     */
+    sendOtp(email: string, purpose?: 'login' | 'signup' | 'password_reset'): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Verify OTP and complete authentication.
+     *
+     * For signup: Creates new user if doesn't exist
+     * For login: Authenticates existing user
+     * For password_reset: Updates password if newPassword provided
+     *
+     * @param email - User's email address
+     * @param otp - 6-digit OTP code
+     * @param purpose - Purpose of OTP - 'login', 'signup', or 'password_reset' (default: 'login')
+     * @param newPassword - Required for password_reset purpose, new password (minimum 8 characters)
+     * @returns AuthResponse with session tokens and user info (for login/signup) or success message (for password_reset)
+     */
+    verifyOtp(email: string, otp: string, purpose?: 'login' | 'signup' | 'password_reset', newPassword?: string): Promise<AuthResponse | {
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Send magic link to user's email.
+     *
+     * Supports login, signup, and email_verification purposes.
+     *
+     * @param email - User's email address
+     * @param purpose - Purpose of magic link - 'login', 'signup', or 'email_verification' (default: 'login')
+     * @returns Object with success status and message
+     */
+    sendMagicLink(email: string, purpose?: 'login' | 'signup' | 'email_verification'): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Verify email using token (from magic link or OTP verification).
+     *
+     * Marks email as verified and sends welcome email.
+     *
+     * @param token - Verification token from email
+     * @returns Object with success status, message, and user info
+     */
+    verifyEmail(token: string): Promise<{
+        success: boolean;
+        message: string;
+        user?: AuthUser;
+    }>;
+    /**
+     * Resend verification email.
+     *
+     * Always returns success to prevent email enumeration.
+     *
+     * @param email - User's email address
+     * @returns Object with success status and message
+     */
+    resendVerification(email: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
     /**
      * Get the current session tokens.
      */

package/dist/auth.js

@@ -216,6 +216,145 @@ class ProjectAuthClient {
             throw this.toWowError(error);
         }
     }
+    /**
+     * Send OTP code to user's email.
+     *
+     * Supports login, signup, and password_reset purposes.
+     *
+     * @param email - User's email address
+     * @param purpose - Purpose of OTP - 'login', 'signup', or 'password_reset' (default: 'login')
+     * @returns Object with success status and message
+     */
+    async sendOtp(email, purpose = 'login') {
+        if (!['login', 'signup', 'password_reset'].includes(purpose)) {
+            throw new errors_1.WOWSQLError("Purpose must be 'login', 'signup', or 'password_reset'");
+        }
+        try {
+            const response = await this.client.post('/otp/send', {
+                email,
+                purpose
+            });
+            return {
+                success: response.data.success ?? true,
+                message: response.data.message ?? 'If that email exists, an OTP code has been sent'
+            };
+        }
+        catch (error) {
+            throw this.toWowError(error);
+        }
+    }
+    /**
+     * Verify OTP and complete authentication.
+     *
+     * For signup: Creates new user if doesn't exist
+     * For login: Authenticates existing user
+     * For password_reset: Updates password if newPassword provided
+     *
+     * @param email - User's email address
+     * @param otp - 6-digit OTP code
+     * @param purpose - Purpose of OTP - 'login', 'signup', or 'password_reset' (default: 'login')
+     * @param newPassword - Required for password_reset purpose, new password (minimum 8 characters)
+     * @returns AuthResponse with session tokens and user info (for login/signup) or success message (for password_reset)
+     */
+    async verifyOtp(email, otp, purpose = 'login', newPassword) {
+        if (!['login', 'signup', 'password_reset'].includes(purpose)) {
+            throw new errors_1.WOWSQLError("Purpose must be 'login', 'signup', or 'password_reset'");
+        }
+        if (purpose === 'password_reset' && !newPassword) {
+            throw new errors_1.WOWSQLError("newPassword is required for password_reset purpose");
+        }
+        try {
+            const payload = {
+                email,
+                otp,
+                purpose
+            };
+            if (newPassword) {
+                payload.new_password = newPassword;
+            }
+            const response = await this.client.post('/otp/verify', payload);
+            if (purpose === 'password_reset') {
+                return {
+                    success: response.data.success ?? true,
+                    message: response.data.message ?? 'Password reset successfully! You can now login with your new password'
+                };
+            }
+            const session = this.persistSession(response.data);
+            const user = response.data.user ? mapUser(response.data.user) : undefined;
+            return { user, session };
+        }
+        catch (error) {
+            throw this.toWowError(error);
+        }
+    }
+    /**
+     * Send magic link to user's email.
+     *
+     * Supports login, signup, and email_verification purposes.
+     *
+     * @param email - User's email address
+     * @param purpose - Purpose of magic link - 'login', 'signup', or 'email_verification' (default: 'login')
+     * @returns Object with success status and message
+     */
+    async sendMagicLink(email, purpose = 'login') {
+        if (!['login', 'signup', 'email_verification'].includes(purpose)) {
+            throw new errors_1.WOWSQLError("Purpose must be 'login', 'signup', or 'email_verification'");
+        }
+        try {
+            const response = await this.client.post('/magic-link/send', {
+                email,
+                purpose
+            });
+            return {
+                success: response.data.success ?? true,
+                message: response.data.message ?? 'If that email exists, a magic link has been sent'
+            };
+        }
+        catch (error) {
+            throw this.toWowError(error);
+        }
+    }
+    /**
+     * Verify email using token (from magic link or OTP verification).
+     *
+     * Marks email as verified and sends welcome email.
+     *
+     * @param token - Verification token from email
+     * @returns Object with success status, message, and user info
+     */
+    async verifyEmail(token) {
+        try {
+            const response = await this.client.post('/verify-email', { token });
+            return {
+                success: response.data.success ?? true,
+                message: response.data.message ?? 'Email verified successfully!',
+                user: response.data.user ? mapUser(response.data.user) : undefined
+            };
+        }
+        catch (error) {
+            throw this.toWowError(error);
+        }
+    }
+    /**
+     * Resend verification email.
+     *
+     * Always returns success to prevent email enumeration.
+     *
+     * @param email - User's email address
+     * @returns Object with success status and message
+     */
+    async resendVerification(email) {
+        try {
+            const response = await this.client.post('/resend-verification', { email });
+            return {
+                success: response.data.success ?? true,
+                message: response.data.message ?? 'If that email exists, a verification email has been sent'
+            };
+        }
+        catch (error) {
+            throw this.toWowError(error);
+        }
+    }
     /**
      * Get the current session tokens.
      */

package/dist/index.d.ts

@@ -144,6 +144,10 @@ export declare class Table<T = any> {
      * Create a new record
      */
     create(data: Partial<T>): Promise<CreateResponse>;
+    /**
+     * Insert a new record (alias for create)
+     */
+    insert(data: Partial<T>): Promise<CreateResponse>;
     /**
      * Update a record by ID
      */
@@ -202,10 +206,70 @@ export declare class QueryBuilder<T = any> {
      * Skip records (pagination)
      */
     offset(offset: number): this;
+    /**
+     * Filter where column equals value
+     */
+    eq(column: string, value: any): this;
+    /**
+     * Filter where column does not equal value
+     */
+    neq(column: string, value: any): this;
+    /**
+     * Filter where column is greater than value
+     */
+    gt(column: string, value: any): this;
+    /**
+     * Filter where column is greater than or equal to value
+     */
+    gte(column: string, value: any): this;
+    /**
+     * Filter where column is less than value
+     */
+    lt(column: string, value: any): this;
+    /**
+     * Filter where column is less than or equal to value
+     */
+    lte(column: string, value: any): this;
+    /**
+     * Filter where column matches pattern (SQL LIKE)
+     */
+    like(column: string, value: string): this;
+    /**
+     * Filter where column IS NULL
+     */
+    isNull(column: string): this;
+    /**
+     * Filter where column IS NOT NULL
+     */
+    isNotNull(column: string): this;
+    /**
+     * Filter where column is in list of values
+     */
+    in(column: string, values: any[]): this;
+    /**
+     * Filter where column is not in list of values
+     */
+    notIn(column: string, values: any[]): this;
+    /**
+     * Filter where column is between min and max values
+     */
+    between(column: string, minValue: any, maxValue: any): this;
+    /**
+     * Filter where column is not between min and max values
+     */
+    notBetween(column: string, minValue: any, maxValue: any): this;
+    /**
+     * Add an OR filter condition
+     */
+    or(column: string, operator: FilterExpression['operator'], value: any): this;
     /**
      * Execute query - uses POST /{table}/query for advanced features, GET for simple queries
      */
     get(additionalOptions?: QueryOptions): Promise<QueryResponse<T>>;
+    /**
+     * Execute the query (alias for get)
+     */
+    execute(additionalOptions?: QueryOptions): Promise<QueryResponse<T>>;
     /**
      * Get first record
      */

package/dist/index.js

@@ -148,6 +148,12 @@ class Table {
         const response = await this.client.post(`/${this.tableName}`, data);
         return response.data;
     }
+    /**
+     * Insert a new record (alias for create)
+     */
+    async insert(data) {
+        return this.create(data);
+    }
     /**
      * Update a record by ID
      */
@@ -272,6 +278,91 @@ class QueryBuilder {
         this.options.offset = offset;
         return this;
     }
+    // ==================== Convenience Methods ====================
+    /**
+     * Filter where column equals value
+     */
+    eq(column, value) {
+        return this.filter(column, 'eq', value);
+    }
+    /**
+     * Filter where column does not equal value
+     */
+    neq(column, value) {
+        return this.filter(column, 'neq', value);
+    }
+    /**
+     * Filter where column is greater than value
+     */
+    gt(column, value) {
+        return this.filter(column, 'gt', value);
+    }
+    /**
+     * Filter where column is greater than or equal to value
+     */
+    gte(column, value) {
+        return this.filter(column, 'gte', value);
+    }
+    /**
+     * Filter where column is less than value
+     */
+    lt(column, value) {
+        return this.filter(column, 'lt', value);
+    }
+    /**
+     * Filter where column is less than or equal to value
+     */
+    lte(column, value) {
+        return this.filter(column, 'lte', value);
+    }
+    /**
+     * Filter where column matches pattern (SQL LIKE)
+     */
+    like(column, value) {
+        return this.filter(column, 'like', value);
+    }
+    /**
+     * Filter where column IS NULL
+     */
+    isNull(column) {
+        return this.filter(column, 'is', null);
+    }
+    /**
+     * Filter where column IS NOT NULL
+     */
+    isNotNull(column) {
+        return this.filter(column, 'is_not', null);
+    }
+    /**
+     * Filter where column is in list of values
+     */
+    in(column, values) {
+        return this.filter(column, 'in', values);
+    }
+    /**
+     * Filter where column is not in list of values
+     */
+    notIn(column, values) {
+        return this.filter(column, 'not_in', values);
+    }
+    /**
+     * Filter where column is between min and max values
+     */
+    between(column, minValue, maxValue) {
+        return this.filter(column, 'between', [minValue, maxValue]);
+    }
+    /**
+     * Filter where column is not between min and max values
+     */
+    notBetween(column, minValue, maxValue) {
+        return this.filter(column, 'not_between', [minValue, maxValue]);
+    }
+    /**
+     * Add an OR filter condition
+     */
+    or(column, operator, value) {
+        return this.filter(column, operator, value, 'OR');
+    }
     /**
      * Execute query - uses POST /{table}/query for advanced features, GET for simple queries
      */
@@ -366,6 +457,12 @@ class QueryBuilder {
             return response.data;
         }
     }
+    /**
+     * Execute the query (alias for get)
+     */
+    async execute(additionalOptions) {
+        return this.get(additionalOptions);
+    }
     /**
      * Get first record
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowsql/sdk",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "Official TypeScript/JavaScript SDK for WowSQL - MySQL Backend-as-a-Service with S3 Storage, type-safe queries and fluent API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",