postex-auth-sdk-stage 2.3.1 → 3.0.0

package/README.md

@@ -141,6 +141,8 @@ async initiateAuth(
 **Returns:**
 
 - `status`: `'webauthn_challenge'` | `'otp_sent'`
+- `message`: Backend initiation message
+- `delivery`: OTP delivery metadata when status is `'otp_sent'`
 - `challenge`, `credentialIds`, `rp`: WebAuthn data if status is `'webauthn_challenge'`
 
 ---
@@ -154,7 +156,16 @@ Requires at least one identifier: `email`, `mobileNumber`, or `username`.
 async initiateOTP(
   identifier: string | { email?: string; mobileNumber?: string; username?: string }
 ): Promise<{
+  statusText?: string;
   message?: string;
+  statusCode?: number;
+  success?: boolean;
+  data?: {
+    delivery?: {
+      channel: 'email' | 'sms';
+      target: string;
+    };
+  };
 }>
 ```
 
@@ -193,13 +204,23 @@ async verifyOTP(otp: string): Promise<OTPVerifyResponse>
 Resend OTP code for the standard login OTP flow.
 
 ```typescript
-async resendOTP(): Promise<{ success: boolean; message?: string }>
+async resendOTP(): Promise<{
+  message?: string;
+  success?: boolean;
+  data?: {
+    delivery?: {
+      channel: 'email' | 'sms';
+      target: string;
+    };
+  };
+}>
 ```
 
 **Returns:**
 
-- `success`: Whether resend request was accepted
-- `message`: Optional backend message
+- `message`: Backend resend message
+- `success`: Whether resend request was accepted, when provided by the backend
+- `data.delivery`: OTP delivery channel and masked target
 
 ---
 

package/dist/auth.d.ts

@@ -26,8 +26,15 @@ interface AuthStatusResponse {
 }
 /** Response from POST /auth/initiate */
 type InitiateAuthStatusType = "webauthn_challenge" | "otp_sent";
+type OTPDeliveryChannel = "email" | "sms";
+interface OTPDeliveryMetadata {
+    channel: OTPDeliveryChannel;
+    target: string;
+}
 interface InitiateAuthResponse {
     status: InitiateAuthStatusType;
+    message?: string;
+    delivery?: OTPDeliveryMetadata;
     challenge?: string;
     credentialIds?: string[];
     rp?: {
@@ -50,7 +57,16 @@ interface OTPInitiateResponse {
     success?: boolean;
     message?: string;
     data?: {
-        message?: string;
+        delivery?: OTPDeliveryMetadata;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+interface OTPResendResponse {
+    message?: string;
+    success?: boolean;
+    data?: {
+        delivery?: OTPDeliveryMetadata;
         [key: string]: any;
     };
     [key: string]: any;
@@ -151,7 +167,7 @@ export declare class AuthSDK {
     getStatus(identifier: AuthIdentifierInput, options?: RealmOptions): Promise<AuthStatusResponse>;
     /**
      * POST /auth/initiate - Unified entry: returns webauthn_challenge or otp_sent.
-     * Sets auth_session cookie when otp_sent.
+     * Sets auth_session cookie and includes delivery metadata when otp_sent.
      */
     initiateAuth(identifier: AuthIdentifierInput, options?: RealmOptions): Promise<InitiateAuthResponse>;
     /**
@@ -165,13 +181,10 @@ export declare class AuthSDK {
      */
     verifyOTP(otp: string): Promise<OTPVerifyResponse>;
     /**
-     * POST /resend - Resend OTP code to the user's email.
+     * POST /otp/resend - Resend OTP code to the user's email or mobile number.
      * No payload required, relies on auth_session cookie.
      */
-    resendOTP(): Promise<{
-        success: boolean;
-        message?: string;
-    }>;
+    resendOTP(): Promise<OTPResendResponse>;
     /**
      * POST /otp/signup/verify - Verify OTP for signup flow.
      * Stores tokens from the response when provided by backend.