npm - @renown/sdk - Versions diffs - 6.0.0-dev.9 → 6.0.0-dev.90 - Mend

@renown/sdk 6.0.0-dev.9 → 6.0.0-dev.90

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (221) hide show

package/README.md +47 -438
package/dist/src/common.d.ts +16 -8
package/dist/src/common.d.ts.map +1 -1
package/dist/src/common.js +78 -38
package/dist/src/common.js.map +1 -1
package/dist/src/crypto/browser-key-storage.d.ts +4 -2
package/dist/src/crypto/browser-key-storage.d.ts.map +1 -1
package/dist/src/crypto/browser-key-storage.js +54 -51
package/dist/src/crypto/browser-key-storage.js.map +1 -1
package/dist/src/crypto/common.d.ts +6 -0
package/dist/src/crypto/common.d.ts.map +1 -0
package/dist/src/crypto/common.js +8 -0
package/dist/src/crypto/common.js.map +1 -0
package/dist/src/crypto/index.d.ts +1 -34
package/dist/src/crypto/index.d.ts.map +1 -1
package/dist/src/crypto/index.js +1 -128
package/dist/src/crypto/index.js.map +1 -1
package/dist/src/crypto/memory-key-storage.d.ts +9 -0
package/dist/src/crypto/memory-key-storage.d.ts.map +1 -0
package/dist/src/crypto/memory-key-storage.js +18 -0
package/dist/src/crypto/memory-key-storage.js.map +1 -0
package/dist/src/crypto/node-key-storage.d.ts +16 -3
package/dist/src/crypto/node-key-storage.d.ts.map +1 -1
package/dist/src/crypto/node-key-storage.js +82 -42
package/dist/src/crypto/node-key-storage.js.map +1 -1
package/dist/src/crypto/node.d.ts +1 -0
package/dist/src/crypto/node.d.ts.map +1 -1
package/dist/src/crypto/node.js +1 -1
package/dist/src/crypto/node.js.map +1 -1
package/dist/src/crypto/renown-crypto-builder.d.ts +11 -0
package/dist/src/crypto/renown-crypto-builder.d.ts.map +1 -0
package/dist/src/crypto/renown-crypto-builder.js +34 -0
package/dist/src/crypto/renown-crypto-builder.js.map +1 -0
package/dist/src/crypto/renown-crypto.d.ts +26 -0
package/dist/src/crypto/renown-crypto.d.ts.map +1 -0
package/dist/src/crypto/renown-crypto.js +56 -0
package/dist/src/crypto/renown-crypto.js.map +1 -0
package/dist/src/crypto/signer.d.ts +61 -8
package/dist/src/crypto/signer.d.ts.map +1 -1
package/dist/src/crypto/signer.js +98 -28
package/dist/src/crypto/signer.js.map +1 -1
package/dist/src/crypto/types.d.ts +27 -0
package/dist/src/crypto/types.d.ts.map +1 -0
package/dist/src/crypto/types.js +2 -0
package/dist/src/crypto/types.js.map +1 -0
package/dist/src/crypto/utils.d.ts +13 -0
package/dist/src/crypto/utils.d.ts.map +1 -0
package/dist/src/crypto/utils.js +39 -0
package/dist/src/crypto/utils.js.map +1 -0
package/dist/src/event/event.browser.d.ts.map +1 -1
package/dist/src/event/event.node.d.ts.map +1 -1
package/dist/src/event/memory.d.ts +8 -0
package/dist/src/event/memory.d.ts.map +1 -0
package/dist/src/event/memory.js +16 -0
package/dist/src/event/memory.js.map +1 -0
package/dist/src/index.d.ts +4 -9
package/dist/src/index.d.ts.map +1 -1
package/dist/src/index.js +4 -9
package/dist/src/index.js.map +1 -1
package/dist/src/init.browser.d.ts +51 -2
package/dist/src/init.browser.d.ts.map +1 -1
package/dist/src/init.browser.js +62 -3
package/dist/src/init.browser.js.map +1 -1
package/dist/src/init.node.d.ts +28 -2
package/dist/src/init.node.d.ts.map +1 -1
package/dist/src/init.node.js +26 -4
package/dist/src/init.node.js.map +1 -1
package/dist/src/node.d.ts +7 -3
package/dist/src/node.d.ts.map +1 -1
package/dist/src/node.js +7 -3
package/dist/src/node.js.map +1 -1
package/dist/src/profile.d.ts +3 -0
package/dist/src/profile.d.ts.map +1 -0
package/dist/src/profile.js +22 -0
package/dist/src/profile.js.map +1 -0
package/dist/src/renown-builder.d.ts +68 -0
package/dist/src/renown-builder.d.ts.map +1 -0
package/dist/src/renown-builder.js +130 -0
package/dist/src/renown-builder.js.map +1 -0
package/dist/src/storage/common.d.ts +14 -10
package/dist/src/storage/common.d.ts.map +1 -1
package/dist/src/storage/common.js +16 -3
package/dist/src/storage/common.js.map +1 -1
package/dist/src/storage/storage.browser.d.ts +1 -0
package/dist/src/storage/storage.browser.d.ts.map +1 -1
package/dist/src/storage/storage.browser.js +3 -1
package/dist/src/storage/storage.browser.js.map +1 -1
package/dist/src/storage/storage.node.d.ts +1 -1
package/dist/src/storage/storage.node.d.ts.map +1 -1
package/dist/src/storage/storage.node.js +7 -5
package/dist/src/storage/storage.node.js.map +1 -1
package/dist/src/types.d.ts +51 -5
package/dist/src/types.d.ts.map +1 -1
package/dist/src/utils.d.ts +17 -10
package/dist/src/utils.d.ts.map +1 -1
package/dist/src/utils.js +14 -0
package/dist/src/utils.js.map +1 -1
package/dist/{tests → test}/auth.test.d.ts.map +1 -1
package/dist/test/auth.test.js.map +1 -0
package/dist/test/crypto/signer.test.d.ts +2 -0
package/dist/test/crypto/signer.test.d.ts.map +1 -0
package/dist/test/crypto/signer.test.js +184 -0
package/dist/test/crypto/signer.test.js.map +1 -0
package/dist/test/renown.test.d.ts +2 -0
package/dist/test/renown.test.d.ts.map +1 -0
package/dist/test/renown.test.js +287 -0
package/dist/test/renown.test.js.map +1 -0
package/dist/test/storage.node.test.d.ts +2 -0
package/dist/test/storage.node.test.d.ts.map +1 -0
package/dist/test/storage.node.test.js +66 -0
package/dist/test/storage.node.test.js.map +1 -0
package/dist/tsconfig.tsbuildinfo +1 -1
package/dist/{e2e/fixtures/vite.config.d.ts → vitest.config.d.ts} +1 -1
package/dist/vitest.config.d.ts.map +1 -0
package/dist/vitest.config.js +7 -0
package/dist/vitest.config.js.map +1 -0
package/package.json +4 -28
package/dist/e2e/fixtures/main.d.ts +0 -2
package/dist/e2e/fixtures/main.d.ts.map +0 -1
package/dist/e2e/fixtures/main.js +0 -97
package/dist/e2e/fixtures/main.js.map +0 -1
package/dist/e2e/fixtures/vite.config.d.ts.map +0 -1
package/dist/e2e/fixtures/vite.config.js +0 -10
package/dist/e2e/fixtures/vite.config.js.map +0 -1
package/dist/e2e/renown-components.spec.d.ts +0 -2
package/dist/e2e/renown-components.spec.d.ts.map +0 -1
package/dist/e2e/renown-components.spec.js +0 -155
package/dist/e2e/renown-components.spec.js.map +0 -1
package/dist/playwright.config.d.ts +0 -3
package/dist/playwright.config.d.ts.map +0 -1
package/dist/playwright.config.js +0 -25
package/dist/playwright.config.js.map +0 -1
package/dist/src/assets/assets.d.ts +0 -19
package/dist/src/assets/renown-hover.svg +0 -17
package/dist/src/assets/renown-light.svg +0 -15
package/dist/src/assets/renown-short-hover.png +0 -0
package/dist/src/assets/renown-short.png +0 -0
package/dist/src/assets/renown.svg +0 -16
package/dist/src/components/RenownAuthButton.d.ts +0 -62
package/dist/src/components/RenownAuthButton.d.ts.map +0 -1
package/dist/src/components/RenownAuthButton.js +0 -82
package/dist/src/components/RenownAuthButton.js.map +0 -1
package/dist/src/components/RenownLoginButton.d.ts +0 -48
package/dist/src/components/RenownLoginButton.d.ts.map +0 -1
package/dist/src/components/RenownLoginButton.js +0 -175
package/dist/src/components/RenownLoginButton.js.map +0 -1
package/dist/src/components/RenownUserButton.d.ts +0 -66
package/dist/src/components/RenownUserButton.d.ts.map +0 -1
package/dist/src/components/RenownUserButton.js +0 -216
package/dist/src/components/RenownUserButton.js.map +0 -1
package/dist/src/components/icons.d.ts +0 -25
package/dist/src/components/icons.d.ts.map +0 -1
package/dist/src/components/icons.js +0 -24
package/dist/src/components/icons.js.map +0 -1
package/dist/src/components/image-data.d.ts +0 -3
package/dist/src/components/image-data.d.ts.map +0 -1
package/dist/src/components/image-data.js +0 -4
package/dist/src/components/image-data.js.map +0 -1
package/dist/src/components/index.d.ts +0 -8
package/dist/src/components/index.d.ts.map +0 -1
package/dist/src/components/index.js +0 -5
package/dist/src/components/index.js.map +0 -1
package/dist/src/hooks/index.d.ts +0 -2
package/dist/src/hooks/index.d.ts.map +0 -1
package/dist/src/hooks/index.js +0 -2
package/dist/src/hooks/index.js.map +0 -1
package/dist/src/hooks/use-user.d.ts +0 -21
package/dist/src/hooks/use-user.d.ts.map +0 -1
package/dist/src/hooks/use-user.js +0 -30
package/dist/src/hooks/use-user.js.map +0 -1
package/dist/src/index.browser.d.ts +0 -4
package/dist/src/index.browser.d.ts.map +0 -1
package/dist/src/index.browser.js +0 -4
package/dist/src/index.browser.js.map +0 -1
package/dist/src/index.node.d.ts +0 -4
package/dist/src/index.node.d.ts.map +0 -1
package/dist/src/index.node.js +0 -4
package/dist/src/index.node.js.map +0 -1
package/dist/src/lib/crypto/browser.d.ts +0 -8
package/dist/src/lib/crypto/browser.d.ts.map +0 -1
package/dist/src/lib/crypto/browser.js +0 -73
package/dist/src/lib/crypto/browser.js.map +0 -1
package/dist/src/lib/crypto/index.d.ts +0 -36
package/dist/src/lib/crypto/index.d.ts.map +0 -1
package/dist/src/lib/crypto/index.js +0 -150
package/dist/src/lib/crypto/index.js.map +0 -1
package/dist/src/lib/crypto/node.d.ts +0 -8
package/dist/src/lib/crypto/node.d.ts.map +0 -1
package/dist/src/lib/crypto/node.js +0 -67
package/dist/src/lib/crypto/node.js.map +0 -1
package/dist/src/lib/renown/constants.d.ts +0 -130
package/dist/src/lib/renown/constants.d.ts.map +0 -1
package/dist/src/lib/renown/constants.js +0 -40
package/dist/src/lib/renown/constants.js.map +0 -1
package/dist/src/lib/renown/did-parser.d.ts +0 -28
package/dist/src/lib/renown/did-parser.d.ts.map +0 -1
package/dist/src/lib/renown/did-parser.js +0 -57
package/dist/src/lib/renown/did-parser.js.map +0 -1
package/dist/src/lib/renown/index.d.ts +0 -4
package/dist/src/lib/renown/index.d.ts.map +0 -1
package/dist/src/lib/renown/index.js +0 -4
package/dist/src/lib/renown/index.js.map +0 -1
package/dist/src/lib/renown/utils.d.ts +0 -33
package/dist/src/lib/renown/utils.d.ts.map +0 -1
package/dist/src/lib/renown/utils.js +0 -207
package/dist/src/lib/renown/utils.js.map +0 -1
package/dist/src/lib/session-storage.d.ts +0 -40
package/dist/src/lib/session-storage.d.ts.map +0 -1
package/dist/src/lib/session-storage.js +0 -107
package/dist/src/lib/session-storage.js.map +0 -1
package/dist/src/providers/index.d.ts +0 -3
package/dist/src/providers/index.d.ts.map +0 -1
package/dist/src/providers/index.js +0 -2
package/dist/src/providers/index.js.map +0 -1
package/dist/src/providers/renown-user-provider.d.ts +0 -72
package/dist/src/providers/renown-user-provider.d.ts.map +0 -1
package/dist/src/providers/renown-user-provider.js +0 -171
package/dist/src/providers/renown-user-provider.js.map +0 -1
package/dist/tests/auth.test.js.map +0 -1
/package/dist/{tests → test}/auth.test.d.ts +0 -0
/package/dist/{tests → test}/auth.test.js +0 -0

