brainerce 1.44.1 → 1.46.0

package/dist/index.mjs

@@ -115,7 +115,7 @@ function isDevGuardsEnabled() {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.42.0";
+var SDK_VERSION = "1.45.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.brainerce.com";
@@ -4854,6 +4854,102 @@ var BrainerceClient = class {
       `/api/v1/checkout/${encodePathSegment(checkoutId)}/shipping-rates`
     );
   }
+  /**
+   * Address autocomplete predictions for a checkout address field.
+   *
+   * `sessionToken` groups one address-entry attempt together for billing —
+   * generate a fresh id (e.g. `crypto.randomUUID()`) when the field is
+   * focused, reuse it for every keystroke, then pass the same value once more
+   * to `getAddressDetails()` when the shopper picks a suggestion. Debounce
+   * calls to this method (e.g. 300ms) rather than firing on every keystroke.
+   *
+   * @example
+   * ```typescript
+   * const sessionToken = crypto.randomUUID();
+   * const suggestions = await client.getAddressSuggestions('123 Main', sessionToken);
+   * ```
+   */
+  async getAddressSuggestions(query, sessionToken, near) {
+    const queryParams = {
+      q: query,
+      sessionToken,
+      lat: near?.lat,
+      lng: near?.lng
+    };
+    if (this.isVibeCodedMode()) {
+      const result2 = await this.vibeCodedRequest(
+        "GET",
+        "/checkout/address-suggestions",
+        void 0,
+        queryParams
+      );
+      return result2.suggestions;
+    }
+    if (this.storeId && !this.apiKey) {
+      const result2 = await this.storefrontRequest(
+        "GET",
+        "/checkout/address-suggestions",
+        void 0,
+        queryParams
+      );
+      return result2.suggestions;
+    }
+    const result = await this.adminRequest(
+      "GET",
+      "/api/v1/checkout/address-suggestions",
+      void 0,
+      queryParams
+    );
+    return result.suggestions;
+  }
+  /**
+   * Resolve a predicted place (from `getAddressSuggestions()`) to a full
+   * postal address + coordinates, and whether it falls inside any of the
+   * store's shipping zones. Pass the SAME `sessionToken` used for the
+   * preceding suggestion calls — this is the billed call that ends the
+   * autocomplete session.
+   *
+   * `inZone: false` is a soft signal, not a rejection — pair it with a
+   * banner like "outside our regular delivery zones, we'll confirm by phone"
+   * and still let the shopper continue.
+   *
+   * @example
+   * ```typescript
+   * const details = await client.getAddressDetails(suggestion.placeId, sessionToken);
+   * if (!details.inZone) {
+   *   showOutsideZoneBanner();
+   * }
+   * ```
+   */
+  async getAddressDetails(placeId, sessionToken, options) {
+    const queryParams = {
+      placeId,
+      sessionToken,
+      regionId: options?.regionId
+    };
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "GET",
+        "/checkout/address-details",
+        void 0,
+        queryParams
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "GET",
+        "/checkout/address-details",
+        void 0,
+        queryParams
+      );
+    }
+    return this.adminRequest(
+      "GET",
+      "/api/v1/checkout/address-details",
+      void 0,
+      queryParams
+    );
+  }
   /**
    * Select a shipping method for checkout
    *
@@ -5498,10 +5594,7 @@ var BrainerceClient = class {
         "order"
       );
     }
-    throw new BrainerceError(
-      "getOrderByCheckout() requires vibe-coded or storefront mode",
-      400
-    );
+    throw new BrainerceError("getOrderByCheckout() requires vibe-coded or storefront mode", 400);
   }
   /**
    * Check if localStorage is available (browser environment)
@@ -8322,6 +8415,55 @@ var BrainerceClient = class {
   async updateEmailSettings(data) {
     return this.adminRequest("PUT", "/api/v1/email/settings", data);
   }
+  /**
+   * Get Storefront Bot (AI Shopping Assistant) settings for every connection
+   * on the store — name, avatar, persona, starter questions, guardrails,
+   * capabilities. Requires Admin mode (apiKey).
+   */
+  async getBotSettings() {
+    return this.adminRequest("GET", "/api/v1/storefront-bot/settings");
+  }
+  /**
+   * Create/update one connection's Storefront Bot settings. Only fields
+   * present in `data` are changed (PATCH semantics). Requires Admin mode
+   * (apiKey).
+   */
+  async updateBotSettings(data) {
+    return this.adminRequest("PUT", "/api/v1/storefront-bot/settings", data);
+  }
+  /**
+   * Paginated Storefront Bot conversation inbox, optionally filtered to one
+   * connection. Requires Admin mode (apiKey).
+   */
+  async listBotConversations(opts) {
+    return this.adminRequest(
+      "GET",
+      "/api/v1/storefront-bot/conversations",
+      void 0,
+      opts
+    );
+  }
+  /**
+   * Full transcript for one Storefront Bot conversation, including its
+   * summary if one was generated. Requires Admin mode (apiKey).
+   */
+  async getBotConversation(conversationId) {
+    return this.adminRequest(
+      "GET",
+      `/api/v1/storefront-bot/conversations/${conversationId}`
+    );
+  }
+  /**
+   * Summarize a Storefront Bot conversation on demand and persist the
+   * summary. Short threads (10 or fewer messages) are a graceful no-op — no
+   * credits charged. Requires Admin mode (apiKey).
+   */
+  async summarizeBotConversation(conversationId) {
+    return this.adminRequest(
+      "POST",
+      `/api/v1/storefront-bot/conversations/${conversationId}/summarize`
+    );
+  }
   /**
    * Get all email templates for the store, grouped by (eventType, language).
    * Response includes the store's primary language and supported languages so

package/package.json

@@ -1,81 +1,81 @@
-{
-  "name": "brainerce",
-  "version": "1.44.1",
-  "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",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
-    },
-    "./bot": {
-      "types": "./dist/bot/index.d.ts",
-      "require": "./dist/bot/index.js",
-      "import": "./dist/bot/index.mjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts && tsup src/bot/index.ts --format cjs,esm --dts --out-dir dist/bot && tsup src/bot/bootstrap.ts --format iife --minify --out-dir dist/bot",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint \"src/**/*.ts\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build"
-  },
-  "keywords": [
-    "brainerce",
-    "e-commerce",
-    "ecommerce",
-    "sdk",
-    "vibe-coding",
-    "vibe-coded",
-    "ai-commerce",
-    "storefront",
-    "headless-commerce",
-    "multi-platform",
-    "shopify",
-    "tiktok",
-    "cursor",
-    "lovable",
-    "v0",
-    "cart",
-    "checkout",
-    "products",
-    "sync"
-  ],
-  "author": "Brainerce",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/brainerce/brainerce.git",
-    "directory": "packages/sdk"
-  },
-  "homepage": "https://brainerce.com",
-  "bugs": {
-    "url": "https://github.com/brainerce/brainerce/issues"
-  },
-  "devDependencies": {
-    "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
-    "eslint": "^9.39.2",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.0.0"
-  },
-  "peerDependencies": {
-    "typescript": ">=4.7.0"
-  },
-  "peerDependenciesMeta": {
-    "typescript": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "brainerce",
+  "version": "1.46.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",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    },
+    "./bot": {
+      "types": "./dist/bot/index.d.ts",
+      "require": "./dist/bot/index.js",
+      "import": "./dist/bot/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts && tsup src/bot/index.ts --format cjs,esm --dts --out-dir dist/bot && tsup src/bot/bootstrap.ts --format iife --minify --out-dir dist/bot",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "brainerce",
+    "e-commerce",
+    "ecommerce",
+    "sdk",
+    "vibe-coding",
+    "vibe-coded",
+    "ai-commerce",
+    "storefront",
+    "headless-commerce",
+    "multi-platform",
+    "shopify",
+    "tiktok",
+    "cursor",
+    "lovable",
+    "v0",
+    "cart",
+    "checkout",
+    "products",
+    "sync"
+  ],
+  "author": "Brainerce",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brainerce/brainerce.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://brainerce.com",
+  "bugs": {
+    "url": "https://github.com/brainerce/brainerce/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.7.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  }
+}