brainerce 1.47.3 → 1.48.0

package/README.md

@@ -3082,6 +3082,13 @@ const profile = await client.getMyProfile();
 console.log(profile.firstName);
 console.log(profile.email);
 console.log(profile.addresses);
+
+// profile.role is a free-form segment the merchant sets from the dashboard
+// (e.g. "wholesale", "vip") — not customer-editable. Use it to gate custom
+// storefront features/UI: wholesale pricing, a VIP section, etc.
+if (profile.role === 'wholesale') {
+  // show wholesale pricing / a bulk-order UI
+}
 ```
 
 #### Get Customer Orders

package/dist/index.d.mts

@@ -299,6 +299,8 @@ interface CustomerProfile {
     phone?: string;
     emailVerified: boolean;
     acceptsMarketing: boolean;
+    /** Free-form segment set by the merchant (e.g. "wholesale", "vip") — use to gate custom storefront features. Admin-set only, never customer-editable. */
+    role?: string;
     addresses: CustomerAddress[];
     createdAt: string;
     updatedAt: string;
@@ -1863,6 +1865,8 @@ interface Customer {
     emailVerified: boolean;
     acceptsMarketing: boolean;
     tags: string[];
+    /** Free-form segment set by the merchant (e.g. "wholesale", "vip") — use to gate custom storefront features. Admin-set only, never customer-editable. */
+    role?: string;
     totalOrders: number;
     lastOrderAt?: string;
     metadata?: Record<string, unknown>;
@@ -1962,6 +1966,8 @@ interface CreateCustomerDto {
     password?: string;
     acceptsMarketing?: boolean;
     tags?: string[];
+    /** Free-form merchant-set segment (e.g. "wholesale", "vip"), max 50 chars. */
+    role?: string;
     metadata?: Record<string, unknown>;
 }
 interface UpdateCustomerDto {
@@ -1971,6 +1977,8 @@ interface UpdateCustomerDto {
     lastName?: string;
     acceptsMarketing?: boolean;
     tags?: string[];
+    /** Free-form merchant-set segment. Pass '' to clear it. */
+    role?: string;
     metadata?: Record<string, unknown>;
 }
 interface CustomerQueryParams {
@@ -1978,6 +1986,8 @@ interface CustomerQueryParams {
     limit?: number;
     search?: string;
     hasAccount?: boolean;
+    /** Filter by merchant-set customer role/segment (exact match, case-insensitive). */
+    role?: string;
     sortBy?: 'createdAt' | 'email' | 'firstName' | 'lastName' | 'lastOrderAt';
     sortOrder?: 'asc' | 'desc';
 }
@@ -7363,6 +7373,8 @@ declare class BrainerceClient {
         lastName?: string;
         phone?: string;
         emailVerified: boolean;
+        /** Free-form segment set by the merchant (e.g. "wholesale", "vip") — use to gate custom storefront features. */
+        role?: string;
     }>;
     /**
      * Get all addresses for a customer
@@ -10584,7 +10596,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.45.0";
+declare const SDK_VERSION = "1.48.0";
 
 /**
  * Verify a webhook signature from Brainerce

package/dist/index.d.ts

@@ -299,6 +299,8 @@ interface CustomerProfile {
     phone?: string;
     emailVerified: boolean;
     acceptsMarketing: boolean;
+    /** Free-form segment set by the merchant (e.g. "wholesale", "vip") — use to gate custom storefront features. Admin-set only, never customer-editable. */
+    role?: string;
     addresses: CustomerAddress[];
     createdAt: string;
     updatedAt: string;
@@ -1863,6 +1865,8 @@ interface Customer {
     emailVerified: boolean;
     acceptsMarketing: boolean;
     tags: string[];
+    /** Free-form segment set by the merchant (e.g. "wholesale", "vip") — use to gate custom storefront features. Admin-set only, never customer-editable. */
+    role?: string;
     totalOrders: number;
     lastOrderAt?: string;
     metadata?: Record<string, unknown>;
@@ -1962,6 +1966,8 @@ interface CreateCustomerDto {
     password?: string;
     acceptsMarketing?: boolean;
     tags?: string[];
+    /** Free-form merchant-set segment (e.g. "wholesale", "vip"), max 50 chars. */
+    role?: string;
     metadata?: Record<string, unknown>;
 }
 interface UpdateCustomerDto {
@@ -1971,6 +1977,8 @@ interface UpdateCustomerDto {
     lastName?: string;
     acceptsMarketing?: boolean;
     tags?: string[];
+    /** Free-form merchant-set segment. Pass '' to clear it. */
+    role?: string;
     metadata?: Record<string, unknown>;
 }
 interface CustomerQueryParams {
@@ -1978,6 +1986,8 @@ interface CustomerQueryParams {
     limit?: number;
     search?: string;
     hasAccount?: boolean;
+    /** Filter by merchant-set customer role/segment (exact match, case-insensitive). */
+    role?: string;
     sortBy?: 'createdAt' | 'email' | 'firstName' | 'lastName' | 'lastOrderAt';
     sortOrder?: 'asc' | 'desc';
 }
@@ -7363,6 +7373,8 @@ declare class BrainerceClient {
         lastName?: string;
         phone?: string;
         emailVerified: boolean;
+        /** Free-form segment set by the merchant (e.g. "wholesale", "vip") — use to gate custom storefront features. */
+        role?: string;
     }>;
     /**
      * Get all addresses for a customer
@@ -10584,7 +10596,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.45.0";
+declare const SDK_VERSION = "1.48.0";
 
 /**
  * Verify a webhook signature from Brainerce

package/dist/index.js

@@ -194,7 +194,7 @@ function isDevGuardsEnabled() {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.45.0";
+var SDK_VERSION = "1.48.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.brainerce.com";

package/dist/index.mjs

@@ -115,7 +115,7 @@ function isDevGuardsEnabled() {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.45.0";
+var SDK_VERSION = "1.48.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.brainerce.com";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.47.3",
+  "version": "1.48.0",
   "description": "Official SDK for building e-commerce storefronts with Brainerce Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",