package/README.md CHANGED Viewed

@@ -1,489 +1,98 @@
 # Renown SDK
-A comprehensive SDK for integrating Renown authentication and user profile management into your React applications.
+Core authentication SDK for Renown — handles credential verification, session management, and cryptographic operations.
-## Features
-- 🔐 **Authentication** - Complete authentication flow with session management
-- 👤 **User Profiles** - Fetch and manage user profile data
-- ⚛️ **React Integration** - Provider and hooks for seamless React integration
-- 🎨 **UI Components** - Ready-to-use login and auth components
-- 🔄 **Session Persistence** - Automatic session restoration across page reloads
-- 🌐 **Renown Portal** - Easy integration with Renown authentication portal
-- 📦 **Type-Safe** - Full TypeScript support
+For React components and hooks, see [COMPONENTS.md](./COMPONENTS.md).
 ## Installation
 ```bash
 npm install @renown/sdk
-# or
-yarn add @renown/sdk
-# or
-pnpm add @renown/sdk
 ```
-## Quick Start
-### 1. Wrap Your App with RenownUserProvider
-The SDK automatically initializes - just wrap your app!
+## RenownBuilder
 ```typescript
-// app/layout.tsx or app.tsx
-import { RenownUserProvider } from '@renown/sdk'
+import { RenownBuilder } from "@renown/sdk";
-export default function RootLayout({ children }) {
-  return (
-    <html>
-      <body>
-        <RenownUserProvider>
-          {children}
-        </RenownUserProvider>
-      </body>
-    </html>
-  )
-}
+const renown = await new RenownBuilder("my-app")
+  .withBaseUrl("https://www.renown.id")
+  .build();
 ```
