@zerodev/wallet-core 0.0.1-alpha.15 → 0.0.1-alpha.17

package/package.json

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

package/src/actions/auth/getAuthenticators.ts

@@ -0,0 +1,89 @@
+import type { Client } from '../../client/types.js'
+
+export type GetAuthenticatorsParameters = {
+  /** The sub-organization ID to query authenticators for */
+  subOrganizationId: string
+  /** The project ID for the request */
+  projectId: string
+  /** The session token for authorization */
+  token: string
+}
+
+/** An OAuth authenticator linked to the user */
+export type OAuthAuthenticator = {
+  provider?: string
+  clientId?: string
+  subject?: string
+  [key: string]: unknown
+}
+
+/** A passkey (WebAuthn) authenticator */
+export type PasskeyAuthenticator = {
+  rpId?: string
+  publicKey?: string
+  credentialId?: string
+  [key: string]: unknown
+}
+
+/** An email contact linked to the user */
+export type EmailContact = {
+  email?: string
+  [key: string]: unknown
+}
+
+/** An API key authenticator */
+export type ApiKeyAuthenticator = {
+  apiKey?: string
+  [key: string]: unknown
+}
+
+export type GetAuthenticatorsReturnType = {
+  /** OAuth providers linked to the user (null if none) */
+  oauths: OAuthAuthenticator[] | null
+  /** Passkey authenticators registered for the user (null if none) */
+  passkeys: PasskeyAuthenticator[] | null
+  /** Email contacts associated with the user (null if none) */
+  emailContacts: EmailContact[] | null
+  /** API keys associated with the user (null if none) */
+  apiKeys: ApiKeyAuthenticator[] | null
+}
+
+/**
+ * Fetches all authenticators (oauths, passkeys, emailContacts, apiKeys) for
+ * the authenticated user within the given project/sub-organization.
+ *
+ * Corresponds to `POST /api/v1/{projectId}/authenticators`.
+ *
+ * @param client - The ZeroDev Wallet client
+ * @param params - The parameters for the authenticators request
+ * @returns The user's authenticators grouped by type
+ *
+ * @example
+ * ```ts
+ * const authenticators = await getAuthenticators(client, {
+ *   subOrganizationId: 'suborg_123',
+ *   projectId: 'proj_456',
+ *   token: 'session_token_abc',
+ * });
+ * console.log(authenticators.oauths, authenticators.passkeys);
+ * ```
+ */
+export async function getAuthenticators(
+  client: Client,
+  params: GetAuthenticatorsParameters,
+): Promise<GetAuthenticatorsReturnType> {
+  const { subOrganizationId, projectId, token } = params
+
+  return await client.request({
+    path: `${projectId}/authenticators`,
+    method: 'POST',
+    body: {
+      subOrganizationId,
+    },
+    headers: {
+      Authorization: `Bearer ${token}`,
+    },
+    stamp: true,
+    stampPostion: 'headers',
+  })
+}

package/src/actions/auth/index.ts

@@ -10,15 +10,19 @@ export {
   type AuthenticateWithOAuthReturnType,
   authenticateWithOAuth,
 } from './authenticateWithOAuth.js'
+export {
+  type ApiKeyAuthenticator,
+  type EmailContact,
+  type GetAuthenticatorsParameters,
+  type GetAuthenticatorsReturnType,
+  getAuthenticators,
+  type OAuthAuthenticator,
+  type PasskeyAuthenticator,
+} from './getAuthenticators.js'
 export {
   type GetAuthProxyConfigIdReturnType,
   getAuthProxyConfigId,
 } from './getAuthProxyConfigId.js'
