@feedvalue/core 0.1.9 → 0.1.10

package/dist/index.cjs

@@ -303,6 +303,84 @@ var ApiClient = class {
     this.log("Feedback submitted", { feedbackId: data.feedback_id });
     return data;
   }
+  /**
+   * Submit reaction
+   */
+  async submitReaction(widgetId, reaction) {
+    this.validateWidgetId(widgetId);
+    const url = `${this.baseUrl}/api/v1/widgets/${widgetId}/react`;
+    if (!this.hasValidToken()) {
+      this.log("Token expired, refreshing...");
+      await this.fetchConfig(widgetId, true);
+    }
+    if (!this.submissionToken) {
+      throw new Error("No submission token available");
+    }
+    const headers = {
+      "Content-Type": "application/json",
+      "X-Submission-Token": this.submissionToken
+    };
+    if (this.fingerprint) {
+      headers["X-Client-Fingerprint"] = this.fingerprint;
+    }
+    this.log("Submitting reaction", { widgetId, value: reaction.value });
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        value: reaction.value,
+        followUp: reaction.followUp,
+        metadata: reaction.metadata
+      })
+    });
+    if (response.status === 429) {
+      const resetAt = response.headers.get("X-RateLimit-Reset");
+      const retryAfter = resetAt ? Math.ceil(parseInt(resetAt, 10) - Date.now() / 1e3) : 60;
+      throw new Error(`Rate limited. Try again in ${retryAfter} seconds.`);
+    }
+    if (response.status === 403) {
+      const errorData = await response.json().catch(() => ({ detail: "Access denied" }));
+      if (errorData.detail?.code && errorData.detail?.message) {
+        throw new Error(errorData.detail.message);
+      }
+      const errorMessage = typeof errorData.detail === "string" ? errorData.detail : "";
+      if (errorMessage.includes("token") || errorMessage.includes("expired")) {
+        this.log("Token rejected, refreshing...");
+        this.submissionToken = null;
+        await this.fetchConfig(widgetId, true);
+        if (this.submissionToken) {
+          headers["X-Submission-Token"] = this.submissionToken;
+          const retryResponse = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+              value: reaction.value,
+              followUp: reaction.followUp,
+              metadata: reaction.metadata
+            })
+          });
+          if (retryResponse.ok) {
+            return retryResponse.json();
+          }
+        }
+      }
+      throw new Error(errorMessage || "Access denied");
+    }
+    if (response.status === 400) {
+      const error = await this.parseError(response);
+      throw new Error(error);
+    }
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      throw new Error(error);
+    }
+    const data = await response.json();
+    if (data.blocked) {
+      throw new Error(data.message || "Unable to submit reaction");
+    }
+    this.log("Reaction submitted", { submissionId: data.submission_id });
+    return data;
+  }
   /**
    * Parse error from response
    */
@@ -482,20 +560,27 @@ var _FeedValue = class _FeedValue {
         this.log("Instance destroyed during config fetch, aborting init");
         return;
       }