-### 2. Use Authentication in Components
-**Option A: Use the RenownAuthButton component**
-```typescript
-import { RenownAuthButton } from '@renown/sdk'
-export function Header() {
-  return (
-    <header>
-      <h1>My App</h1>
-      <RenownAuthButton showLogoutButton />
-    </header>
-  )
-}
-```
+**Builder methods:**
+- `withBaseUrl(url)` — Renown server URL (default: `https://www.renown.id`)
+- `withStorage(storage)` — Custom user data persistence (default: in-memory)
+- `withEventEmitter(emitter)` — Custom event emitter for state changes
+- `withCrypto(crypto)` — Pre-built crypto instance
+- `withKeyPairStorage(storage)` — Key pair storage (crypto is built from this)
+- `withProfileFetcher(fetcher)` — Custom profile enrichment strategy
-**Option B: Build custom UI with useUser hook**
+## Renown Instance
 ```typescript
-import { useUser } from '@renown/sdk'
-export function CustomAuth() {
-  const { user, openRenown, logout } = useUser()
-  if (!user) return <button onClick={openRenown}>Login</button>
-  return <button onClick={logout}>Logout</button>
-}
-```
+// Login with a DID
+const user = await renown.login("did:pkh:eip155:1:0x...");
-## UI Components
+// Check current state
+renown.user;    // User | undefined
+renown.status;  // "initial" | "checking" | "authorized" | "not-authorized"
-The SDK includes a ready-to-use React component for authentication:
+// Listen to state changes
+const unsub = renown.on("user", (user) => { ... });
+const unsub2 = renown.on("status", (status) => { ... });
-### RenownAuthButton
+// Logout
+await renown.logout();
-Smart button that adapts to auth state - shows login button when not authenticated, and user info when authenticated:
-```typescript
-import { RenownAuthButton } from '@renown/sdk'
-<RenownAuthButton showLogoutButton />
+// Bearer tokens for API auth
+const token = await renown.getBearerToken({ expiresIn: 3600 });
+const verified = await renown.verifyBearerToken(token);
 ```