-export {
-  type GetUserEmailParameters,
-  type GetUserEmailReturnType,
-  getUserEmail,
-} from './getUserEmail.js'
 export {
   type GetWhoamiParameters,
   type GetWhoamiReturnType,

package/src/actions/index.ts

@@ -1,24 +1,28 @@
 // Auth actions
 export {
+  type ApiKeyAuthenticator,
   type AuthenticateWithEmailParameters,
   type AuthenticateWithEmailReturnType,
   type AuthenticateWithOAuthParameters,
   type AuthenticateWithOAuthReturnType,
   authenticateWithEmail,
   authenticateWithOAuth,
+  type EmailContact,
   type EmailCustomization,
+  type GetAuthenticatorsParameters,
+  type GetAuthenticatorsReturnType,
   type GetAuthProxyConfigIdReturnType,
-  type GetUserEmailParameters,
-  type GetUserEmailReturnType,
   type GetWhoamiParameters,
   type GetWhoamiReturnType,
+  getAuthenticators,
   getAuthProxyConfigId,
-  getUserEmail,
   getWhoami,
   type LoginWithOTPParameters,
   type LoginWithOTPReturnType,
   loginWithOTP,
+  type OAuthAuthenticator,
   type OtpContact,
+  type PasskeyAuthenticator,
   type RegisterWithOTPParameters,
   type RegisterWithOTPReturnType,
   type RegisterWithPasskeyParameters,

package/src/client/decorators/client.ts

@@ -10,15 +10,15 @@ import {
   type AuthenticateWithOAuthReturnType,
   authenticateWithEmail,
   authenticateWithOAuth,
+  type GetAuthenticatorsParameters,
+  type GetAuthenticatorsReturnType,
   type GetAuthProxyConfigIdReturnType,
-  type GetUserEmailParameters,
-  type GetUserEmailReturnType,
   type GetUserWalletParameters,
   type GetUserWalletReturnType,
   type GetWhoamiParameters,
   type GetWhoamiReturnType,
+  getAuthenticators,
   getAuthProxyConfigId,
-  getUserEmail,
   getUserWallet,
   getWhoami,
   type LoginWithOTPParameters,
@@ -73,11 +73,12 @@ export type ZeroDevWalletActions = {
   getWhoami: (params: GetWhoamiParameters) => Promise<GetWhoamiReturnType>
 
   /**
-   * Gets the user's email address
+   * Fetches all authenticators (oauths, passkeys, emailContacts, apiKeys)
+   * for the authenticated user within the given project/sub-organization
    */
-  getUserEmail: (
-    params: GetUserEmailParameters,
-  ) => Promise<GetUserEmailReturnType>
+  getAuthenticators: (
+    params: GetAuthenticatorsParameters,
+  ) => Promise<GetAuthenticatorsReturnType>
 
   // Wallet actions
   /**
@@ -182,7 +183,7 @@ export function zeroDevWalletActions(client: Client): ZeroDevWalletActions {
     authenticateWithEmail: (params) => authenticateWithEmail(client, params),
     authenticateWithOAuth: (params) => authenticateWithOAuth(client, params),
     getWhoami: (params) => getWhoami(client, params),
-    getUserEmail: (params) => getUserEmail(client, params),
+    getAuthenticators: (params) => getAuthenticators(client, params),
 
     // Wallet actions
     getUserWallet: (params) => getUserWallet(client, params),

package/src/index.ts

@@ -1,10 +1,14 @@
 export type {
   // Auth types
+  ApiKeyAuthenticator,
   AuthenticateWithEmailParameters,
   AuthenticateWithEmailReturnType,
   AuthenticateWithOAuthParameters,
   AuthenticateWithOAuthReturnType,
+  EmailContact,
   EmailCustomization,
+  GetAuthenticatorsParameters,
+  GetAuthenticatorsReturnType,
   // Wallet types
   GetUserWalletParameters,
   GetUserWalletReturnType,
@@ -12,7 +16,9 @@ export type {
   GetWhoamiReturnType,
   LoginWithOTPParameters,
   LoginWithOTPReturnType,
+  OAuthAuthenticator,
   OtpContact,
+  PasskeyAuthenticator,
   RegisterWithOTPParameters,
   RegisterWithOTPReturnType,
   Sign7702AuthorizationParameters,
@@ -32,6 +38,7 @@ export {
   // Auth actions
   authenticateWithEmail,
   authenticateWithOAuth,
+  getAuthenticators,
   // Wallet actions
   getUserWallet,
   getWhoami,

package/dist/_cjs/actions/auth/getUserEmail.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getUserEmail.js","sourceRoot":"","sources":["../../../../src/actions/auth/getUserEmail.ts"],"names":[],"mappings":";;AAiCA,oCAkBC;AAlBM,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,MAA8B;IAE9B,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAA;IAEnD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,IAAI,EAAE,GAAG,SAAS,aAAa;QAC/B,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,cAAc;SACf;QACD,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,KAAK,EAAE;SACjC;QACD,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,SAAS;KACxB,CAAC,CAAA;AACJ,CAAC"}

package/dist/_esm/actions/auth/getUserEmail.js

@@ -1,33 +0,0 @@
-/**
- * Gets the user's email address
- *
- * @param client - The ZeroDev Wallet client
- * @param params - The parameters for the user email request
- * @returns The user's email address
- *
- * @example
- * ```ts
- * const userEmail = await getUserEmail(client, {
- *   organizationId: 'org_123',
- *   projectId: 'proj_456',
- *   token: 'session_token_abc',
- * });
- * console.log(userEmail.email); // 'user@example.com'
- * ```
- */
-export async function getUserEmail(client, params) {
-    const { organizationId, projectId, token } = params;
-    return await client.request({
-        path: `${projectId}/user-email`,
-        method: 'POST',
-        body: {
-            organizationId,
-        },
-        headers: {
-            Authorization: `Bearer ${token}`,
-        },
-        stamp: true,
-        stampPostion: 'headers',
-    });
-}
-//# sourceMappingURL=getUserEmail.js.map

package/dist/_esm/actions/auth/getUserEmail.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getUserEmail.js","sourceRoot":"","sources":["../../../../src/actions/auth/getUserEmail.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,MAA8B;IAE9B,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAA;IAEnD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,IAAI,EAAE,GAAG,SAAS,aAAa;QAC/B,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,cAAc;SACf;QACD,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,KAAK,EAAE;SACjC;QACD,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,SAAS;KACxB,CAAC,CAAA;AACJ,CAAC"}

package/dist/_types/actions/auth/getUserEmail.d.ts

@@ -1,32 +0,0 @@
-import type { Client } from '../../client/types.js';
-export type GetUserEmailParameters = {
-    /** The organization ID to query */
-    organizationId: string;
-    /** The project ID for the request */
-    projectId: string;
-    /** The session token for authorization */
-    token: string;
-};
-export type GetUserEmailReturnType = {
-    /** The user's email address */
-    email: string;
-};
-/**
- * Gets the user's email address
- *
- * @param client - The ZeroDev Wallet client
- * @param params - The parameters for the user email request
- * @returns The user's email address
- *
- * @example
- * ```ts
- * const userEmail = await getUserEmail(client, {
- *   organizationId: 'org_123',
- *   projectId: 'proj_456',
- *   token: 'session_token_abc',
- * });
- * console.log(userEmail.email); // 'user@example.com'
- * ```
- */
-export declare function getUserEmail(client: Client, params: GetUserEmailParameters): Promise<GetUserEmailReturnType>;
-//# sourceMappingURL=getUserEmail.d.ts.map

package/dist/_types/actions/auth/getUserEmail.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getUserEmail.d.ts","sourceRoot":"","sources":["../../../../src/actions/auth/getUserEmail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,MAAM,sBAAsB,GAAG;IACnC,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAejC"}

package/src/actions/auth/getUserEmail.ts

@@ -1,52 +0,0 @@
-import type { Client } from '../../client/types.js'
-
-export type GetUserEmailParameters = {
-  /** The organization ID to query */
-  organizationId: string
-  /** The project ID for the request */
-  projectId: string
-  /** The session token for authorization */
-  token: string
-}
-
-export type GetUserEmailReturnType = {
-  /** The user's email address */
-  email: string
-}
-
-/**
- * Gets the user's email address
- *
- * @param client - The ZeroDev Wallet client
- * @param params - The parameters for the user email request
- * @returns The user's email address
- *
- * @example
- * ```ts
- * const userEmail = await getUserEmail(client, {
- *   organizationId: 'org_123',
- *   projectId: 'proj_456',
- *   token: 'session_token_abc',
- * });
- * console.log(userEmail.email); // 'user@example.com'
- * ```
- */
-export async function getUserEmail(
-  client: Client,
-  params: GetUserEmailParameters,
-): Promise<GetUserEmailReturnType> {
-  const { organizationId, projectId, token } = params
-
-  return await client.request({
-    path: `${projectId}/user-email`,
-    method: 'POST',
-    body: {
-      organizationId,
-    },
-    headers: {
-      Authorization: `Bearer ${token}`,
-    },
-    stamp: true,
-    stampPostion: 'headers',
-  })
-}