+      const baseConfig = {
+        position: configResponse.config.position ?? "bottom-right",
+        triggerText: configResponse.config.triggerText ?? "Feedback",
+        triggerIcon: configResponse.config.triggerIcon ?? "none",
+        formTitle: configResponse.config.formTitle ?? "Share your feedback",
+        submitButtonText: configResponse.config.submitButtonText ?? "Submit",
+        thankYouMessage: configResponse.config.thankYouMessage ?? "Thank you for your feedback!",
+        showBranding: configResponse.config.showBranding ?? true,
+        customFields: configResponse.config.customFields,
+        // Reaction config (for reaction widgets) - only include if defined
+        ...configResponse.config.template && { template: configResponse.config.template },
+        ...configResponse.config.options && { options: configResponse.config.options },
+        followUpLabel: configResponse.config.followUpLabel ?? "Tell us more (optional)",
+        submitText: configResponse.config.submitText ?? "Send"
+      };
       this.widgetConfig = {
         widgetId: configResponse.widget_id,
         widgetKey: configResponse.widget_key,
         appId: "",
-        config: {
-          position: configResponse.config.position ?? "bottom-right",
-          triggerText: configResponse.config.triggerText ?? "Feedback",
-          triggerIcon: configResponse.config.triggerIcon ?? "none",
-          formTitle: configResponse.config.formTitle ?? "Share your feedback",
-          submitButtonText: configResponse.config.submitButtonText ?? "Submit",
-          thankYouMessage: configResponse.config.thankYouMessage ?? "Thank you for your feedback!",
-          showBranding: configResponse.config.showBranding ?? true,
-          customFields: configResponse.config.customFields
-        },
+        type: configResponse.type ?? "feedback",
+        config: baseConfig,
         styling: {
           primaryColor: configResponse.styling.primaryColor ?? "#3b82f6",
           backgroundColor: configResponse.styling.backgroundColor ?? "#ffffff",
@@ -713,6 +798,108 @@ var _FeedValue = class _FeedValue {
     }
     return result;
   }
+  // ===========================================================================
+  // Reactions
+  // ===========================================================================
+  /**
+   * Get reaction options from widget config.
+   * Returns null if widget is not a reaction type.
+   */
+  getReactionOptions() {
+    if (!this.widgetConfig || this.widgetConfig.type !== "reaction") {
+      return null;
+    }
+    const config = this.widgetConfig.config;
+    if (config.template) {
+      return this.getTemplateOptions(config.template);
+    }
+    return config.options ?? null;
+  }
+  /**
+   * Get predefined options for a reaction template
+   */
+  getTemplateOptions(template) {
+    const templates = {
+      thumbs: [
+        { label: "Helpful", value: "helpful", icon: "thumbs-up", showFollowUp: false },
+        { label: "Not Helpful", value: "not_helpful", icon: "thumbs-down", showFollowUp: true }
+      ],
+      helpful: [
+        { label: "Yes", value: "yes", icon: "check", showFollowUp: false },
+        { label: "No", value: "no", icon: "x", showFollowUp: true }
+      ],
+      emoji: [
+        { label: "Angry", value: "angry", icon: "\u{1F620}", showFollowUp: true },
+        { label: "Disappointed", value: "disappointed", icon: "\u{1F61E}", showFollowUp: true },
+        { label: "Neutral", value: "neutral", icon: "\u{1F610}", showFollowUp: false },
+        { label: "Satisfied", value: "satisfied", icon: "\u{1F60A}", showFollowUp: false },
+        { label: "Excited", value: "excited", icon: "\u{1F60D}", showFollowUp: false }
+      ],
+      rating: [
+        { label: "1", value: "1", icon: "\u2B50", showFollowUp: true },
+        { label: "2", value: "2", icon: "\u2B50\u2B50", showFollowUp: true },
+        { label: "3", value: "3", icon: "\u2B50\u2B50\u2B50", showFollowUp: false },
+        { label: "4", value: "4", icon: "\u2B50\u2B50\u2B50\u2B50", showFollowUp: false },
+        { label: "5", value: "5", icon: "\u2B50\u2B50\u2B50\u2B50\u2B50", showFollowUp: false }
+      ]
+    };
+    return templates[template] ?? [];
+  }
+  /**
+   * Submit a reaction.
+   * @param value - Selected reaction option value
+   * @param options - Optional follow-up text
+   */
+  async react(value, options) {
+    if (!this.state.isReady) {
+      throw new Error("Widget not ready");
+    }
+    if (!this.widgetConfig || this.widgetConfig.type !== "reaction") {
+      throw new Error("This is not a reaction widget");
+    }
+    const reactionOptions = this.getReactionOptions();
+    if (!reactionOptions) {
+      throw new Error("No reaction options configured");
+    }
+    const selectedOption = reactionOptions.find((opt) => opt.value === value);
+    if (!selectedOption) {
+      const validValues = reactionOptions.map((opt) => opt.value).join(", ");
+      throw new Error(`Invalid reaction value. Must be one of: ${validValues}`);
+    }
+    this.emitter.emit("react", { value, hasFollowUp: selectedOption.showFollowUp });
+    this.updateState({ isSubmitting: true });
+    try {
+      const reactionData = {
+        value,
+        metadata: {
+          page_url: typeof window !== "undefined" ? window.location.href : ""
+        },
+        ...options?.followUp && { followUp: options.followUp }
+      };
+      await this.apiClient.submitReaction(this.widgetId, reactionData);
+      const emitData = options?.followUp ? { value, followUp: options.followUp } : { value };
+      this.emitter.emit("reactSubmit", emitData);
+      this.log("Reaction submitted", { value });
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      this.emitter.emit("reactError", err);
+      throw err;
+    } finally {
+      this.updateState({ isSubmitting: false });
+    }
+  }
+  /**
+   * Check if widget is a reaction type
+   */
+  isReaction() {
+    return this.widgetConfig?.type === "reaction";
+  }
+  /**
+   * Get widget type ('feedback' or 'reaction')
+   */
+  getWidgetType() {
+    return this.widgetConfig?.type ?? "feedback";
+  }
   /**
    * Validate feedback data before submission
    * @throws Error if validation fails
@@ -1297,9 +1484,18 @@ __publicField(_FeedValue, "TRIGGER_ICONS", {
 });
 var FeedValue = _FeedValue;
 
+// src/types.ts
+var NEGATIVE_OPTIONS_MAP = {
+  thumbs: ["not_helpful"],
+  helpful: ["no"],
+  emoji: ["angry", "disappointed"],
+  rating: ["1", "2"]
+};
+
 exports.ApiClient = ApiClient;
 exports.DEFAULT_API_BASE_URL = DEFAULT_API_BASE_URL;
 exports.FeedValue = FeedValue;
+exports.NEGATIVE_OPTIONS_MAP = NEGATIVE_OPTIONS_MAP;
 exports.TypedEventEmitter = TypedEventEmitter;
 exports.clearFingerprint = clearFingerprint;
 exports.generateFingerprint = generateFingerprint;