-For detailed component documentation and examples, see [COMPONENTS.md](./COMPONENTS.md).
-## API Reference
-### Components
-#### `<RenownUserProvider>`
-Central authentication provider that automatically initializes the SDK.
-**Props:**
-- `children`: React.ReactNode - **Required.** Your application components
-- `renownUrl?`: string - Renown service URL (default: 'https://www.renown.id')
-- `networkId?`: string - Network ID (default: 'eip155')
-- `chainId?`: string - Chain ID (default: '1')
-- `loadingComponent?`: React.ReactNode - Custom loading UI
-- `errorComponent?`: (error, retry) => React.ReactNode - Custom error UI
-**Example:**
-```typescript
-<RenownUserProvider>
-  <App />
-</RenownUserProvider>
-```
-**Custom Configuration:**
-```typescript
-<RenownUserProvider
-  renownUrl={process.env.NEXT_PUBLIC_RENOWN_URL}
-  loadingComponent={<Spinner />}
-  errorComponent={(error, retry) => <ErrorScreen error={error} onRetry={retry} />}
->
-  <App />
-</RenownUserProvider>
-```
-### Hooks
-#### `useUser()`
-Access authentication state and methods throughout your application.
-**Returns:**
-```typescript
-{
-  user: User | null                      // Current authenticated user
-  loginStatus: LoginStatus               // 'initial' | 'checking' | 'authorized' | 'not-authorized'
-  isLoading: boolean                     // Loading state for auth operations
-  isInitialized: boolean                 // Whether auth system is initialized
-  login: (userDid?: string) => Promise<void>   // Login with optional DID
-  logout: () => Promise<void>            // Logout current user
-  openRenown: () => void                 // Open Renown portal
-}
-```
+## Types
-**Example:**
 ```typescript
-function UserProfile() {
-  const { user, loginStatus, openRenown, logout } = useUser()
+import type { User, LoginStatus, IRenown } from "@renown/sdk";
-  switch (loginStatus) {
-    case 'authorized':
-      return (
-        <div>
-          <h1>{user?.name || 'User'}</h1>
-          <p>{user?.did}</p>
-          {user?.avatar && <img src={user.avatar} alt="Avatar" />}
-          <button onClick={logout}>Logout</button>
-        </div>
-      )
-    case 'not-authorized':
-      return <button onClick={openRenown}>Login</button>
-    default:
-      return <div>Checking auth...</div>
-  }
-}
-```
-### Types
-#### `User`
-```typescript
 interface User {
-  did: string              // Decentralized identifier
-  address: string          // Ethereum address
-  name?: string            // Display name from profile
-  email?: string           // Email address
-  avatar?: string          // Avatar image URL
-  ethAddress?: string      // Ethereum address
-}
-```
-#### `LoginStatus`
-```typescript
-type LoginStatus =
-  | 'initial'           // Not yet checked
-  | 'checking'          // Currently checking auth
-  | 'authorized'        // User is authenticated
-  | 'not-authorized'    // User is not authenticated
-```
-### Utility Functions
-#### `fetchProfileDataForUser(user: User): Promise<User>`
-Fetches additional profile data from the Renown API for a given user.
-```typescript
-import { fetchProfileDataForUser } from '@renown/sdk'
-const userWithProfile = await fetchProfileDataForUser(user)
-```
-#### `login(userDid: string, renown: IRenown, connectCrypto: IConnectCrypto)`
-Performs login and stores session data.
-#### `logout()`
-Logs out the current user and clears session data.
-#### `openRenown()`
-Opens the Renown authentication portal.
-#### `handleRenownReturn()`
-Handles return from Renown authentication flow.
-### Session Management
-#### `SessionStorageManager`
-Manages user session persistence in sessionStorage.
-**Methods:**
-- `setUserData(data)` - Store user data
-- `getUserData()` - Retrieve stored user data
-- `clearUserData()` - Clear session data
-- `isUserDataValid(data)` - Check if session data is valid
-```typescript
-import { SessionStorageManager } from '@renown/sdk'
-// Store user session
-SessionStorageManager.setUserData({
-  user: currentUser,
-  userDid: currentUser.did,
-  loginStatus: 'authorized',
-  timestamp: Date.now()
-})
-// Check session
-const storedData = SessionStorageManager.getUserData()
-if (storedData && SessionStorageManager.isUserDataValid(storedData)) {
-  // Session is valid
+  did: string;
+  address: `0x${string}`;
+  chainId: number;
+  networkId: string;
+  credential: PowerhouseVerifiableCredential | undefined;
+  profile?: RenownProfile;
+  ens?: { name?: string; avatarUrl?: string };
 }
-```
-## Advanced Usage
-### Custom Authentication Flow
-You can implement custom authentication flows by directly using the SDK functions:
-```typescript
-import { login, logout, initRenown, ConnectCrypto, BrowserKeyStorage } from '@renown/sdk'
-async function customLogin() {
-  // Initialize
-  const connectCrypto = new ConnectCrypto(new BrowserKeyStorage())
-  const renown = await initRenown(
-    await connectCrypto.did(),
-    'eip155',
-    'https://www.renown.id'
-  )
-  // Login
-  const userDid = await connectCrypto.did()
-  const user = await login(userDid, renown, connectCrypto)
-  return user
-}
-```
-### Conditional Rendering Based on Auth
-```typescript
-function ProtectedContent() {
-  const { user, loginStatus, openRenown } = useUser()
-  if (loginStatus !== 'authorized') {
-    return (
-      <div>
-        <h1>Please login to continue</h1>
-        <button onClick={openRenown}>Login</button>
-      </div>
-    )
-  }
-  return <div>Protected content for {user?.name}</div>
-}
-```
-### Handling Authentication Events
-```typescript
-function AuthListener() {
-  const { user, loginStatus } = useUser()
-  useEffect(() => {
-    if (loginStatus === 'authorized' && user) {
-      console.log('User logged in:', user)
-      // Analytics, notifications, etc.
-    }
-  }, [loginStatus, user])
-  return null
-}
-```
-## Configuration
-### RenownUserProvider Configuration
-The RenownUserProvider accepts optional configuration props:
-```typescript
-<RenownUserProvider
-  renownUrl="https://www.renown.id"  // Custom Renown URL
-  networkId="eip155"                            // Network ID (default)
-  chainId="1"                                   // Chain ID (default)
->
-  <App />
-</RenownUserProvider>
-```
-### Environment Variables
-Use environment variables for dynamic configuration:
-```typescript
-<RenownUserProvider
-  renownUrl={process.env.NEXT_PUBLIC_RENOWN_URL || 'https://www.renown.id'}
->
-  <App />
-</RenownUserProvider>
-```
-```bash
-# .env
-NEXT_PUBLIC_RENOWN_URL=https://www.renown.id
+type LoginStatus = "initial" | "checking" | "authorized" | "not-authorized";
 ```
