brainerce 1.24.0 → 1.25.1

package/dist/index.d.mts

@@ -353,12 +353,25 @@ interface ProductReviewAdmin extends ProductReview {
     orderId: string | null;
     updatedAt: string;
 }
-interface SubmitProductReviewInput {
-    authorName: string;
-    authorEmail?: string;
+/**
+ * Body for customer-authenticated submit / update.
+ * Author name + email are derived server-side from the customer profile.
+ */
+interface WriteProductReviewInput {
     rating: number;
     body?: string;
 }
+/**
+ * Returned by `client.getMyProductReview(productId)`. Tells the storefront which
+ * UI to render: sign-in / not-eligible / submit / edit.
+ */
+interface MyProductReview {
+    eligible: boolean;
+    /** Machine-readable reason when not eligible. null when eligible=true. */
+    reason: 'no_eligible_order' | 'reviews_disabled' | 'product_not_found' | null;
+    /** The customer's existing review for this product, or null. */
+    myReview: ProductReview | null;
+}
 interface ProductImage {
     url: string;
     position?: number;
@@ -6128,21 +6141,52 @@ declare class BrainerceClient {
         page?: number;
         limit?: number;
     }): Promise<PaginatedResponse<ProductReview>>;
+    /**
+     * Get the current customer's review state for a product (storefront / sales-channel modes).
+     * Requires a customer token (`setCustomerToken(...)` after login).
+     *
+     * Returns whether the customer is *eligible* to review (only purchasers are),
+     * and their existing review for this product if any.
+     *
+     * @example
+     * ```typescript
+     * const { eligible, reason, myReview } = await client.getMyProductReview('prod_123');
+     * if (!eligible) showMessage(reason); // 'no_eligible_order' | 'reviews_disabled' | …
+     * else if (myReview) renderEditForm(myReview);
+     * else renderSubmitForm();
+     * ```
+     */
+    getMyProductReview(productId: string): Promise<MyProductReview>;
     /**
      * Submit a customer review for a product (storefront / sales-channel modes).
-     * Publishes immediately. Duplicate submissions from the same email return 409.
+     * Requires customer authentication AND that the customer has purchased the
+     * product (SHIPPED for physical, PAID for downloadable).
+     *
+     * 403 `no_eligible_order` if the customer didn't purchase the product.
+     * 409 `Conflict` if they already submitted a review (use `updateMyProductReview` instead).
+     *
+     * Author name + email are derived server-side from the customer profile.
      *
      * @example
      * ```typescript
      * const review = await client.submitProductReview('prod_123', {
-     *   authorName: 'Jane Doe',
-     *   authorEmail: 'jane@example.com',
      *   rating: 5,
      *   body: 'Loved it!',
      * });
      * ```
      */
-    submitProductReview(productId: string, input: SubmitProductReviewInput): Promise<ProductReview>;
+    submitProductReview(productId: string, input: WriteProductReviewInput): Promise<ProductReview>;
+    /**
+     * Edit your own review on a product (storefront / sales-channel modes).
+     * Only updates rating + body; the author name/email and verifiedPurchase flag
+     * are preserved from the original submit.
+     */
+    updateMyProductReview(productId: string, input: WriteProductReviewInput): Promise<ProductReview>;
+    /**
+     * Delete your own review on a product (storefront / sales-channel modes).
+     * After deletion the customer is free to submit a new review (subject to eligibility).
+     */
+    deleteMyProductReview(productId: string): Promise<void>;
     /**
      * Admin: list all reviews for a product (incl. hidden). Requires API key with `reviews:read`.
      */

package/dist/index.d.ts

@@ -353,12 +353,25 @@ interface ProductReviewAdmin extends ProductReview {
     orderId: string | null;
     updatedAt: string;
 }
-interface SubmitProductReviewInput {
-    authorName: string;
-    authorEmail?: string;
+/**
+ * Body for customer-authenticated submit / update.
+ * Author name + email are derived server-side from the customer profile.
+ */
+interface WriteProductReviewInput {
     rating: number;
     body?: string;
 }
+/**
+ * Returned by `client.getMyProductReview(productId)`. Tells the storefront which
+ * UI to render: sign-in / not-eligible / submit / edit.
+ */
+interface MyProductReview {
+    eligible: boolean;
+    /** Machine-readable reason when not eligible. null when eligible=true. */
+    reason: 'no_eligible_order' | 'reviews_disabled' | 'product_not_found' | null;
+    /** The customer's existing review for this product, or null. */
+    myReview: ProductReview | null;
+}
 interface ProductImage {
     url: string;
     position?: number;
@@ -6128,21 +6141,52 @@ declare class BrainerceClient {
         page?: number;
         limit?: number;
     }): Promise<PaginatedResponse<ProductReview>>;
+    /**
+     * Get the current customer's review state for a product (storefront / sales-channel modes).
+     * Requires a customer token (`setCustomerToken(...)` after login).
+     *
+     * Returns whether the customer is *eligible* to review (only purchasers are),
+     * and their existing review for this product if any.
+     *
+     * @example
+     * ```typescript
+     * const { eligible, reason, myReview } = await client.getMyProductReview('prod_123');
+     * if (!eligible) showMessage(reason); // 'no_eligible_order' | 'reviews_disabled' | …
+     * else if (myReview) renderEditForm(myReview);
+     * else renderSubmitForm();
+     * ```
+     */
+    getMyProductReview(productId: string): Promise<MyProductReview>;
     /**
      * Submit a customer review for a product (storefront / sales-channel modes).
-     * Publishes immediately. Duplicate submissions from the same email return 409.
+     * Requires customer authentication AND that the customer has purchased the
+     * product (SHIPPED for physical, PAID for downloadable).
+     *
+     * 403 `no_eligible_order` if the customer didn't purchase the product.
+     * 409 `Conflict` if they already submitted a review (use `updateMyProductReview` instead).
+     *
+     * Author name + email are derived server-side from the customer profile.
      *
      * @example
      * ```typescript
      * const review = await client.submitProductReview('prod_123', {
-     *   authorName: 'Jane Doe',
-     *   authorEmail: 'jane@example.com',
      *   rating: 5,
      *   body: 'Loved it!',
      * });
      * ```
      */
-    submitProductReview(productId: string, input: SubmitProductReviewInput): Promise<ProductReview>;
+    submitProductReview(productId: string, input: WriteProductReviewInput): Promise<ProductReview>;
+    /**
+     * Edit your own review on a product (storefront / sales-channel modes).
+     * Only updates rating + body; the author name/email and verifiedPurchase flag
+     * are preserved from the original submit.
+     */
+    updateMyProductReview(productId: string, input: WriteProductReviewInput): Promise<ProductReview>;
+    /**
+     * Delete your own review on a product (storefront / sales-channel modes).
+     * After deletion the customer is free to submit a new review (subject to eligibility).
+     */
+    deleteMyProductReview(productId: string): Promise<void>;
     /**
      * Admin: list all reviews for a product (incl. hidden). Requires API key with `reviews:read`.
      */

package/dist/index.js

@@ -2825,15 +2825,43 @@ var BrainerceClient = class {
     }
     throw new BrainerceError("listProductReviews() requires vibe-coded or storefront mode", 400);
   }
+  /**
+   * Get the current customer's review state for a product (storefront / sales-channel modes).
+   * Requires a customer token (`setCustomerToken(...)` after login).
+   *
+   * Returns whether the customer is *eligible* to review (only purchasers are),
+   * and their existing review for this product if any.
+   *
+   * @example
+   * ```typescript
+   * const { eligible, reason, myReview } = await client.getMyProductReview('prod_123');
+   * if (!eligible) showMessage(reason); // 'no_eligible_order' | 'reviews_disabled' | …
+   * else if (myReview) renderEditForm(myReview);
+   * else renderSubmitForm();
+   * ```
+   */
+  async getMyProductReview(productId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", `/products/${productId}/reviews/me`);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", `/products/${productId}/reviews/me`);
+    }
+    throw new BrainerceError("getMyProductReview() requires vibe-coded or storefront mode", 400);
+  }
   /**
    * Submit a customer review for a product (storefront / sales-channel modes).
-   * Publishes immediately. Duplicate submissions from the same email return 409.
+   * Requires customer authentication AND that the customer has purchased the
+   * product (SHIPPED for physical, PAID for downloadable).
+   *
+   * 403 `no_eligible_order` if the customer didn't purchase the product.
+   * 409 `Conflict` if they already submitted a review (use `updateMyProductReview` instead).
+   *
+   * Author name + email are derived server-side from the customer profile.
    *
    * @example
    * ```typescript
    * const review = await client.submitProductReview('prod_123', {
-   *   authorName: 'Jane Doe',
-   *   authorEmail: 'jane@example.com',
    *   rating: 5,
    *   body: 'Loved it!',
    * });
@@ -2848,6 +2876,43 @@ var BrainerceClient = class {
     }
     throw new BrainerceError("submitProductReview() requires vibe-coded or storefront mode", 400);
   }
+  /**
+   * Edit your own review on a product (storefront / sales-channel modes).
+   * Only updates rating + body; the author name/email and verifiedPurchase flag
+   * are preserved from the original submit.
+   */
+  async updateMyProductReview(productId, input) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "PATCH",
+        `/products/${productId}/reviews/me`,
+        input
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "PATCH",
+        `/products/${productId}/reviews/me`,
+        input
+      );
+    }
+    throw new BrainerceError("updateMyProductReview() requires vibe-coded or storefront mode", 400);
+  }
+  /**
+   * Delete your own review on a product (storefront / sales-channel modes).
+   * After deletion the customer is free to submit a new review (subject to eligibility).
+   */
+  async deleteMyProductReview(productId) {
+    if (this.isVibeCodedMode()) {
+      await this.vibeCodedRequest("DELETE", `/products/${productId}/reviews/me`);
+      return;
+    }
+    if (this.storeId && !this.apiKey) {
+      await this.storefrontRequest("DELETE", `/products/${productId}/reviews/me`);
+      return;
+    }
+    throw new BrainerceError("deleteMyProductReview() requires vibe-coded or storefront mode", 400);
+  }
   /**
    * Admin: list all reviews for a product (incl. hidden). Requires API key with `reviews:read`.
    */

