@b3dotfun/sdk 0.0.44 → 0.0.46

package/README.md

@@ -8,6 +8,7 @@ The SDK is organized into focused modules:
 
 - **`anyspend/`** - Cross-chain execution engine functionality
 - **`global-account/`** - B3 Global Accounts authentication and user management
+- **`notifications/`** - Multi-channel notification management
 - **`shared/`** - Common utilities, types, and components
 - **`others/`** - Additional features and utilities
 
@@ -25,6 +26,7 @@ Each module contains:
 | ----------------- | --------- | ------------ |
 | AnySpend          | ✅        | ❌           |
 | Global Accounts   | ✅        | ✅           |
+| Notifications     | ✅        | ✅           |
 | Headless Services | ✅        | ✅           |
 
 ## Installation
@@ -155,9 +157,7 @@ const order = await anyspendService.createOrder({
 import { anyspendService } from "@b3dotfun/sdk/anyspend/services/anyspend";
 
 // Get order details and transactions
-const orderDetails = await anyspendService.getOrderAndTransactions(
-  "order-id",
-);
+const orderDetails = await anyspendService.getOrderAndTransactions("order-id");
 
 // Get order history for an address
 const history = await anyspendService.getOrderHistory(
@@ -323,6 +323,206 @@ import { serverFunction } from "@b3dotfun/sdk/global-account/server";
 // (Implementation depends on your specific needs)
 ```
 
+# Notifications
+
+B3 Notifications provides multi-channel notification management for your users with support for email, Telegram, Discord, SMS, WhatsApp, and in-app notifications.
+
+## Features
+
+- ✅ **Zero Config** - Automatically uses authenticated user's ID from JWT
+- 🎯 **Type Safe** - Full TypeScript support
+- ⚡ **React Hooks** - Easy integration with `useNotifications()` hook
+- 🔐 **Secure** - JWT-based authentication
+- 📱 **Multi-Channel** - Email, Telegram, Discord, SMS, WhatsApp, In-app
+- 🚀 **Lightweight** - Minimal dependencies
+
+## React Hook
+
+### Basic Usage
+
+```tsx
+import { useNotifications } from "@b3dotfun/sdk/notifications/react";
+
+function NotificationSettings() {
+  const { user, loading, connectEmail, connectTelegram, isEmailConnected } = useNotifications();
+
+  if (loading) return <div>Loading...</div>;
+
+  return (
+    <div>
+      {!isEmailConnected && <button onClick={() => connectEmail("user@example.com")}>Connect Email</button>}
+
+      <button onClick={connectTelegram}>Connect Telegram</button>
+    </div>
+  );
+}
+```
+
+### Full Hook API
+
+```tsx
+const {
+  user, // User data with channels and settings
+  loading, // Loading state
+  error, // Error if any
+  refresh, // Manually refresh user data
+  connectEmail, // Connect email channel
+  connectTelegram, // Connect Telegram channel
+  updateChannel, // Update a channel
+  deleteChannel, // Delete a channel
+  // Convenience helpers
+  isEmailConnected,
+  isTelegramConnected,
+  isDiscordConnected,
+} = useNotifications();
+```
+
+## Headless API Client
+
+### Authentication
+
+The notifications API automatically uses the B3 auth token from cookies. The token is managed by the B3 Global Account authentication system - you don't need to set it manually.
+
+```typescript
+import { getAuthToken, notificationsAPI } from "@b3dotfun/sdk/notifications";
+// Or import from shared utils
+// import { getAuthToken } from "@b3dotfun/sdk/shared/utils";
+
+// Get the current auth token (from b3-auth cookie)
+const token = getAuthToken();
+
+// API calls automatically use the auth token
+const userData = await notificationsAPI.getUser();
+```
+
+### User Management
+
+```typescript
+import { notificationsAPI } from "@b3dotfun/sdk/notifications";
+
+// Register current user
+await notificationsAPI.registerUser();
+
+// Get current user's profile
+const userData = await notificationsAPI.getUser();
+
+// Get notification history
+const history = await notificationsAPI.getHistory("my-app-id", 50);
+```
+
+### Channel Management
+
+```typescript
+// Add any channel
+await notificationsAPI.addChannel("email", "user@example.com");
+
+// Connect email (shorthand)
+await notificationsAPI.connectEmail("user@example.com");
+
+// Update channel
+await notificationsAPI.updateChannel("channel-id", {
+  enabled: true,
+});
+
+// Delete channel
+await notificationsAPI.deleteChannel("channel-id");
+```
+
+### Telegram Integration
+
+```typescript
+// Get Telegram deep link
+const { deepLink, verificationCode, botUsername } = await notificationsAPI.getTelegramLink();
+window.open(deepLink, "_blank");
+
+// Check connection status
+const { connected, chatId } = await notificationsAPI.checkTelegramStatus();
+```
+
+### App Preferences
+
+```typescript
+// Save notification preferences for an app (enabled by default)
+await notificationsAPI.savePreferences("my-app", {
+  notificationType: "transaction",
+  channels: ["email", "telegram", "in_app"],
+});
+
+// Save disabled preferences
+await notificationsAPI.savePreferences("my-app", {
+  notificationType: "transaction",
+  channels: ["email", "telegram"],
+  enabled: false,
+});
+
+// Get app settings
+const settings = await notificationsAPI.getAppSettings("my-app");
+```
+
+### In-App Notifications
+
+```typescript
+// Get in-app notifications
+const { notifications } = await notificationsAPI.getInAppNotifications();
+
+// Mark notification as read
+await notificationsAPI.markNotificationAsRead("notification-id");
+```
+
+### Send Notifications
+
+```typescript
+// Send a notification
+await notificationsAPI.sendNotification({
+  userId: "user-123",
+  appId: "my-app",
+  notificationType: "transaction",
+  message: "Your transaction was successful!",
+  title: "Transaction Complete",
+  data: { transactionId: "tx-123" },
+});
+```
+
+## Next.js Example
+
+```tsx
+"use client";
+
+import { useNotifications } from "@b3dotfun/sdk/notifications/react";
+
+export default function NotificationsPage() {
+  const { user, loading, connectEmail, connectTelegram, isEmailConnected, isTelegramConnected } = useNotifications();
+
+  if (loading) {
+    return <div>Loading notification settings...</div>;
+  }
+
+  return (
+    <div className="space-y-4">
+      <h1>Notification Settings</h1>
+
+      <div className="rounded-lg border p-4">
+        <h2>Email</h2>
+        {isEmailConnected ? (
+          <p className="text-green-600">✓ Connected</p>
+        ) : (
+          <button onClick={() => connectEmail("user@example.com")}>Connect Email</button>
+        )}
+      </div>
+
+      <div className="rounded-lg border p-4">
+        <h2>Telegram</h2>
+        {isTelegramConnected ? (
+          <p className="text-green-600">✓ Connected</p>
+        ) : (
+          <button onClick={connectTelegram}>Connect Telegram</button>
+        )}
+      </div>
+    </div>
+  );
+}
+```
+
 # Shared Utilities
 
 ## Chain Management
@@ -338,6 +538,25 @@ console.log(supportedChains);
 console.log(b3Chain);
 ```
 
+## Authentication Token Management
+
+Read-only access to the B3 authentication token. The token is managed by the B3 Global Account authentication system.
+
+```typescript
+import { getAuthToken } from "@b3dotfun/sdk/shared/utils";
+
+// Get the current auth token from the b3-auth cookie
+const token = getAuthToken();
+
+if (token) {
+  console.log("User is authenticated");
+} else {
+  console.log("User is not authenticated");
+}
+```
+
+The auth token is automatically set by the B3 Global Account authentication system (see the Global Accounts section above). All SDK modules that require authentication will automatically use this token.
+
 ## Utility Functions
 
 ```typescript

package/dist/cjs/anyspend/react/components/common/OrderDetails.js

@@ -280,12 +280,7 @@ exports.OrderDetails = (0, react_4.memo)(function OrderDetails({ mode = "modal",
         ? "0"
         : order.payload.expectedDstAmount.toString();
     const formattedExpectedDstAmount = (0, number_1.formatTokenAmount)(BigInt(expectedDstAmount), dstToken.decimals);
-    const actualDstAmount = order.type === "mint_nft" ||
-        order.type === "join_tournament" ||
-        order.type === "fund_tournament" ||
-        order.type === "custom"
-        ? undefined
-        : order.payload.actualDstAmount;
+    const actualDstAmount = order.settlement?.actualDstAmount;
     const formattedActualDstAmount = actualDstAmount
         ? (0, number_1.formatTokenAmount)(BigInt(actualDstAmount), dstToken.decimals)
         : undefined;

package/dist/cjs/anyspend/react/components/common/OrderHistoryItem.js

@@ -16,12 +16,7 @@ function OrderHistoryItem({ order, onSelectOrder, mode }) {
     const nft = order.type === "mint_nft" ? order.metadata.nft : undefined;
     const tournament = order.type === "join_tournament" || order.type === "fund_tournament" ? order.metadata.tournament : undefined;
     const dstToken = order.metadata.dstToken;
-    const actualDstAmount = order.type === "mint_nft" ||
-        order.type === "join_tournament" ||
-        order.type === "fund_tournament" ||
-        order.type === "custom"
-        ? undefined
-        : order.payload.actualDstAmount;
+    const actualDstAmount = order.settlement?.actualDstAmount;
     const expectedDstAmount = order.type === "mint_nft" ||
         order.type === "join_tournament" ||
         order.type === "fund_tournament" ||

package/dist/cjs/anyspend/react/hooks/useAnyspendFlow.d.ts

@@ -36,6 +36,7 @@ export declare function useAnyspendFlow({ paymentType, recipientAddress, loadOrd
             relayTxs: components["schemas"]["RelayTx"][];
             executeTx: components["schemas"]["ExecuteTx"] | null;
             refundTxs: components["schemas"]["RefundTx"][];
+            points: number | null;
         };
         statusCode: number;
     } | undefined;

package/dist/cjs/anyspend/react/hooks/useAnyspendFlow.js

@@ -192,8 +192,8 @@ function useAnyspendFlow({ paymentType = "crypto", recipientAddress, loadOrder,
     // Handle order completion
     (0, react_3.useEffect)(() => {
         if (oat?.data?.order.status === "executed") {
-            // get the actualDstAmount if available from custompayload
-            const amount = oat.data.order.payload?.actualDstAmount;
+            // get the actualDstAmount if available from settlement
+            const amount = oat.data.order.settlement?.actualDstAmount;
             const formattedActualDstAmount = amount
                 ? (0, number_1.formatTokenAmount)(BigInt(amount), oat.data.order.metadata.dstToken.decimals)
                 : undefined;
@@ -201,7 +201,7 @@ function useAnyspendFlow({ paymentType = "crypto", recipientAddress, loadOrder,
         }
     }, [
         oat?.data?.order.status,
-        oat?.data?.order.payload,
+        oat?.data?.order.settlement?.actualDstAmount,
         onTransactionSuccess,
         oat?.data?.order.metadata.dstToken.decimals,
     ]);

package/dist/cjs/anyspend/react/hooks/useAnyspendOrderAndTransactions.d.ts

@@ -8,6 +8,7 @@ export declare function useAnyspendOrderAndTransactions(orderId: string | undefi
             relayTxs: import("../..").components["schemas"]["RelayTx"][];
             executeTx: import("../..").components["schemas"]["ExecuteTx"] | null;
             refundTxs: import("../..").components["schemas"]["RefundTx"][];
+            points: number | null;
         };
         statusCode: number;
     } | undefined;
@@ -22,6 +23,7 @@ export declare function useAnyspendOrderAndTransactions(orderId: string | undefi
             relayTxs: import("../..").components["schemas"]["RelayTx"][];
             executeTx: import("../..").components["schemas"]["ExecuteTx"] | null;
             refundTxs: import("../..").components["schemas"]["RefundTx"][];
+            points: number | null;
         };
         statusCode: number;
     }, Error>>;

package/dist/cjs/anyspend/react/hooks/useAnyspendOrderHistory.d.ts

@@ -18,6 +18,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "swap";
         payload: import("../..").components["schemas"]["SwapPayload"];
@@ -41,6 +44,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "hype_duel";
         payload: import("../..").components["schemas"]["HypeDuelPayload"];
@@ -64,6 +70,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "custom";
         payload: import("../..").components["schemas"]["CustomPayload"];
@@ -87,6 +96,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "mint_nft";
         payload: import("../..").components["schemas"]["MintNftPayload"];
@@ -110,6 +122,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "join_tournament";
         payload: import("../..").components["schemas"]["JoinTournamentPayload"];
@@ -133,6 +148,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "fund_tournament";
         payload: import("../..").components["schemas"]["FundTournamentPayload"];
@@ -159,6 +177,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "swap";
         payload: import("../..").components["schemas"]["SwapPayload"];
@@ -182,6 +203,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "hype_duel";
         payload: import("../..").components["schemas"]["HypeDuelPayload"];
@@ -205,6 +229,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "custom";
         payload: import("../..").components["schemas"]["CustomPayload"];
@@ -228,6 +255,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "mint_nft";
         payload: import("../..").components["schemas"]["MintNftPayload"];
@@ -251,6 +281,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "join_tournament";
         payload: import("../..").components["schemas"]["JoinTournamentPayload"];
@@ -274,6 +307,9 @@ export declare function useAnyspendOrderHistory(creatorAddress: string | undefin
         onrampMetadata: import("../..").components["schemas"]["OnrampMetadata"] | null;
         oneClickBuyUrl: string | null;
         stripePaymentIntentId: string | null;
+        settlement: {
+            actualDstAmount: string | null;
+        } | null;
     } & {
         type: "fund_tournament";
         payload: import("../..").components["schemas"]["FundTournamentPayload"];

package/dist/cjs/anyspend/types/api.d.ts

@@ -434,6 +434,11 @@ export interface paths {
                                 executeTx: components["schemas"]["ExecuteTx"] | null;
                                 /** @description Refund transactions if order failed */
                                 refundTxs: components["schemas"]["RefundTx"][];
+                                /**
+                                 * @description Points awarded for this order (only present when order status is executed)
+                                 * @example 100
+                                 */
+                                points: number | null;
                             };
                             /** @example 200 */
                             statusCode: number;
@@ -1112,11 +1117,6 @@ export interface components {
              * @example 990000
              */
             expectedDstAmount: string;
-            /**
-             * @description Actual received amount (null for new orders)
-             * @example 990000
-             */
-            actualDstAmount: string | null;
         };
         /** @description HypeDuel-specific payload */
         HypeDuelPayload: {
@@ -1125,11 +1125,6 @@ export interface components {
              * @example 990000
              */
             expectedDstAmount: string;
-            /**
-             * @description Actual received amount (null for new orders)
-             * @example 990000
-             */
-            actualDstAmount: string | null;
         };
         /** @description Custom execution payload */
         CustomPayload: {
@@ -1315,6 +1310,14 @@ export interface components {
              * @example pi_3Rko0sJnoDg53PsP0PDLsHkR
              */
             stripePaymentIntentId: string | null;
+            /** @description Settlement information for executed orders */
+            settlement: {
+                /**
+                 * @description Actual received amount after execution
+                 * @example 990000
+                 */
+                actualDstAmount: string | null;
+            } | null;
         };
         SwapOrder: components["schemas"]["BaseOrder"] & {
             /**

package/dist/cjs/anyspend/utils/orderPayload.js

@@ -8,8 +8,6 @@ const buildPayload = (orderType, params) => {
         case "swap":
             return {
                 expectedDstAmount,
-                actualDstAmount: null,
-                amountInAfterFee: null,
             };
         case "mint_nft":
             if (nft?.type === "erc1155") {
@@ -46,8 +44,6 @@ const buildPayload = (orderType, params) => {
         case "hype_duel":
             return {
                 expectedDstAmount,
-                actualDstAmount: null,
-                amountInAfterFee: null,
             };
         default:
             throw new Error(`Invalid order type: ${orderType}`);

package/dist/cjs/notifications/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./services";
+export { getAuthToken } from "../shared/utils/auth-token";

package/dist/cjs/notifications/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAuthToken = void 0;
+// Export types
+__exportStar(require("./types"), exports);
+// Export services
+__exportStar(require("./services"), exports);
+// Re-export auth token getter from shared for convenience
+// Note: Auth token is managed by B3 Global Account authentication
+var auth_token_1 = require("../shared/utils/auth-token");
+Object.defineProperty(exports, "getAuthToken", { enumerable: true, get: function () { return auth_token_1.getAuthToken; } });

package/dist/cjs/notifications/react/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from "./useNotifications";

package/dist/cjs/notifications/react/hooks/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useNotifications"), exports);

package/dist/cjs/notifications/react/hooks/useNotifications.d.ts

@@ -0,0 +1,42 @@
+import type { UserData } from "../../types";
+/**
+ * React hook for managing B3 notifications
+ * Automatically uses the authenticated user's ID from JWT
+ *
+ * @example
+ * ```tsx
+ * import { useNotifications } from '../../../notifications/react';
+ *
+ * function NotificationSettings() {
+ *   const { user, loading, connectEmail, connectTelegram, isEmailConnected } = useNotifications();
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       {!isEmailConnected && (
+ *         <button onClick={() => connectEmail('user@example.com')}>
+ *           Connect Email
+ *         </button>
+ *       )}
+ *       <button onClick={connectTelegram}>Connect Telegram</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useNotifications(): {
+    user: UserData | null;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+    connectEmail: (email: string) => Promise<void>;
+    connectTelegram: () => Promise<void>;
+    updateChannel: (channelId: string, updates: {
+        enabled?: boolean;
+    }) => Promise<void>;
+    deleteChannel: (channelId: string) => Promise<void>;
+    isEmailConnected: boolean;
+    isTelegramConnected: boolean;
+    isDiscordConnected: boolean;
+};