@minimoth/sdk-node 0.1.1 → 0.1.2

package/README.md

@@ -20,7 +20,7 @@ const client = new MiniMoth({
 })
 
 // Send OTP
-await client.otp.send({ phone: '919876543210' })
+const { otpId } = await client.otp.send({ phone: '919876543210' })
 
 // Verify OTP
 const result = await client.otp.verify({ phone: '919876543210', otp: '123456' })
@@ -133,9 +133,17 @@ const { session } = result
 Send an OTP to the given phone number.
 
 - `phone` (string, required): Indian phone number (e.g. `919876543210`)
-- Returns: Promise<void>
+- Returns: `Promise<{ otpId: string }>`
 - Throws: `MiniMothError` on rate limit or network error
 
+#### `status(otpId)`
+
+Check the delivery status of a sent OTP.
+
+- `otpId` (string, required): ID returned by `send()`
+- Returns: `Promise<{ otpId: string, channel: string | null, status: 'queued' | 'delivered' | 'failed', deliveredAt: string | null }>`
+- Throws: `MiniMothError` on invalid ID or network error
+
 #### `verify(options)`
 
 Verify the OTP code and establish a session.
@@ -184,11 +192,12 @@ Revoke all tokens for a session.
 Common `MiniMothError.code` values:
 
 - `INVALID_OTP`: OTP code does not match
-- `OTP_EXPIRED`: OTP has expired (max 10 minutes)
-- `INVALID_TOKEN`: Token could not be decoded
-- `TOKEN_EXPIRED`: Access token has expired (use refresh to get new token)
-- `TOKEN_REVOKED`: Token was revoked (session logout or theft detected)
-- `RATE_LIMITED`: Too many requests — wait before retrying
+- `OTP_NOT_FOUND`: No active OTP found — expired (10 min) or already used
+- `OTP_RATE_LIMITED`: Too many OTP requests for this number — wait 10 minutes
+- `VERIFY_RATE_LIMITED`: Too many incorrect attempts for this OTP — request a new one
+- `INVALID_ACCESS_TOKEN`: Access token is invalid or expired
+- `SESSION_EXPIRED`: Session has expired or was revoked — user must re-verify
+- `INVALID_PHONE`: Phone number format is invalid
 - `INSUFFICIENT_BALANCE`: Account has insufficient credits/balance
 - `NETWORK_ERROR`: Network request failed
 - `UNKNOWN_ERROR`: Unexpected server error

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minimoth/sdk-node",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Official MiniMoth Node.js SDK",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -17,6 +17,9 @@
     "dist"
   ],
   "license": "MIT",
+  "bugs": {
+    "email": "dev@minimoth.dev"
+  },
   "keywords": [
     "otp",
     "sms",