-## Examples
-### Next.js App Router
+## Utilities
 ```typescript
-// app/layout.tsx
-import { RenownUserProvider } from '@renown/sdk'
-export default function RootLayout({ children }) {
-  return (
-    <html lang="en">
-      <body>
-        <RenownUserProvider>
-          {children}
-        </RenownUserProvider>
-      </body>
-    </html>
-  )
-}
-// components/Navbar.tsx - Using RenownAuthButton
-'use client'
-import { RenownAuthButton } from '@renown/sdk'
-export function Navbar() {
-  return (
-    <nav>
-      <h1>My App</h1>
-      <RenownAuthButton showLogoutButton />
-    </nav>
-  )
-}
+import { parsePkhDid, verifyAuthBearerToken } from "@renown/sdk";
-// app/profile/page.tsx - Using useUser hook
-'use client'
+// Parse a DID:pkh string
+const { networkId, chainId, address } = parsePkhDid("did:pkh:eip155:1:0x...");
-import { useUser } from '@renown/sdk'
-export default function ProfilePage() {
-  const { user, openRenown, logout } = useUser()
-  if (!user) {
-    return (
-      <div>
-        <h1>Login Required</h1>
-        <button onClick={openRenown}>Login with Renown</button>
-      </div>
-    )
-  }
-  return (
-    <div>
-      <h1>Profile</h1>
-      <p>DID: {user.did}</p>
-      <p>Name: {user.name}</p>
-      <button onClick={logout}>Logout</button>
-    </div>
-  )
-}
+// Verify a bearer token
+const result = await verifyAuthBearerToken(jwt); // false | AuthVerifiedCredential
 ```
