@b3dotfun/sdk 0.0.70-alpha.0 → 0.0.70-alpha.2

package/src/anyspend/utils/validation.ts

@@ -0,0 +1,209 @@
+export interface ValidationResult {
+  isValid: boolean;
+  error?: string;
+  cleaned?: string;
+}
+
+export interface StringValidationOptions {
+  // Required/Optional
+  required?: boolean;
+  defaultValue?: () => string; // Generator for default (e.g., UUID)
+
+  // Length constraints
+  minLength?: number;
+  maxLength?: number;
+
+  // Character constraints
+  pattern?: RegExp;
+  patternErrorMessage?: string;
+
+  // Pre-processing
+  trim?: boolean; // Default: true
+  toLowerCase?: boolean;
+  toUpperCase?: boolean;
+
+  // Custom validation
+  customValidator?: (value: string) => { valid: boolean; error?: string };
+}
+
+/**
+ * Generic string validator with configurable rules
+ */
+export function validateString(value: string | undefined, options: StringValidationOptions): ValidationResult {
+  const {
+    required = false,
+    defaultValue,
+    minLength,
+    maxLength,
+    pattern,
+    patternErrorMessage,
+    trim = true,
+    toLowerCase = false,
+    toUpperCase = false,
+    customValidator,
+  } = options;
+
+  // Handle empty/undefined
+  if (!value || (trim && value.trim() === "")) {
+    if (required && !defaultValue) {
+      return { isValid: false, error: "This field is required" };
+    }
+    if (defaultValue) {
+      return { isValid: true, cleaned: defaultValue() };
+    }
+    return { isValid: true, cleaned: undefined };
+  }
+
+  // Pre-processing
+  let cleaned = value;
+  if (trim) cleaned = cleaned.trim();
+  if (toLowerCase) cleaned = cleaned.toLowerCase();
+  if (toUpperCase) cleaned = cleaned.toUpperCase();
+
+  // Length validation
+  if (minLength !== undefined && cleaned.length < minLength) {
+    return {
+      isValid: false,
+      error: `Minimum length is ${minLength} characters`,
+    };
+  }
+
+  if (maxLength !== undefined && cleaned.length > maxLength) {
+    return {
+      isValid: false,
+      error: `Maximum length is ${maxLength} characters`,
+    };
+  }
+
+  // Pattern validation
+  if (pattern && !pattern.test(cleaned)) {
+    return {
+      isValid: false,
+      error: patternErrorMessage || "Invalid format",
+    };
+  }
+
+  // Custom validation
+  if (customValidator) {
+    const customResult = customValidator(cleaned);
+    if (!customResult.valid) {
+      return { isValid: false, error: customResult.error };
+    }
+  }
+
+  return { isValid: true, cleaned };
+}
+
+/**
+ * Common validation patterns
+ */
+export const ValidationPatterns = {
+  ALPHANUMERIC: /^[a-zA-Z0-9]+$/,
+  ALPHANUMERIC_WITH_DASH_UNDERSCORE: /^[a-zA-Z0-9_-]+$/,
+  ALPHANUMERIC_WITH_SAFE_CHARS: /^[a-zA-Z0-9_.\-]+$/,
+  SAFE_IDENTIFIER: /^[a-zA-Z0-9_.\-]+$/, // For IDs, references
+  NO_CONTROL_CHARS: /^[^\x00-\x1F\x7F]+$/,
+  URL_SAFE: /^[a-zA-Z0-9_.\-~]+$/,
+  NUMERIC: /^\d+$/,
+  HEX: /^[0-9a-fA-F]+$/,
+} as const;
+
+/**
+ * Pre-configured validators for common use cases
+ */
+export const Validators = {
+  /**
+   * Validates client reference IDs (alphanumeric + safe chars)
+   * Returns undefined if not provided
+   */
+  clientReferenceId: (value?: string) =>
+    validateString(value, {
+      required: false,
+      maxLength: 255,
+      pattern: ValidationPatterns.SAFE_IDENTIFIER,
+      patternErrorMessage: "Only letters, numbers, hyphens, underscores, and dots allowed",
+      trim: true,
+      customValidator: val => {
+        // Additional security checks
+        const dangerous = /('|"|;|--|\/\*|\*\/|<|>|script)/i;
+        if (dangerous.test(val)) {
+          return {
+            valid: false,
+            error: "Contains potentially dangerous characters",
+          };
+        }
+        return { valid: true };
+      },
+    }),
+
+  /**
+   * Validates alphanumeric strings (letters and numbers only)
+   */
+  alphanumeric: (value?: string, required = false) =>
+    validateString(value, {
+      required,
+      pattern: ValidationPatterns.ALPHANUMERIC,
+      patternErrorMessage: "Only letters and numbers allowed",
+      trim: true,
+    }),
+
+  /**
+   * Validates wallet addresses (hex format)
+   */
+  walletAddress: (value?: string, required = true) =>
+    validateString(value, {
+      required,
+      minLength: 42,
+      maxLength: 42,
+      pattern: /^0x[a-fA-F0-9]{40}$/,
+      patternErrorMessage: "Invalid wallet address format",
+      trim: true,
+      toLowerCase: true,
+    }),
+
+  /**
+   * Validates order IDs (UUID format)
+   */
+  orderId: (value?: string) =>
+    validateString(value, {
+      required: false,
+      pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+      patternErrorMessage: "Invalid order ID format",
+      trim: true,
+      toLowerCase: true,
+    }),
+
+  /**
+   * Validates URL-safe strings
+   */
+  urlSafe: (value?: string, maxLength = 255) =>
+    validateString(value, {
+      maxLength,
+      pattern: ValidationPatterns.URL_SAFE,
+      patternErrorMessage: "Contains invalid URL characters",
+      trim: true,
+    }),
+
+  /**
+   * Validates safe identifiers (no injection risks)
+   */
+  safeIdentifier: (value?: string, required = false) =>
+    validateString(value, {
+      required,
+      maxLength: 255,
+      pattern: ValidationPatterns.SAFE_IDENTIFIER,
+      patternErrorMessage: "Invalid identifier format",
+      customValidator: val => {
+        // Additional security checks
+        const dangerous = /('|"|;|--|\/\*|\*\/|<|>|script)/i;
+        if (dangerous.test(val)) {
+          return {
+            valid: false,
+            error: "Contains potentially dangerous characters",
+          };
+        }
+        return { valid: true };
+      },
+      trim: true,
+    }),
+};

package/src/global-account/react/components/B3DynamicModal.tsx

@@ -2,6 +2,7 @@ import {
   AnySpend,
   AnySpendBondKit,
   AnySpendBuySpin,
+  AnySpendCollectorClubPurchase,
   AnySpendNFT,
   AnyspendSignatureMint,
   AnySpendStakeB3,
@@ -143,6 +144,8 @@ export function B3DynamicModal() {
         return <LinkAccount {...contentType} />;
       case "anySpendDepositHype":
         return <AnySpendDepositHype {...contentType} mode="modal" />;
+      case "anySpendCollectorClubPurchase":
+        return <AnySpendCollectorClubPurchase {...contentType} mode="modal" />;
       case "avatarEditor":
         return <AvatarEditor onSetAvatar={contentType.onSuccess} />;
       case "profileEditor":

package/src/global-account/react/components/B3Provider/B3Provider.tsx

@@ -58,6 +58,7 @@ export function B3Provider({
   onConnect,
   connectors,
   overrideDefaultConnectors = false,
+  createClientReferenceId,
 }: {
   theme: "light" | "dark";
   children: React.ReactNode;
@@ -75,6 +76,7 @@ export function B3Provider({
   onConnect?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
   connectors?: CreateConnectorFn[];
   overrideDefaultConnectors?: boolean;
+  createClientReferenceId?: () => string;
 }) {
   // Initialize Google Analytics on mount
   useEffect(() => {
@@ -100,6 +102,7 @@ export function B3Provider({
                 automaticallySetFirstEoa={!!automaticallySetFirstEoa}
                 clientType={clientType}
                 partnerId={partnerId}
+                createClientReferenceId={createClientReferenceId}
               >
                 <RelayKitProviderWrapper simDuneApiKey={simDuneApiKey}>
                   {children}
@@ -128,6 +131,7 @@ export function InnerProvider({
   theme = "light",
   clientType = "socket",
   partnerId,
+  createClientReferenceId,
 }: {
   children: React.ReactNode;
   accountOverride?: Account;
@@ -137,6 +141,7 @@ export function InnerProvider({
   theme: "light" | "dark";
   clientType?: ClientType;
   partnerId: string;
+  createClientReferenceId?: () => string;
 }) {
   const activeAccount = useActiveAccount();
   const [manuallySelectedWallet, setManuallySelectedWallet] = useState<Wallet | undefined>(undefined);
@@ -204,6 +209,7 @@ export function InnerProvider({
         theme,
         clientType,
         partnerId: partnerId,
+        createClientReferenceId,
       }}
     >
       <InnerProvider2>{children}</InnerProvider2>

package/src/global-account/react/components/B3Provider/types.ts

@@ -22,6 +22,7 @@ export interface B3ContextType {
   theme: "light" | "dark";
   clientType: ClientType;
   partnerId: string;
+  createClientReferenceId?: () => string;
 }
 
 /**
@@ -41,4 +42,5 @@ export const B3Context = createContext<B3ContextType>({
   theme: "light",
   clientType: "rest",
   partnerId: "",
+  createClientReferenceId: undefined,
 });

package/src/global-account/react/stores/useModalStore.ts

@@ -128,6 +128,8 @@ export interface AnySpendModalProps extends BaseModalProps {
   destinationTokenChainId?: number;
   /** Custom USD input values for quick amount buttons in fiat onramp */
   customUsdInputValues?: string[];
+  /** Client-provided reference ID for tracking orders */
+  clientReferenceId?: string;
 }
 
 /**
@@ -143,6 +145,8 @@ export interface AnySpendNftProps extends BaseModalProps {
   recipientAddress?: string;
   /** Callback function called when the NFT is successfully transferred */
   onSuccess?: (txHash?: string) => void;
+  /** Client-provided reference ID for tracking orders */
+  clientReferenceId?: string;
 }
 
 /**
@@ -401,6 +405,29 @@ export interface ProfileEditorModalProps extends BaseModalProps {
   onSuccess?: () => void;
 }
 
+/**
+ * Props for the AnySpend Collector Club Purchase modal
+ * Handles Collector Club pack purchases
+ */
+export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
+  /** Modal type identifier */
+  type: "anySpendCollectorClubPurchase";
+  /** The pack ID to purchase */
+  packId: number;
+  /** The number of packs to purchase */
+  packAmount: number;
+  /** Price per pack in wei (e.g., "10000" for 0.01 USDC with 6 decimals) */
+  pricePerPack: string;
+  /** Recipient address to receive the packs */
+  recipientAddress: string;
+  /** Payment type - crypto or fiat */
+  paymentType?: "crypto" | "fiat";
+  /** Callback function called when the purchase is successful */
+  onSuccess?: (txHash?: string) => void;
+  /** Client-provided reference ID for tracking orders */
+  clientReferenceId?: string;
+}
+
 /**
  * Union type of all possible modal content types
  */
@@ -425,7 +452,8 @@ export type ModalContentType =
   | LinkAccountModalProps
   | AnySpendDepositHypeProps
   | AvatarEditorModalProps
-  | ProfileEditorModalProps;
+  | ProfileEditorModalProps
+  | AnySpendCollectorClubPurchaseProps;
 // Add other modal types here like: | OtherModalProps | AnotherModalProps
 
 /**