react-visual-feedback 1.4.9 → 2.2.0

package/dist/integrations/config.js

@@ -0,0 +1,664 @@
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+function _arrayWithHoles(r) {
+  if (Array.isArray(r)) return r;
+}
+function _arrayWithoutHoles(r) {
+  if (Array.isArray(r)) return _arrayLikeToArray(r);
+}
+function _defineProperty(e, r, t) {
+  return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+    value: t,
+    enumerable: true,
+    configurable: true,
+    writable: true
+  }) : e[r] = t, e;
+}
+function _iterableToArray(r) {
+  if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
+}
+function _iterableToArrayLimit(r, l) {
+  var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
+  if (null != t) {
+    var e,
+      n,
+      i,
+      u,
+      a = [],
+      f = true,
+      o = false;
+    try {
+      if (i = (t = t.call(r)).next, 0 === l) ; else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
+    } catch (r) {
+      o = true, n = r;
+    } finally {
+      try {
+        if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
+      } finally {
+        if (o) throw n;
+      }
+    }
+    return a;
+  }
+}
+function _nonIterableRest() {
+  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _nonIterableSpread() {
+  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function ownKeys(e, r) {
+  var t = Object.keys(e);
+  if (Object.getOwnPropertySymbols) {
+    var o = Object.getOwnPropertySymbols(e);
+    r && (o = o.filter(function (r) {
+      return Object.getOwnPropertyDescriptor(e, r).enumerable;
+    })), t.push.apply(t, o);
+  }
+  return t;
+}
+function _objectSpread2(e) {
+  for (var r = 1; r < arguments.length; r++) {
+    var t = null != arguments[r] ? arguments[r] : {};
+    r % 2 ? ownKeys(Object(t), true).forEach(function (r) {
+      _defineProperty(e, r, t[r]);
+    }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) {
+      Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+    });
+  }
+  return e;
+}
+function _slicedToArray(r, e) {
+  return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
+}
+function _toConsumableArray(r) {
+  return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
+}
+function _toPrimitive(t, r) {
+  if ("object" != typeof t || !t) return t;
+  var e = t[Symbol.toPrimitive];
+  if (void 0 !== e) {
+    var i = e.call(t, r);
+    if ("object" != typeof i) return i;
+    throw new TypeError("@@toPrimitive must return a primitive value.");
+  }
+  return ("string" === r ? String : Number)(t);
+}
+function _toPropertyKey(t) {
+  var i = _toPrimitive(t, "string");
+  return "symbol" == typeof i ? i : i + "";
+}
+function _typeof(o) {
+  "@babel/helpers - typeof";
+
+  return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) {
+    return typeof o;
+  } : function (o) {
+    return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+  }, _typeof(o);
+}
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+/**
+ * Integration Configuration & Default Mappings
+ * Users can customize these by passing their own config
+ */
+
+// ============================================
+// ATLASSIAN DOCUMENT FORMAT (ADF) HELPER
+// ============================================
+
+/**
+ * Convert plain text to Atlassian Document Format
+ * Jira Cloud requires descriptions in ADF format
+ */
+function textToADF(text) {
+  var lines = text.split('\n');
+  var content = [];
+  var currentParagraph = [];
+  var flushParagraph = function flushParagraph() {
+    if (currentParagraph.length > 0) {
+      content.push({
+        type: 'paragraph',
+        content: currentParagraph
+      });
+      currentParagraph = [];
+    }
+  };
+  lines.forEach(function (line, index) {
+    // Check if it's a section header (ALL CAPS)
+    if (line.match(/^[A-Z][A-Z\s]+$/) && line.trim().length > 0) {
+      flushParagraph();
+      content.push({
+        type: 'heading',
+        attrs: {
+          level: 3
+        },
+        content: [{
+          type: 'text',
+          text: line
+        }]
+      });
+    } else if (line === '---') {
+      // Horizontal rule
+      flushParagraph();
+      content.push({
+        type: 'rule'
+      });
+    } else if (line.trim() === '') {
+      // Empty line - flush paragraph
+      flushParagraph();
+    } else {
+      // Regular line
+      if (currentParagraph.length > 0) {
+        currentParagraph.push({
+          type: 'hardBreak'
+        });
+      }
+      currentParagraph.push({
+        type: 'text',
+        text: line
+      });
+    }
+  });
+  flushParagraph();
+  return {
+    type: 'doc',
+    version: 1,
+    content: content.length > 0 ? content : [{
+      type: 'paragraph',
+      content: [{
+        type: 'text',
+        text: ' '
+      }]
+    }]
+  };
+}
+
+// ============================================
+// GOOGLE SHEETS COLUMN MAPPING
+// ============================================
+
+var DEFAULT_SHEET_COLUMNS = {
+  timestamp: {
+    key: 'timestamp',
+    header: 'Timestamp',
+    field: 'timestamp',
+    transform: function transform(value) {
+      return value || new Date().toISOString();
+    }
+  },
+  id: {
+    key: 'id',
+    header: 'Feedback ID',
+    field: 'id'
+  },
+  feedback: {
+    key: 'feedback',
+    header: 'Feedback',
+    field: 'feedback'
+  },
+  type: {
+    key: 'type',
+    header: 'Type',
+    field: 'type',
+    transform: function transform(value) {
+      return value || 'bug';
+    }
+  },
+  status: {
+    key: 'status',
+    header: 'Status',
+    field: 'status',
+    transform: function transform(value) {
+      return value || 'new';
+    }
+  },
+  userName: {
+    key: 'userName',
+    header: 'User Name',
+    field: 'userName',
+    transform: function transform(value) {
+      return value || 'Anonymous';
+    }
+  },
+  userEmail: {
+    key: 'userEmail',
+    header: 'User Email',
+    field: 'userEmail',
+    transform: function transform(value) {
+      return value || '';
+    }
+  },
+  url: {
+    key: 'url',
+    header: 'Page URL',
+    field: 'url'
+  },
+  viewport: {
+    key: 'viewport',
+    header: 'Viewport',
+    field: 'viewport',
+    transform: function transform(value) {
+      return value ? "".concat(value.width, "x").concat(value.height) : '';
+    }
+  },
+  userAgent: {
+    key: 'userAgent',
+    header: 'Browser',
+    field: 'userAgent',
+    transform: function transform(value) {
+      if (!value) return '';
+      // Simplify user agent
+      if (value.includes('Chrome')) return 'Chrome';
+      if (value.includes('Firefox')) return 'Firefox';
+      if (value.includes('Safari')) return 'Safari';
+      if (value.includes('Edge')) return 'Edge';
+      return value.substring(0, 50);
+    }
+  },
+  screenshot: {
+    key: 'screenshot',
+    header: 'Screenshot',
+    field: 'screenshot',
+    transform: function transform(value) {
+      return value ? 'Yes' : 'No';
+    } // Don't store base64 in sheets
+  },
+  video: {
+    key: 'video',
+    header: 'Video',
+    field: 'video',
+    transform: function transform(value) {
+      return value ? 'Yes' : 'No';
+    }
+  },
+  elementSelector: {
+    key: 'elementSelector',
+    header: 'Element',
+    field: 'elementInfo',
+    transform: function transform(value) {
+      return (value === null || value === void 0 ? void 0 : value.selector) || '';
+    }
+  },
+  componentName: {
+    key: 'componentName',
+    header: 'Component',
+    field: 'elementInfo',
+    transform: function transform(value) {
+      var _value$componentStack;
+      return (value === null || value === void 0 || (_value$componentStack = value.componentStack) === null || _value$componentStack === void 0 ? void 0 : _value$componentStack[0]) || '';
+    }
+  },
+  sourceFile: {
+    key: 'sourceFile',
+    header: 'Source File',
+    field: 'elementInfo',
+    transform: function transform(value) {
+      return (value === null || value === void 0 ? void 0 : value.sourceFile) || '';
+    }
+  },
+  jiraKey: {
+    key: 'jiraKey',
+    header: 'Jira Issue',
+    field: 'jiraKey',
+    transform: function transform(value) {
+      return value || '';
+    }
+  }
+};
+
+// Default columns to include (order matters)
+var DEFAULT_SHEET_COLUMN_ORDER = ['timestamp', 'id', 'feedback', 'type', 'status', 'userName', 'userEmail', 'url', 'viewport', 'screenshot', 'video', 'jiraKey'];
+
+// ============================================
+// JIRA FIELD MAPPING
+// ============================================
+
+var DEFAULT_JIRA_FIELDS = {
+  summary: {
+    key: 'summary',
+    source: 'feedback',
+    maxLength: 255,
+    prefix: '[Feedback] ',
+    transform: function transform(data) {
+      var prefix = '[Feedback] ';
+      var text = data.feedback || 'User Feedback';
+      var maxLen = 255 - prefix.length;
+      return prefix + (text.length > maxLen ? text.substring(0, maxLen - 3) + '...' : text);
+    }
+  },
+  description: {
+    key: 'description',
+    // Build description directly - no wiki markup, clean plain text for ADF
+    transform: function transform(data) {
+      var lines = [];
+
+      // Feedback Details
+      lines.push('FEEDBACK DETAILS');
+      lines.push("Feedback: ".concat(data.feedback || 'No feedback provided'));
+      lines.push("Type: ".concat(data.type || 'bug'));
+      lines.push("Status: ".concat(data.status || 'new'));
+      lines.push('');
+
+      // User Information
+      lines.push('USER INFORMATION');
+      lines.push("Name: ".concat(data.userName || 'Anonymous'));
+      lines.push("Email: ".concat(data.userEmail || 'Not provided'));
+      lines.push('');
+
+      // Technical Details
+      lines.push('TECHNICAL DETAILS');
+      lines.push("Page URL: ".concat(data.url || 'N/A'));
+      if (data.viewport) {
+        lines.push("Viewport: ".concat(data.viewport.width, "x").concat(data.viewport.height));
+      }
+      if (data.userAgent) {
+        // Simplify user agent
+        var browser = data.userAgent;
+        if (browser.includes('Chrome')) browser = 'Chrome';else if (browser.includes('Firefox')) browser = 'Firefox';else if (browser.includes('Safari')) browser = 'Safari';else if (browser.includes('Edge')) browser = 'Edge';
+        lines.push("Browser: ".concat(browser));
+      }
+
+      // Element info
+      if (data.elementInfo) {
+        var _data$elementInfo$com;
+        if (data.elementInfo.selector) {
+          lines.push("Element: ".concat(data.elementInfo.selector));
+        }
+        if ((_data$elementInfo$com = data.elementInfo.componentStack) !== null && _data$elementInfo$com !== void 0 && _data$elementInfo$com.length) {
+          lines.push("Component: ".concat(data.elementInfo.componentStack.join(' > ')));
+        }
+        if (data.elementInfo.sourceFile) {
+          lines.push("Source: ".concat(data.elementInfo.sourceFile, ":").concat(data.elementInfo.lineNumber || ''));
+        }
+      }
+      lines.push('');
+
+      // Attachments
+      var attachments = [];
+      if (data.screenshot) attachments.push('Screenshot');
+      if (data.video) attachments.push('Screen Recording');
+      if (attachments.length > 0) {
+        lines.push('ATTACHMENTS');
+        lines.push(attachments.join(', ') + ' attached');
+        lines.push('');
+      }
+      lines.push('---');
+      lines.push('Submitted via React Visual Feedback');
+      return lines.join('\n');
+    }
+  },
+  issuetype: {
+    key: 'issuetype',
+    // Default to 'Task' which exists in most Jira projects
+    // Can be overridden via JIRA_ISSUE_TYPE env var or config
+    value: 'Task',
+    // Map feedback types to Jira issue types (all default to Task for compatibility)
+    typeMapping: {
+      bug: 'Task',
+      feature: 'Task',
+      improvement: 'Task',
+      question: 'Task',
+      other: 'Task'
+    },
+    transform: function transform(data, config) {
+      var _process$env;
+      // Priority: env var > config value > type mapping > default
+      var envIssueType = typeof process !== 'undefined' ? (_process$env = process.env) === null || _process$env === void 0 ? void 0 : _process$env.JIRA_ISSUE_TYPE : null;
+      if (envIssueType) return envIssueType;
+      if (config !== null && config !== void 0 && config.value && config.value !== 'Task') return config.value;
+      var mapping = (config === null || config === void 0 ? void 0 : config.typeMapping) || DEFAULT_JIRA_FIELDS.issuetype.typeMapping;
+      return mapping[data.type] || (config === null || config === void 0 ? void 0 : config.value) || 'Task';
+    }
+  },
+  labels: {
+    key: 'labels',
+    value: ['user-feedback'],
+    transform: function transform(data, config) {
+      var labels = _toConsumableArray((config === null || config === void 0 ? void 0 : config.value) || ['user-feedback']);
+      if (data.type) labels.push("type-".concat(data.type));
+      return labels;
+    }
+  },
+  priority: {
+    key: 'priority',
+    // Map to Jira priority IDs (user can customize)
+    priorityMapping: {
+      bug: 'High',
+      feature: 'Medium',
+      improvement: 'Medium',
+      question: 'Low',
+      other: 'Low'
+    },
+    transform: function transform(data, config) {
+      var mapping = (config === null || config === void 0 ? void 0 : config.priorityMapping) || DEFAULT_JIRA_FIELDS.priority.priorityMapping;
+      return mapping[data.type] || 'Medium';
+    }
+  }
+};
+
+// ============================================
+// JIRA STATUS MAPPING (Bidirectional sync)
+// ============================================
+
+var DEFAULT_JIRA_STATUS_MAPPING = {
+  // Our status -> Jira status
+  toJira: {
+    "new": 'To Do',
+    open: 'To Do',
+    inProgress: 'In Progress',
+    underReview: 'In Review',
+    onHold: 'On Hold',
+    resolved: 'Done',
+    closed: 'Done',
+    wontFix: 'Won\'t Do'
+  },
+  // Jira status -> Our status
+  fromJira: {
+    'To Do': 'open',
+    'Open': 'open',
+    'In Progress': 'inProgress',
+    'In Review': 'underReview',
+    'On Hold': 'onHold',
+    'Done': 'resolved',
+    'Closed': 'closed',
+    'Won\'t Do': 'wontFix',
+    'Resolved': 'resolved'
+  }
+};
+
+// ============================================
+// INTEGRATION TYPES
+// ============================================
+
+var INTEGRATION_TYPES = {
+  JIRA: {
+    SERVER: 'server',
+    // Our server handler
+    AUTOMATION: 'jira-automation',
+    // Jira's built-in webhooks
+    ZAPIER: 'zapier' // Zapier webhook
+  },
+  SHEETS: {
+    SERVER: 'server',
+    // Our server handler (Service Account)
+    OAUTH: 'oauth',
+    // OAuth with refresh
+    APPS_SCRIPT: 'google-apps-script',
+    // Google Apps Script
+    ZAPIER: 'zapier' // Zapier webhook
+  }
+};
+
+// ============================================
+// HELPER FUNCTIONS
+// ============================================
+
+/**
+ * Merge user config with defaults
+ */
+function mergeSheetColumns() {
+  var userColumns = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var columnOrder = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
+  var merged = _objectSpread2({}, DEFAULT_SHEET_COLUMNS);
+
+  // Apply user overrides
+  Object.entries(userColumns).forEach(function (_ref) {
+    var _ref2 = _slicedToArray(_ref, 2),
+      key = _ref2[0],
+      value = _ref2[1];
+    if (value === null || value === false) {
+      // Remove column
+      delete merged[key];
+    } else if (_typeof(value) === 'object') {
+      // Merge with default
+      merged[key] = _objectSpread2(_objectSpread2({}, merged[key]), value);
+    }
+  });
+
+  // Determine column order
+  var order = columnOrder || Object.keys(merged).filter(function (k) {
+    return DEFAULT_SHEET_COLUMN_ORDER.includes(k) || userColumns[k];
+  });
+  return {
+    columns: merged,
+    order: order
+  };
+}
+
+/**
+ * Merge user Jira config with defaults
+ */
+function mergeJiraFields() {
+  var userFields = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var merged = _objectSpread2({}, DEFAULT_JIRA_FIELDS);
+  Object.entries(userFields).forEach(function (_ref3) {
+    var _ref4 = _slicedToArray(_ref3, 2),
+      key = _ref4[0],
+      value = _ref4[1];
+    if (value === null || value === false) {
+      delete merged[key];
+    } else if (_typeof(value) === 'object') {
+      merged[key] = _objectSpread2(_objectSpread2({}, merged[key]), value);
+    }
+  });
+  return merged;
+}
+
+/**
+ * Transform feedback data to sheet row
+ */
+function feedbackToSheetRow(feedbackData) {
+  var config = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var _mergeSheetColumns = mergeSheetColumns(config.columns, config.columnOrder),
+    columns = _mergeSheetColumns.columns,
+    order = _mergeSheetColumns.order;
+  var row = order.map(function (key) {
+    var col = columns[key];
+    if (!col) return '';
+    var rawValue = feedbackData[col.field];
+    if (col.transform) {
+      return col.transform(rawValue) || '';
+    }
+    return rawValue || '';
+  });
+  return row;
+}
+
+/**
+ * Get sheet headers
+ */
+function getSheetHeaders() {
+  var config = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var _mergeSheetColumns2 = mergeSheetColumns(config.columns, config.columnOrder),
+    columns = _mergeSheetColumns2.columns,
+    order = _mergeSheetColumns2.order;
+  return order.map(function (key) {
+    var _columns$key;
+    return ((_columns$key = columns[key]) === null || _columns$key === void 0 ? void 0 : _columns$key.header) || key;
+  });
+}
+
+/**
+ * Transform feedback data to Jira issue
+ */
+function feedbackToJiraIssue(feedbackData) {
+  var config = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var fields = mergeJiraFields(config.fields);
+
+  // Get plain text description and convert to ADF
+  var plainDescription = fields.description.transform(feedbackData, fields.description);
+  var adfDescription = textToADF(plainDescription);
+  var issue = {
+    fields: {
+      project: {
+        key: config.projectKey
+      },
+      summary: fields.summary.transform(feedbackData, fields.summary),
+      description: adfDescription,
+      issuetype: {
+        name: fields.issuetype.transform(feedbackData, fields.issuetype)
+      }
+    }
+  };
+
+  // Add labels if configured
+  if (fields.labels) {
+    issue.fields.labels = fields.labels.transform(feedbackData, fields.labels);
+  }
+
+  // Add priority if configured and user wants it
+  if (config.includePriority && fields.priority) {
+    issue.fields.priority = {
+      name: fields.priority.transform(feedbackData, fields.priority)
+    };
+  }
+
+  // Add custom fields
+  if (config.customFields) {
+    Object.entries(config.customFields).forEach(function (_ref5) {
+      var _ref6 = _slicedToArray(_ref5, 2),
+        fieldId = _ref6[0],
+        fieldConfig = _ref6[1];
+      if (typeof fieldConfig === 'string') {
+        issue.fields[fieldId] = feedbackData[fieldConfig];
+      } else if (fieldConfig.transform) {
+        issue.fields[fieldId] = fieldConfig.transform(feedbackData);
+      } else if (fieldConfig.value) {
+        issue.fields[fieldId] = fieldConfig.value;
+      }
+    });
+  }
+  return issue;
+}
+
+/**
+ * Map Jira status to our status
+ */
+function mapJiraStatusToLocal(jiraStatus) {
+  var customMapping = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var mapping = _objectSpread2(_objectSpread2({}, DEFAULT_JIRA_STATUS_MAPPING.fromJira), customMapping);
+  return mapping[jiraStatus] || 'open';
+}
+
+/**
+ * Map our status to Jira status
+ */
+function mapLocalStatusToJira(localStatus) {
+  var customMapping = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var mapping = _objectSpread2(_objectSpread2({}, DEFAULT_JIRA_STATUS_MAPPING.toJira), customMapping);
+  return mapping[localStatus] || 'To Do';
+}
+
+export { DEFAULT_JIRA_FIELDS, DEFAULT_JIRA_STATUS_MAPPING, DEFAULT_SHEET_COLUMNS, DEFAULT_SHEET_COLUMN_ORDER, INTEGRATION_TYPES, feedbackToJiraIssue, feedbackToSheetRow, getSheetHeaders, mapJiraStatusToLocal, mapLocalStatusToJira, mergeJiraFields, mergeSheetColumns, textToADF };
+//# sourceMappingURL=config.js.map