@b3dotfun/sdk 0.0.44 → 0.0.45

package/dist/esm/notifications/types/index.d.ts

@@ -0,0 +1,50 @@
+export type ChannelType = "email" | "telegram" | "discord" | "sms" | "whatsapp" | "in_app";
+export interface NotificationChannel {
+    id: number;
+    channel_type: ChannelType;
+    enabled: number;
+    channel_identifier: string;
+}
+export interface UserData {
+    user: {
+        id: number;
+        user_id: string;
+    };
+    channels: NotificationChannel[];
+    appSettings: Array<{
+        app_id: string;
+        notification_type: string;
+        enabled: number;
+        channels: string;
+    }>;
+}
+export interface NotificationHistory {
+    id: string;
+    app_id: string;
+    notification_type: string;
+    title: string;
+    message: string;
+    created_at: string;
+    read: boolean;
+}
+export interface TelegramLinkResponse {
+    deepLink: string;
+    verificationCode: string;
+    botUsername: string;
+}
+export interface TelegramStatusResponse {
+    connected: boolean;
+    chatId?: string;
+}
+export interface NotificationPreferences {
+    notificationType: string;
+    channels: string[];
+}
+export interface SendNotificationRequest {
+    userId: string;
+    appId: string;
+    notificationType: string;
+    message: string;
+    title?: string;
+    data?: Record<string, any>;
+}

package/dist/esm/shared/utils/auth-token.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Get the authentication token from the B3 auth cookie
+ * This token is managed by the B3 Global Account authentication system
+ *
+ * @returns The JWT token string or null if not found
+ */
+export declare function getAuthToken(): string | null;

package/dist/esm/shared/utils/auth-token.js

@@ -0,0 +1,11 @@
+import Cookies from "js-cookie";
+const B3_AUTH_COOKIE_NAME = "b3-auth";
+/**
+ * Get the authentication token from the B3 auth cookie
+ * This token is managed by the B3 Global Account authentication system
+ *
+ * @returns The JWT token string or null if not found
+ */
+export function getAuthToken() {
+    return Cookies.get(B3_AUTH_COOKIE_NAME) || null;
+}

package/dist/esm/shared/utils/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./auth-token";
 export * from "./cn";
 export * from "./formatNumber";
 export * from "./formatUsername";

package/dist/esm/shared/utils/index.js

@@ -1,4 +1,5 @@
 // Export utility functions
+export * from "./auth-token.js";
 export * from "./cn.js";
 export * from "./formatNumber.js";
 export * from "./formatUsername.js";

package/dist/types/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/types/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/types/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/types/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/types/notifications/index.d.ts

@@ -0,0 +1,4 @@
+export declare const VERSION = "1.0.0";
+export * from "./types";
+export * from "./services";
+export { getAuthToken } from "../shared/utils/auth-token";

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

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

