@basedone/core 0.2.6 → 0.2.8

package/lib/ecommerce/types/entities.ts

@@ -9,6 +9,8 @@ import {
   PaymentMethod,
   PaymentStatus,
   MerchantStatus,
+  MerchantBusinessType,
+  MerchantReturnPolicyType,
   ShipmentStatus,
   ReturnStatus,
   ReviewStatus,
@@ -127,6 +129,22 @@ export interface ProductVariant extends BaseEntity {
   sortOrder: number;
 }
 
+/**
+ * Social links for merchant profile
+ */
+export interface MerchantSocialLinks {
+  /** Twitter/X profile URL */
+  twitter?: string | null;
+  /** Instagram profile URL */
+  instagram?: string | null;
+  /** Facebook page URL */
+  facebook?: string | null;
+  /** Discord server invite URL */
+  discord?: string | null;
+  /** Telegram channel/group URL */
+  telegram?: string | null;
+}
+
 /**
  * Merchant entity
  */
@@ -141,6 +159,44 @@ export interface Merchant extends BaseEntity {
   payoutAddress: string;
   /** Merchant status */
   status: MerchantStatus;
+
+  // Contact information
+  /** Contact email for notifications and customer inquiries */
+  email?: string | null;
+  /** Contact phone number */
+  phone?: string | null;
+  /** Store website URL */
+  website?: string | null;
+
+  // Business information
+  /** Business type (individual, company, etc.) */
+  businessType?: MerchantBusinessType;
+
+  // Branding
+  /** Store logo/avatar URL */
+  logoUrl?: string | null;
+  /** Store banner image URL */
+  bannerUrl?: string | null;
+
+  // Social links
+  /** Social media links */
+  socialLinks?: MerchantSocialLinks | null;
+
+  // Return policy
+  /** Return policy type */
+  returnPolicyType?: MerchantReturnPolicyType;
+  /** Custom return policy details/text */
+  returnPolicyDetails?: string | null;
+  /** Return window in days (e.g., 30) */
+  returnWindowDays?: number | null;
+
+  // Location
+  /** ISO 2-letter country code (for tax/shipping) */
+  country?: string | null;
+  /** City name */
+  city?: string | null;
+  /** Street address */
+  addressLine1?: string | null;
 }
 
 /**

package/lib/ecommerce/types/enums.ts

@@ -70,6 +70,38 @@ export enum MerchantStatus {
   PENDING = "PENDING",
 }
 
+/**
+ * Merchant business type enum
+ */
+export enum MerchantBusinessType {
+  /** Individual seller */
+  INDIVIDUAL = "INDIVIDUAL",
+  /** Registered company */
+  COMPANY = "COMPANY",
+  /** Partnership */
+  PARTNERSHIP = "PARTNERSHIP",
+  /** Non-profit organization */
+  NON_PROFIT = "NON_PROFIT",
+}
+
+/**
+ * Merchant return policy type enum
+ */
+export enum MerchantReturnPolicyType {
+  /** No returns accepted */
+  NO_RETURNS = "NO_RETURNS",
+  /** Exchange for same/similar item only */
+  EXCHANGE_ONLY = "EXCHANGE_ONLY",
+  /** Refund as store credit only */
+  STORE_CREDIT = "STORE_CREDIT",
+  /** Full refund available */
+  FULL_REFUND = "FULL_REFUND",
+  /** Partial refund (restocking fee may apply) */
+  PARTIAL_REFUND = "PARTIAL_REFUND",
+  /** Handled on a case-by-case basis */
+  CASE_BY_CASE = "CASE_BY_CASE",
+}
+
 /**
  * Shipment status enum
  */

package/lib/ecommerce/types/requests.ts

@@ -156,6 +156,11 @@ export interface CreateOrderRequest {
    * SECURITY: The cost is never trusted from the frontend.
    */
   shippingRateId?: string;
+  /**
+   * Shipping method name (e.g., "On-site Collection")
+   * Sent as fallback when validation is disabled, so the method name can still be stored.
+   */
+  shippingMethodName?: string;
   
   // =====================================================
   // DEPRECATED FIELDS - Do not use
@@ -179,6 +184,8 @@ export interface CreateOrderRequest {
 export interface ListOrdersParams extends PaginationParams {
   /** Filter by status */
   status?: OrderStatus;
+  /** Filter by merchant ID (for godview access) */
+  merchantId?: string;
 }
 
 /**

package/lib/ecommerce/types/responses.ts

@@ -1,6 +1,6 @@
 /**
  * Ecommerce API Response Types
- * 
+ *
  * This module contains all response types for the ecommerce API.
  */
 
@@ -61,7 +61,7 @@ export interface ListProductsResponse extends PaginatedResponse<Product> {}
 
 /**
  * Get product response
- * 
+ *
  * Note: The API returns the product object directly, not wrapped in a `product` field.
  * This type extends Product to be compatible with the actual API response.
  */
@@ -465,11 +465,13 @@ export interface CouponResponse {
 export interface GetCouponResponse {
   /** Coupon with usages */
   coupon: Coupon & {
-    usages: Array<CouponUsage & {
-      user: {
-        username?: string;
-      };
-    }>;
+    usages: Array<
+      CouponUsage & {
+        user: {
+          username?: string;
+        };
+      }
+    >;
   };
 }
 
@@ -494,17 +496,19 @@ export interface ShippingMethodResponse {
  */
 export interface ListShipmentsResponse {
   /** Shipments */
-  shipments: Array<Shipment & {
-    order: {
-      id: string;
-      totalUSDC: string;
-      shippingAddress: any;
-      user: {
+  shipments: Array<
+    Shipment & {
+      order: {
         id: string;
-        username?: string;
+        totalUSDC: string;
+        shippingAddress: any;
+        user: {
+          id: string;
+          username?: string;
+        };
       };
-    };
-  }>;
+    }
+  >;
 }
 
 /**
@@ -520,16 +524,18 @@ export interface ShipmentResponse {
  */
 export interface ListReturnsResponse {
   /** Returns */
-  returns: Array<Return & {
-    user: {
-      id: string;
-      username?: string;
-    };
-    order: {
-      id: string;
-      totalUSDC: string;
-    };
-  }>;
+  returns: Array<
+    Return & {
+      user: {
+        id: string;
+        username?: string;
+      };
+      order: {
+        id: string;
+        totalUSDC: string;
+      };
+    }
+  >;
 }
 
 /**
@@ -603,7 +609,7 @@ export interface MessageResponse {
 
 /**
  * Customer messages response (for retail users)
- * 
+ *
  * Groups messages by order, where each order represents a conversation with a merchant.
  */
 export interface CustomerMessagesResponse {
@@ -790,17 +796,19 @@ export interface GetProductMetricsResponse {
  */
 export interface ListInventoryAuditResponse {
   /** Entries */
-  entries: Array<InventoryAuditEntry & {
-    product: {
-      id: string;
-      title: string;
-      images: string[];
-    };
-    variant?: {
-      id: string;
-      name: string;
-    };
-  }>;
+  entries: Array<
+    InventoryAuditEntry & {
+      product: {
+        id: string;
+        title: string;
+        images: string[];
+      };
+      variant?: {
+        id: string;
+        name: string;
+      };
+    }
+  >;
 }
 
 /**
@@ -997,14 +1005,16 @@ import type {
  */
 export interface ShippingSettingsResponse {
   /** Shipping settings */
-  settings: MerchantShippingSettings | {
-    defaultHandlingFee: number;
-    defaultProcessingDays: number;
-    freeShippingEnabled: boolean;
-    freeShippingThreshold: number | null;
-    defaultWeightKg: number;
-    showEstimatedDelivery: boolean;
-  };
+  settings:
+    | MerchantShippingSettings
+    | {
+        defaultHandlingFee: number;
+        defaultProcessingDays: number;
+        freeShippingEnabled: boolean;
+        freeShippingThreshold: number | null;
+        defaultWeightKg: number;
+        showEstimatedDelivery: boolean;
+      };
 }
 
 /**
@@ -1118,7 +1128,13 @@ export interface ProcessPaymentResponse {
   /** Blockchain transaction hash (for crypto payments) */
   transactionHash?: string;
   /** Payment status */
-  status: "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "REFUNDED";
+  status:
+    | "PENDING"
+    | "PROCESSING"
+    | "COMPLETED"
+    | "FAILED"
+    | "CANCELLED"
+    | "REFUNDED";
   /** Amount charged */
   amount: number;
   /** Currency */
@@ -1136,7 +1152,7 @@ export interface ProcessPaymentResponse {
 /**
  * Gem source type - how gems were earned
  */
-export type GemSource = 
+export type GemSource =
   | "BUILDER_CODE"
   | "PREDICTION"
   | "CARD_SPEND"
@@ -1295,3 +1311,29 @@ export interface DeleteBrowsingLocationResponse {
   message: string;
 }
 
+// ============================================================================
+// BasedPay Cash Account Responses
+// ============================================================================
+
+/**
+ * Cash account balance response
+ */
+export interface CashAccountBalanceResponse {
+  /** Balance amount */
+  balance: string;
+  /** Currency code (e.g., "USD") */
+  currency: string;
+}
+
+export interface DeliveryAddressResponse {
+  name: string;
+  phoneNumber: string;
+  deliveryAddress: {
+    addressLine1: string;
+    addressLine2?: string | null;
+    postalCode: string;
+    city: string | null;
+    region: string | null;
+    country: string;
+  };
+}

package/lib/hip3/market-info.ts

@@ -1,4 +1,4 @@
-import { InfoClient, PerpsAssetCtx, MarginTables } from "@nktkas/hyperliquid";
+import { InfoClient, PerpsAssetCtx, MarginTables, PerpDex as LegacyPerpDex } from "@nktkas/hyperliquid";
 
 export interface PerpsMeta {
   collateralToken: number;
@@ -34,6 +34,10 @@ export interface PerpsUniverse {
   marginMode?: "strictIsolated" | "noCross";
 }
 
+export interface PerpDex extends LegacyPerpDex {
+  deployerFeeScale: string;
+}
+
 export type AllPerpsMeta = PerpsMeta[];
 
 export async function getAllPerpsMeta(

package/lib/hip3/utils.ts

@@ -102,6 +102,8 @@ const dexToCollateralTokenSymbol = {
   hyna: "USDE",
   flx: "USDH",
   vntl: "USDH",
+  km: "USDH",
+  cash: "USDT0",
 };
 
 export const isSpotSymbol = (coin: string | undefined) => {