-### React SPA
+## Node.js
-```typescript
-// main.tsx
-import { RenownUserProvider } from '@renown/sdk'
-import App from './App'
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <RenownUserProvider>
-      <App />
-    </RenownUserProvider>
-  </React.StrictMode>
-)
-// App.tsx - Using RenownAuthButton
-import { RenownAuthButton } from '@renown/sdk'
-function App() {
-  return (
-    <div>
-      <h1>My App</h1>
-      <RenownAuthButton showLogoutButton />
-    </div>
-  )
-}
-```
-## Troubleshooting
-### RenownUserProvider Context Error
-**Error:** `useUser must be used within an RenownUserProvider`
-**Solution:** Ensure your component is wrapped by `<RenownUserProvider>`:
+For server-side usage, import from `@renown/sdk/node`:
 ```typescript
-<RenownUserProvider>
-  <YourComponent /> {/* ✅ Can use useUser */}
-</RenownUserProvider>
+import { RenownBuilder } from "@renown/sdk/node";
 ```
-### Custom Renown URL
-To use a different Renown instance:
-```typescript
-<RenownUserProvider renownUrl="https://your-renown-instance.com">
-  <App />
-</RenownUserProvider>
-```
-### Session Not Persisting
-If sessions aren't persisting across page reloads:
-1. Check that sessionStorage is available (not in incognito mode)
-2. Verify the session hasn't expired (24 hour timeout by default)
-3. Check browser console for any errors during initialization
-## Contributing
-Contributions are welcome! Please read our contributing guidelines before submitting PRs.
 ## License
 AGPL-3.0-only