package/dist/types/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 '@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>
+ *   );
+ * }
+ * ```
+ */
+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;
+};

package/dist/types/notifications/react/index.d.ts

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

package/dist/types/notifications/services/api.d.ts

@@ -0,0 +1,65 @@
+import type { NotificationHistory, NotificationPreferences, SendNotificationRequest, TelegramLinkResponse, TelegramStatusResponse, UserData } from "../types";
+export declare function setApiUrl(url: string): void;
+export declare function getApiUrl(): string;
+export declare const notificationsAPI: {
+    /**
+     * Register the current user (userId extracted from JWT)
+     */
+    registerUser(): Promise<any>;
+    /**
+     * Get current user's profile and preferences
+     */
+    getUser(): Promise<UserData>;
+    /**
+     * Get current user's notification history
+     */
+    getHistory(appId?: string, limit?: number): Promise<NotificationHistory[]>;
+    /**
+     * Add a notification channel for current user
+     */
+    addChannel(channelType: string, channelIdentifier: string, metadata?: Record<string, any>): Promise<any>;
+    /**
+     * Connect email for current user
+     */
+    connectEmail(email: string): Promise<any>;
+    /**
+     * Update a notification channel
+     */
+    updateChannel(channelId: string, updates: {
+        enabled?: boolean;
+        channelIdentifier?: string;
+        metadata?: Record<string, any>;
+    }): Promise<any>;
+    /**
+     * Delete a notification channel
+     */
+    deleteChannel(channelId: string): Promise<any>;
+    /**
+     * Get Telegram deep link for current user
+     */
+    getTelegramLink(): Promise<TelegramLinkResponse>;
+    /**
+     * Check current user's Telegram connection status
+     */
+    checkTelegramStatus(): Promise<TelegramStatusResponse>;
+    /**
+     * Save notification preferences for an app
+     */
+    savePreferences(appId: string, settings: NotificationPreferences): Promise<any>;
+    /**
+     * Get notification settings for an app
+     */
+    getAppSettings(appId: string): Promise<any>;
+    /**
+     * Get current user's in-app notifications
+     */
+    getInAppNotifications(): Promise<any>;
+    /**
+     * Mark a notification as read
+     */
+    markNotificationAsRead(notificationId: string): Promise<any>;
+    /**
+     * Send a notification (requires auth)
+     */
+    sendNotification(data: SendNotificationRequest): Promise<any>;
+};

package/dist/types/notifications/services/index.d.ts

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

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

@@ -0,0 +1,50 @@
+export type ChannelType = "email" | "telegram" | "discord" | "sms" | "whatsapp" | "in_app";
+export interface NotificationChannel {
+    id: number;
+    channel_type: ChannelType;
+    enabled: number;
+    channel_identifier: string;
+}
+export interface UserData {
+    user: {
+        id: number;
+        user_id: string;
+    };
+    channels: NotificationChannel[];
+    appSettings: Array<{
+        app_id: string;
+        notification_type: string;
+        enabled: number;
+        channels: string;
+    }>;
+}
+export interface NotificationHistory {
+    id: string;
+    app_id: string;
+    notification_type: string;
+    title: string;
+    message: string;
+    created_at: string;
+    read: boolean;
+}
+export interface TelegramLinkResponse {
+    deepLink: string;
+    verificationCode: string;
+    botUsername: string;
+}
+export interface TelegramStatusResponse {
+    connected: boolean;
+    chatId?: string;
+}
+export interface NotificationPreferences {
+    notificationType: string;
+    channels: string[];
+}
+export interface SendNotificationRequest {
+    userId: string;
+    appId: string;
+    notificationType: string;
+    message: string;
+    title?: string;
+    data?: Record<string, any>;
+}

package/dist/types/shared/utils/auth-token.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Get the authentication token from the B3 auth cookie
+ * This token is managed by the B3 Global Account authentication system
+ *
+ * @returns The JWT token string or null if not found
+ */
+export declare function getAuthToken(): string | null;

package/dist/types/shared/utils/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./auth-token";
 export * from "./cn";
 export * from "./formatNumber";
 export * from "./formatUsername";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.0.44",
+  "version": "0.0.45",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",
@@ -170,6 +170,26 @@
       "import": "./dist/esm/global-account/server.js",
       "require": "./dist/cjs/global-account/server.js"
     },
+    "./notifications": {
+      "types": "./dist/types/notifications/index.d.ts",
+      "import": "./dist/esm/notifications/index.js",
+      "require": "./dist/cjs/notifications/index.js"
+    },
+    "./notifications/react": {
+      "types": "./dist/types/notifications/react/index.d.ts",
+      "import": "./dist/esm/notifications/react/index.js",
+      "require": "./dist/cjs/notifications/react/index.js"
+    },
+    "./notifications/services": {
+      "types": "./dist/types/notifications/services/index.d.ts",
+      "import": "./dist/esm/notifications/services/index.js",
+      "require": "./dist/cjs/notifications/services/index.js"
+    },
+    "./notifications/types": {
+      "types": "./dist/types/notifications/types/index.d.ts",
+      "import": "./dist/esm/notifications/types/index.js",
+      "require": "./dist/cjs/notifications/types/index.js"
+    },
     "./shared/utils": {
       "types": "./dist/types/shared/utils/index.d.ts",
       "import": "./dist/esm/shared/utils/index.js",

package/src/anyspend/react/components/common/OrderDetails.tsx

@@ -391,13 +391,7 @@ export const OrderDetails = memo(function OrderDetails({
       : order.payload.expectedDstAmount.toString();
   const formattedExpectedDstAmount = 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
     ? formatTokenAmount(BigInt(actualDstAmount), dstToken.decimals)
     : undefined;

package/src/anyspend/react/components/common/OrderHistoryItem.tsx

@@ -18,13 +18,7 @@ export function OrderHistoryItem({ order, onSelectOrder, mode }: OrderHistoryIte
   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" ||

package/src/anyspend/react/hooks/useAnyspendFlow.ts

@@ -247,8 +247,8 @@ export function useAnyspendFlow({
   // Handle order completion
   useEffect(() => {
     if (oat?.data?.order.status === "executed") {
-      // get the actualDstAmount if available from custompayload
-      const amount = (oat.data.order.payload as { actualDstAmount?: string })?.actualDstAmount;
+      // get the actualDstAmount if available from settlement
+      const amount = oat.data.order.settlement?.actualDstAmount;
       const formattedActualDstAmount = amount
         ? formatTokenAmount(BigInt(amount), oat.data.order.metadata.dstToken.decimals)
         : undefined;
@@ -256,7 +256,7 @@ export function useAnyspendFlow({
     }
   }, [
     oat?.data?.order.status,
-    oat?.data?.order.payload,
+    oat?.data?.order.settlement?.actualDstAmount,
     onTransactionSuccess,
     oat?.data?.order.metadata.dstToken.decimals,
   ]);

package/src/anyspend/types/api.ts

@@ -435,6 +435,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;
@@ -1119,11 +1124,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: {
@@ -1132,11 +1132,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: {
@@ -1332,6 +1327,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/src/anyspend/utils/orderPayload.ts

@@ -17,8 +17,6 @@ export const buildPayload = (orderType: components["schemas"]["Order"]["type"],
     case "swap":
       return {
         expectedDstAmount,
-        actualDstAmount: null,
-        amountInAfterFee: null,
       };
     case "mint_nft":
       if (nft?.type === "erc1155") {
@@ -53,8 +51,6 @@ export const buildPayload = (orderType: components["schemas"]["Order"]["type"],
     case "hype_duel":
       return {
         expectedDstAmount,
-        actualDstAmount: null,
-        amountInAfterFee: null,
       };
     default:
       throw new Error(`Invalid order type: ${orderType}`);

package/src/notifications/index.ts

@@ -0,0 +1,11 @@
+export const VERSION = "1.0.0";
+
+// Export types
+export * from "./types";
+
+// Export services
+export * from "./services";
+
+// Re-export auth token getter from shared for convenience
+// Note: Auth token is managed by B3 Global Account authentication
+export { getAuthToken } from "../shared/utils/auth-token";

package/src/notifications/react/hooks/index.ts

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