@zerodev/wallet-core 0.0.1-alpha.11 → 0.0.1-alpha.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerodev/wallet-core",
-  "version": "0.0.1-alpha.11",
+  "version": "0.0.1-alpha.13",
   "description": "ZeroDev Wallet SDK built on Turnkey",
   "main": "./dist/_cjs/index.js",
   "module": "./dist/_esm/index.js",

package/src/actions/auth/index.ts

@@ -35,6 +35,7 @@ export {
   loginWithStamp,
 } from './loginWithStamp.js'
 export {
+  type OtpCodeCustomization,
   type OtpContact,
   type RegisterWithOTPParameters,
   type RegisterWithOTPReturnType,

package/src/actions/auth/registerWithOTP.ts

@@ -8,6 +8,13 @@ export type OtpContact = {
   contact: string
 }
 
+export type OtpCodeCustomization = {
+  /** The length of the OTP code (must be between 6 and 9 inclusive) */
+  length: 6 | 7 | 8 | 9
+  /** Whether the OTP code should be alphanumeric */
+  alphanumeric: boolean
+}
+
 export type RegisterWithOTPParameters = {
   /** The email address to register */
   email: string
@@ -17,6 +24,8 @@ export type RegisterWithOTPParameters = {
   projectId: string
   /** Optional email customization settings */
   emailCustomization?: EmailCustomization
+  /** Optional OTP code customization settings */
+  otpCodeCustomization?: OtpCodeCustomization
 }
 
 export type RegisterWithOTPReturnType = {
@@ -50,7 +59,20 @@ export async function registerWithOTP(
   client: Client,
   params: RegisterWithOTPParameters,
 ): Promise<RegisterWithOTPReturnType> {
-  const { email, contact, projectId, emailCustomization } = params
+  const {
+    email,
+    contact,
+    projectId,
+    emailCustomization,
+    otpCodeCustomization,
+  } = params
+
+  if (
+    otpCodeCustomization &&
+    (otpCodeCustomization.length < 6 || otpCodeCustomization.length > 9)
+  ) {
+    throw new Error('OTP code length must be between 6 and 9')
+  }
 
   return await client.request({
     path: `${projectId}/auth/init/otp`,
@@ -59,6 +81,7 @@ export async function registerWithOTP(
       email,
       contact,
       emailCustomization,
+      otpCodeCustomization,
     },
   })
 }

package/src/actions/auth/registerWithPasskey.ts

@@ -6,8 +6,6 @@ export type EmailCustomization = {
 }
 
 export type RegisterWithPasskeyParameters = {
-  /** The email address to authenticate */
-  email: string
   /** The project ID for the request */
   projectId: string
   /** The challenge for the request */
@@ -41,7 +39,6 @@ export type RegisterWithPasskeyReturnType = {
  * @example
  * ```ts
  * const result = await registerWithPasskey(client, {
- *   email: 'user@example.com',
  *   projectId: 'proj_456',
  *   challenge: 'challenge',
  *   attestation: {
@@ -57,13 +54,12 @@ export async function registerWithPasskey(
   client: Client,
   params: RegisterWithPasskeyParameters,
 ): Promise<RegisterWithPasskeyReturnType> {
-  const { email, projectId, challenge, attestation, encodedPublicKey } = params
+  const { projectId, challenge, attestation, encodedPublicKey } = params
 
   return client.request({
     path: `${projectId}/auth/register/passkey`,
     method: 'POST',
     body: {
-      email,
       attestation,
       challenge,
       encodedPublicKey,

package/src/core/createZeroDevWallet.ts

@@ -1,6 +1,9 @@
 import { getWebAuthnAttestation } from '@turnkey/http'
 import type { LocalAccount } from 'viem/accounts'
-import type { EmailCustomization } from '../actions/auth/index.js'
+import type {
+  EmailCustomization,
+  OtpCodeCustomization,
+} from '../actions/auth/index.js'
 import { toViemAccount } from '../adapters/viem.js'
 import {
   createAuthProxyClient,
@@ -50,7 +53,6 @@ export type AuthParams =
     }
   | {
       type: 'passkey'
-      email: string
       mode: 'register' | 'login'
     }
   | {
@@ -62,6 +64,7 @@ export type AuthParams =
         contact: string
       }
       emailCustomization?: EmailCustomization
+      otpCodeCustomization?: OtpCodeCustomization
     }
   | {
       type: 'otp'
@@ -69,6 +72,19 @@ export type AuthParams =
       otpId: string
       otpCode: string
     }
+  | {
+      type: 'magicLink'
+      mode: 'send'
+      email: string
+      redirectURL: string
+      otpCodeCustomization?: OtpCodeCustomization
+    }
+  | {
+      type: 'magicLink'
+      mode: 'verify'
+      otpId: string
+      code: string
+    }
 
 export interface ZeroDevWalletSDK {
   client: ZeroDevWalletClient
@@ -236,7 +252,6 @@ export async function createZeroDevWallet(
             'mode' in params &&
             params.mode === 'register'
           ) {
-            const { email } = params
             await client.indexedDbStamper.resetKeyPair()
             const tempPublicKey = await client.indexedDbStamper.getPublicKey()
             if (!tempPublicKey) {
@@ -245,7 +260,7 @@ export async function createZeroDevWallet(
             const challenge = generateRandomBuffer()
             const encodedChallenge = base64UrlEncode(challenge)
             const authenticatorUserId = generateRandomBuffer()
-            const name = `ZeroDevWallet-${humanReadableDateTime()}-${email}`
+            const name = `ZeroDevWallet-${humanReadableDateTime()}`
             const attestation = await getWebAuthnAttestation({
               publicKey: {
                 rp: { id: rpId, name: '' },
@@ -268,7 +283,6 @@ export async function createZeroDevWallet(
               },
             })
             const data = await client.registerWithPasskey({
-              email,
               attestation,
               challenge: encodedChallenge,
               projectId,
@@ -341,24 +355,53 @@ export async function createZeroDevWallet(
           }
           throw new Error('Passkey authentication requires passkey parameter')
         }
-        case 'otp': {
-          const { type, mode } = params
+        case 'otp':
+        case 'magicLink': {
+          // Normalize magicLink params into OTP params
+          let otpParams: Extract<AuthParams, { type: 'otp' }>
+          if (params.type === 'magicLink') {
+            if (params.mode === 'send') {
+              otpParams = {
+                type: 'otp',
+                mode: 'sendOtp',
+                email: params.email,
+                contact: { type: 'email', contact: params.email },
+                emailCustomization: {
+                  magicLinkTemplate: `${params.redirectURL}${params.redirectURL.includes('?') ? '&' : '?'}code=%s`,
+                },
+                ...(params.otpCodeCustomization && {
+                  otpCodeCustomization: params.otpCodeCustomization,
+                }),
+              }
+            } else {
+              otpParams = {
+                type: 'otp',
+                mode: 'verifyOtp',
+                otpId: params.otpId,
+                otpCode: params.code,
+              }
+            }
+          } else {
+            otpParams = params
+          }
 
-          if (type === 'otp' && mode === 'sendOtp') {
-            const { email, contact, emailCustomization } = params
+          if (otpParams.mode === 'sendOtp') {
+            const { email, contact, emailCustomization, otpCodeCustomization } =
+              otpParams
 
             const data = await client.registerWithOTP({
               email,
               contact,
               projectId,
               ...(emailCustomization && { emailCustomization }),
+              ...(otpCodeCustomization && { otpCodeCustomization }),
             })
 
             return data
           }
 
-          if (type === 'otp' && mode === 'verifyOtp') {
-            const { otpId, otpCode } = params
+          if (otpParams.mode === 'verifyOtp') {
+            const { otpId, otpCode } = otpParams
 
             // Step 1: Generate new key pair
             await client.indexedDbStamper.resetKeyPair()

package/src/stampers/iframeStamper.ts

@@ -45,5 +45,8 @@ export async function createIframeStamper(cfg: {
         keyFormat ? KeyFormat[keyFormat] : KeyFormat.Hexadecimal,
       )
     },
+    async applySettings(settings: { styles?: Record<string, string> }) {
+      return await inner.applySettings(settings)
+    },
   }
 }

package/src/stampers/types.ts

@@ -27,6 +27,7 @@ export type IframeStamper = Stamper & {
     organizationId: string,
     keyFormat?: KeyFormat,
   ): Promise<boolean>
+  applySettings(settings: { styles?: Record<string, string> }): Promise<boolean>
 }
 
 export type IndexedDbStamper = Stamper & {