package/dist/index.mjs

@@ -2762,15 +2762,43 @@ var BrainerceClient = class {
     }
     throw new BrainerceError("listProductReviews() requires vibe-coded or storefront mode", 400);
   }
+  /**
+   * Get the current customer's review state for a product (storefront / sales-channel modes).
+   * Requires a customer token (`setCustomerToken(...)` after login).
+   *
+   * Returns whether the customer is *eligible* to review (only purchasers are),
+   * and their existing review for this product if any.
+   *
+   * @example
+   * ```typescript
+   * const { eligible, reason, myReview } = await client.getMyProductReview('prod_123');
+   * if (!eligible) showMessage(reason); // 'no_eligible_order' | 'reviews_disabled' | …
+   * else if (myReview) renderEditForm(myReview);
+   * else renderSubmitForm();
+   * ```
+   */
+  async getMyProductReview(productId) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", `/products/${productId}/reviews/me`);
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", `/products/${productId}/reviews/me`);
+    }
+    throw new BrainerceError("getMyProductReview() requires vibe-coded or storefront mode", 400);
+  }
   /**
    * Submit a customer review for a product (storefront / sales-channel modes).
-   * Publishes immediately. Duplicate submissions from the same email return 409.
+   * Requires customer authentication AND that the customer has purchased the
+   * product (SHIPPED for physical, PAID for downloadable).
+   *
+   * 403 `no_eligible_order` if the customer didn't purchase the product.
+   * 409 `Conflict` if they already submitted a review (use `updateMyProductReview` instead).
+   *
+   * Author name + email are derived server-side from the customer profile.
    *
    * @example
    * ```typescript
    * const review = await client.submitProductReview('prod_123', {
-   *   authorName: 'Jane Doe',
-   *   authorEmail: 'jane@example.com',
    *   rating: 5,
    *   body: 'Loved it!',
    * });
@@ -2785,6 +2813,43 @@ var BrainerceClient = class {
     }
     throw new BrainerceError("submitProductReview() requires vibe-coded or storefront mode", 400);
   }
+  /**
+   * Edit your own review on a product (storefront / sales-channel modes).
+   * Only updates rating + body; the author name/email and verifiedPurchase flag
+   * are preserved from the original submit.
+   */
+  async updateMyProductReview(productId, input) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "PATCH",
+        `/products/${productId}/reviews/me`,
+        input
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "PATCH",
+        `/products/${productId}/reviews/me`,
+        input
+      );
+    }
+    throw new BrainerceError("updateMyProductReview() requires vibe-coded or storefront mode", 400);
+  }
+  /**
+   * Delete your own review on a product (storefront / sales-channel modes).
+   * After deletion the customer is free to submit a new review (subject to eligibility).
+   */
+  async deleteMyProductReview(productId) {
+    if (this.isVibeCodedMode()) {
+      await this.vibeCodedRequest("DELETE", `/products/${productId}/reviews/me`);
+      return;
+    }
+    if (this.storeId && !this.apiKey) {
+      await this.storefrontRequest("DELETE", `/products/${productId}/reviews/me`);
+      return;
+    }
+    throw new BrainerceError("deleteMyProductReview() requires vibe-coded or storefront mode", 400);
+  }
   /**
    * Admin: list all reviews for a product (incl. hidden). Requires API key with `reviews:read`.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.24.0",
+  "version": "1.25.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",