-## Documentation
-Full documentation is available in the Powerhouse Academy:
-- [Overview & Quick Start](../../apps/academy/docs/academy/04-APIReferences/renown-sdk/00-Overview.md)
-- [Authentication Guide](../../apps/academy/docs/academy/04-APIReferences/renown-sdk/01-Authentication.md)
-- [API Reference](../../apps/academy/docs/academy/04-APIReferences/renown-sdk/02-APIReference.md)
 ## Support
-For issues and questions:
 - GitHub Issues: [powerhouse-inc/powerhouse](https://github.com/powerhouse-inc/powerhouse)
 - Documentation: [Powerhouse Academy](https://docs.powerhouse.io)

package/dist/src/common.d.ts CHANGED Viewed

@@ -1,15 +1,23 @@
-import type { Issuer } from "did-jwt-vc";
-import type { IRenown, RenownEventEmitter, RenownEvents, RenownStorage, User } from "./types.js";
-import type { CreateBearerTokenOptions } from "./utils.js";
+import { type IRenownCrypto } from "./crypto/index.js";
+import { MemoryStorage } from "./storage/common.js";
+import type { CreateBearerTokenOptions, IRenown, ISigner, LoginStatus, ProfileFetcher, RenownEventEmitter, RenownEvents, RenownStorage, RenownStorageMap, User } from "./types.js";
+export * from "./constants.js";
+export declare class RenownMemoryStorage extends MemoryStorage<RenownStorageMap> {
+}
 export declare class Renown implements IRenown {
     #private;
-    constructor(store: RenownStorage, eventEmitter: RenownEventEmitter, connectId: string, baseUrl?: string);
+    constructor(store: RenownStorage, eventEmitter: RenownEventEmitter, crypto: IRenownCrypto, appName: string, baseUrl?: string, profileFetcher?: ProfileFetcher);
+    get baseUrl(): string;
     get user(): import("./types.js").InternalUser | undefined;
-    set connectId(connectId: string);
-    login(did: string): Promise<User>;
+    get status(): LoginStatus;
+    get signer(): ISigner;
+    get crypto(): IRenownCrypto;
+    get did(): `did:${string}`;
+    get profileFetcher(): ProfileFetcher | undefined;
+    login(userDid: string): Promise<User>;
     logout(): Promise<void>;
     on<K extends keyof RenownEvents>(event: K, listener: (data: RenownEvents[K]) => void): () => void;
-    verifyBearerToken(token: string): Promise<false | import("did-jwt-vc").VerifiedCredential>;
-    createBearerToken(address: string, chainId: number, issuer: Issuer, options: CreateBearerTokenOptions): Promise<string>;
+    verifyBearerToken(token: string): Promise<false | import("./types.js").AuthVerifiedCredential>;
+    getBearerToken(options: CreateBearerTokenOptions): Promise<string>;
 }
 //# sourceMappingURL=common.d.ts.map

package/dist/src/common.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/common.ts"],"names":[],"mappings":"~~AAAA~~,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,~~YAAY~~,CAAC;~~AAEzC~~,OAAO,KAAK,EACV,OAAO,~~EAEP~~,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,IAAI,EACL,MAAM,YAAY,CAAC;~~AACpB~~,~~OAAO~~,~~KAAK~~,~~EAAE~~,~~wBAAwB~~,~~EAAE~~,~~MAAM~~,~~YAAY~~,CAAC;~~AAO3D~~,qBAAa,MAAO,YAAW,OAAO;;~~gBAOlC~~,KAAK,EAAE,aAAa,EACpB,YAAY,EAAE,kBAAkB,EAChC,~~SAAS~~,EAAE,MAAM,~~EACjB~~,OAAO,SAAqB;~~IAY9B~~,IAAI,IAAI,kDAEP;~~IAWD~~,IAAI,~~SAAS~~,~~CAAC~~,~~SAAS~~,~~EAAE~~,MAAM,~~EAY9B~~;~~IAEK~~,KAAK,CAAC,~~GAAG~~,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;~~IAuCvC~~,MAAM;~~IAKN~~,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EAC7B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GACxC,MAAM,IAAI;IA6BP,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAI/B,~~iBAAiB~~,~~CACrB~~,OAAO,EAAE,~~MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,~~wBAAwB;~~CAapC~~"}
1	+ {"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/common.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EACV,wBAAwB,EACxB,OAAO,EACP,OAAO,EACP,WAAW,EAEX,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,IAAI,EACL,MAAM,YAAY,CAAC;AAEpB,cAAc,gBAAgB,CAAC;AAE/B,qBAAa,mBAAoB,SAAQ,aAAa,CAAC,gBAAgB,CAAC;CAAG;AAE3E,qBAAa,MAAO,YAAW,OAAO;;gBAWlC,KAAK,EAAE,aAAa,EACpB,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,SAAqB,EAC5B,cAAc,CAAC,EAAE,cAAc;IAejC,IAAI,OAAO,WAEV;IAED,IAAI,IAAI,kDAEP;IAED,IAAI,MAAM,gBAET;IAED,IAAI,MAAM,YAET;IAED,IAAI,MAAM,kBAET;IAED,IAAI,GAAG,oBAEN;IAED,IAAI,cAAc,+BAEjB;IAgBK,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgE3C,MAAM;IAMN,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EAC7B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GACxC,MAAM,IAAI;IA6BP,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAI/B,cAAc,CAAC,OAAO,EAAE,wBAAwB;CAMvD"}