@basedone/core 0.2.5 → 0.2.7

package/lib/ecommerce/types/entities.ts

@@ -869,17 +869,29 @@ export interface ShippingRate extends BaseEntity {
 
 /**
  * Shipping option (calculated for checkout)
+ * 
+ * Use `rateId` when creating orders - the server will validate and calculate cost.
  */
 export interface ShippingOption {
-  /** Rate ID */
-  id: string;
-  /** Rate name */
-  name: string;
-  /** Calculated cost in USDC */
-  cost: number;
-  /** Estimated delivery string */
-  estimatedDelivery: string;
+  /** Rate ID - use this when creating orders */
+  rateId: string;
   /** Zone name */
   zoneName: string;
+  /** Rate name (e.g., "Standard", "Express") */
+  rateName: string;
+  /** Base rate in USDC */
+  baseRate: number;
+  /** Per-kg rate in USDC */
+  perKgRate: number;
+  /** Calculated total cost in USDC (for display only - server recalculates) */
+  calculatedCost: number;
+  /** Whether free shipping applies */
+  isFree: boolean;
+  /** Estimated delivery string (e.g., "5-7 business days") */
+  estimatedDelivery: string | null;
+  /** Minimum delivery days */
+  minDeliveryDays: number | null;
+  /** Maximum delivery days */
+  maxDeliveryDays: number | null;
 }
 

package/lib/ecommerce/types/requests.ts

@@ -150,13 +150,31 @@ export interface CreateOrderRequest {
   couponCode?: string;
   /** Idempotency key */
   idempotencyKey?: string;
-  /** Selected shipping method name (e.g., "Standard", "Express") */
+  /**
+   * Selected shipping rate ID (from shipping calculator)
+   * The server will validate this rate and calculate the cost server-side.
+   * 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
+  // These fields are ignored by the server for security reasons.
+  // Shipping cost must be calculated server-side using shippingRateId.
+  // =====================================================
+  
+  /** @deprecated Use shippingRateId instead. This value is ignored by the server. */
   shippingMethod?: string;
-  /** Calculated shipping cost in USDC */
+  /** @deprecated Use shippingRateId instead. This value is ignored by the server. */
   shippingCost?: number;
-  /** Shipping zone name for reference */
+  /** @deprecated Use shippingRateId instead. This value is ignored by the server. */
   shippingZone?: string;
-  /** Estimated delivery time (e.g., "5-7 business days") */
+  /** @deprecated Use shippingRateId instead. This value is ignored by the server. */
   estimatedDelivery?: 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basedone/core",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Core utilities for Based One",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -30,9 +30,17 @@
     "ecommerce.ts",
     "lib"
   ],
+  "scripts": {
+    "build": "rm -rf dist && tsup index.ts react.ts ecommerce.ts --format cjs,esm --dts",
+    "dev": "tsup index.ts react.ts ecommerce.ts --format cjs,esm --dts --watch",
+    "test": "vitest",
+    "update-meta": "tsx scripts/update-static-meta.ts",
+    "prepublishOnly": "pnpm build"
+  },
   "keywords": [],
   "author": "",
   "license": "ISC",
+  "packageManager": "pnpm@10.10.0",
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@types/react": "^18.0.0",
@@ -54,11 +62,5 @@
     "react": {
       "optional": true
     }
-  },
-  "scripts": {
-    "build": "rm -rf dist && tsup index.ts react.ts ecommerce.ts --format cjs,esm --dts",
-    "dev": "tsup index.ts react.ts ecommerce.ts --format cjs,esm --dts --watch",
-    "test": "vitest",
-    "update-meta": "tsx scripts/update-static-meta.ts"
   }
-}
+}