@sensefolks/fastpoll 0.1.0

package/dist/esm/index-CfdIRf0W.js

@@ -0,0 +1,193 @@
+/**
+ * Utility functions for sf-fastpoll
+ */
+/**
+ * Maximum allowed length for text inputs
+ */
+const MAX_TEXT_LENGTH = 500;
+const MAX_EMAIL_LENGTH = 254;
+/**
+ * Sanitize user input to prevent XSS and limit length
+ * @param input The raw user input
+ * @param maxLength Maximum allowed length (default: 500)
+ * @returns Sanitized string
+ */
+function sanitizeInput(input, maxLength = MAX_TEXT_LENGTH) {
+    if (typeof input !== 'string') {
+        return '';
+    }
+    // Trim whitespace
+    let sanitized = input.replace(/^\s+|\s+$/g, '');
+    // Remove null bytes
+    sanitized = sanitized.replace(/\0/g, '');
+    // Encode HTML entities to prevent XSS
+    sanitized = sanitized.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#x27;');
+    // Truncate to max length
+    if (sanitized.length > maxLength) {
+        sanitized = sanitized.substring(0, maxLength);
+    }
+    return sanitized;
+}
+/**
+ * Sanitize email input with email-specific rules
+ * @param email The raw email input
+ * @returns Sanitized email string
+ */
+function sanitizeEmail(email) {
+    if (typeof email !== 'string') {
+        return '';
+    }
+    // Trim and lowercase
+    let sanitized = email.replace(/^\s+|\s+$/g, '').toLowerCase();
+    // Remove null bytes and control characters
+    sanitized = sanitized.replace(/[\0\x00-\x1F\x7F]/g, '');
+    // Truncate to max email length (RFC 5321)
+    if (sanitized.length > MAX_EMAIL_LENGTH) {
+        sanitized = sanitized.substring(0, MAX_EMAIL_LENGTH);
+    }
+    return sanitized;
+}
+/**
+ * Sanitize a value based on field type
+ * @param value The raw value
+ * @param inputType The type of input field
+ * @returns Sanitized value
+ */
+function sanitizeByType(value, inputType) {
+    switch (inputType) {
+        case 'email':
+            return sanitizeEmail(value);
+        case 'number':
+            // Only allow digits, decimal point, and minus sign
+            const numStr = String(value).replace(/[^0-9.\-]/g, '');
+            return numStr.substring(0, 20); // Reasonable max for numbers
+        case 'dropdown':
+        case 'radio':
+            // For select/radio, sanitize but be more permissive (values come from config)
+            return sanitizeInput(value, 100);
+        case 'checkbox':
+            // Checkbox values are comma-separated, sanitize each
+            return value
+                .split(',')
+                .map(v => sanitizeInput(v.replace(/^\s+|\s+$/g, ''), 100))
+                .join(', ');
+        default:
+            return sanitizeInput(value);
+    }
+}
+/**
+ * Check if a survey key is valid UUID
+ * @param key The survey key to validate
+ * @returns True if the key is a valid UUID, false otherwise
+ */
+function isValidKey(key) {
+    if (typeof key !== 'string' || key.trim().length === 0) {
+        return false;
+    }
+    // UUID v4 regex pattern
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(key.trim());
+}
+/**
+ * Format error messages for display
+ * @param error The error object or message
+ * @returns A formatted error message string
+ */
+function formatErrorMessage(error) {
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return 'An unknown error occurred';
+}
+/**
+ * Browser-compatible helper to check if array contains a value
+ * @param array The array to search
+ * @param value The value to find
+ * @returns true if value is found in array
+ */
+function arrayContains(array, value) {
+    for (let i = 0; i < array.length; i++) {
+        if (array[i] === value) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Browser-compatible helper to trim and split comma-separated values
+ * @param value The comma-separated string
+ * @returns Array of trimmed values
+ */
+function parseCommaSeparatedValues(value) {
+    if (!value) {
+        return [];
+    }
+    const parts = value.split(',');
+    const result = [];
+    for (let i = 0; i < parts.length; i++) {
+        const trimmed = parts[i].replace(/^\s+|\s+$/g, ''); // Manual trim for IE compatibility
+        if (trimmed) {
+            result.push(trimmed);
+        }
+    }
+    return result;
+}
+/**
+ * Get field configuration for rendering
+ * @param detail The respondent detail configuration
+ * @param value The current value of the field
+ * @returns Field configuration object
+ */
+function getFieldConfig(detail, value) {
+    const inputType = detail.inputType || 'text';
+    const placeholder = detail.placeholder || 'Enter your ' + detail.label.toLowerCase();
+    const required = detail.required !== false;
+    return {
+        inputType: inputType,
+        placeholder: placeholder,
+        required: required,
+        options: detail.options || [],
+        defaultValue: detail.defaultValue,
+        hasOptions: detail.options && detail.options.length > 0,
+        selectedValues: parseCommaSeparatedValues(value),
+        fieldValue: detail.value,
+        currentValue: value || '',
+    };
+}
+/**
+ * Browser-compatible helper to add value to comma-separated list
+ * @param currentValue The current comma-separated string
+ * @param valueToAdd The value to add
+ * @returns Updated comma-separated string
+ */
+function addToCommaSeparatedList(currentValue, valueToAdd) {
+    const values = parseCommaSeparatedValues(currentValue);
+    if (!arrayContains(values, valueToAdd)) {
+        values.push(valueToAdd);
+    }
+    return values.join(', ');
+}
+/**
+ * Browser-compatible helper to remove value from comma-separated list
+ * @param currentValue The current comma-separated string
+ * @param valueToRemove The value to remove
+ * @returns Updated comma-separated string
+ */
+function removeFromCommaSeparatedList(currentValue, valueToRemove) {
+    const values = parseCommaSeparatedValues(currentValue);
+    const result = [];
+    for (let i = 0; i < values.length; i++) {
+        if (values[i] !== valueToRemove) {
+            result.push(values[i]);
+        }
+    }
+    return result.join(', ');
+}
+
+export { addToCommaSeparatedList as a, sanitizeByType as b, formatErrorMessage as f, getFieldConfig as g, isValidKey as i, removeFromCommaSeparatedList as r, sanitizeInput as s };
+//# sourceMappingURL=index-CfdIRf0W.js.map
+
+//# sourceMappingURL=index-CfdIRf0W.js.map

package/dist/esm/index-CfdIRf0W.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CfdIRf0W.js","sources":["src/utils/utils.ts"],"sourcesContent":["/**\n * Utility functions for sf-fastpoll\n */\n\n/**\n * Maximum allowed length for text inputs\n */\nconst MAX_TEXT_LENGTH = 500;\nconst MAX_EMAIL_LENGTH = 254;\n\n/**\n * Sanitize user input to prevent XSS and limit length\n * @param input The raw user input\n * @param maxLength Maximum allowed length (default: 500)\n * @returns Sanitized string\n */\nexport function sanitizeInput(input: string, maxLength: number = MAX_TEXT_LENGTH): string {\n  if (typeof input !== 'string') {\n    return '';\n  }\n\n  // Trim whitespace\n  let sanitized = input.replace(/^\\s+|\\s+$/g, '');\n\n  // Remove null bytes\n  sanitized = sanitized.replace(/\\0/g, '');\n\n  // Encode HTML entities to prevent XSS\n  sanitized = sanitized.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\"/g, '&quot;').replace(/'/g, '&#x27;');\n\n  // Truncate to max length\n  if (sanitized.length > maxLength) {\n    sanitized = sanitized.substring(0, maxLength);\n  }\n\n  return sanitized;\n}\n\n/**\n * Sanitize email input with email-specific rules\n * @param email The raw email input\n * @returns Sanitized email string\n */\nexport function sanitizeEmail(email: string): string {\n  if (typeof email !== 'string') {\n    return '';\n  }\n\n  // Trim and lowercase\n  let sanitized = email.replace(/^\\s+|\\s+$/g, '').toLowerCase();\n\n  // Remove null bytes and control characters\n  sanitized = sanitized.replace(/[\\0\\x00-\\x1F\\x7F]/g, '');\n\n  // Truncate to max email length (RFC 5321)\n  if (sanitized.length > MAX_EMAIL_LENGTH) {\n    sanitized = sanitized.substring(0, MAX_EMAIL_LENGTH);\n  }\n\n  return sanitized;\n}\n\n/**\n * Sanitize a value based on field type\n * @param value The raw value\n * @param inputType The type of input field\n * @returns Sanitized value\n */\nexport function sanitizeByType(value: string, inputType: string): string {\n  switch (inputType) {\n    case 'email':\n      return sanitizeEmail(value);\n    case 'number':\n      // Only allow digits, decimal point, and minus sign\n      const numStr = String(value).replace(/[^0-9.\\-]/g, '');\n      return numStr.substring(0, 20); // Reasonable max for numbers\n    case 'dropdown':\n    case 'radio':\n      // For select/radio, sanitize but be more permissive (values come from config)\n      return sanitizeInput(value, 100);\n    case 'checkbox':\n      // Checkbox values are comma-separated, sanitize each\n      return value\n        .split(',')\n        .map(v => sanitizeInput(v.replace(/^\\s+|\\s+$/g, ''), 100))\n        .join(', ');\n    default:\n      return sanitizeInput(value);\n  }\n}\n\n/**\n * Interface for respondent detail options\n */\ninterface RespondentDetailOption {\n  value: string;\n  label: string;\n}\n\n/**\n * Interface for respondent detail configuration\n */\ninterface RespondentDetail {\n  label: string;\n  value: string;\n  inputType: string;\n  required?: boolean;\n  placeholder?: string;\n  options?: RespondentDetailOption[];\n  defaultValue?: any;\n}\n\n/**\n * Check if a survey key is valid UUID\n * @param key The survey key to validate\n * @returns True if the key is a valid UUID, false otherwise\n */\nexport function isValidKey(key: string | undefined | null): boolean {\n  if (typeof key !== 'string' || key.trim().length === 0) {\n    return false;\n  }\n\n  // UUID v4 regex pattern\n  const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n  return uuidRegex.test(key.trim());\n}\n\n/**\n * Format error messages for display\n * @param error The error object or message\n * @returns A formatted error message string\n */\nexport function formatErrorMessage(error: any): string {\n  if (typeof error === 'string') {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return 'An unknown error occurred';\n}\n\n/**\n * Browser-compatible helper to check if array contains a value\n * @param array The array to search\n * @param value The value to find\n * @returns true if value is found in array\n */\nfunction arrayContains(array: string[], value: string): boolean {\n  for (let i = 0; i < array.length; i++) {\n    if (array[i] === value) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Browser-compatible helper to trim and split comma-separated values\n * @param value The comma-separated string\n * @returns Array of trimmed values\n */\nfunction parseCommaSeparatedValues(value: string): string[] {\n  if (!value) {\n    return [];\n  }\n  const parts = value.split(',');\n  const result = [];\n  for (let i = 0; i < parts.length; i++) {\n    const trimmed = parts[i].replace(/^\\s+|\\s+$/g, ''); // Manual trim for IE compatibility\n    if (trimmed) {\n      result.push(trimmed);\n    }\n  }\n  return result;\n}\n\n/**\n * Get field configuration for rendering\n * @param detail The respondent detail configuration\n * @param value The current value of the field\n * @returns Field configuration object\n */\nexport function getFieldConfig(detail: RespondentDetail, value: string) {\n  const inputType = detail.inputType || 'text';\n  const placeholder = detail.placeholder || 'Enter your ' + detail.label.toLowerCase();\n  const required = detail.required !== false;\n\n  return {\n    inputType: inputType,\n    placeholder: placeholder,\n    required: required,\n    options: detail.options || [],\n    defaultValue: detail.defaultValue,\n    hasOptions: detail.options && detail.options.length > 0,\n    selectedValues: parseCommaSeparatedValues(value),\n    fieldValue: detail.value,\n    currentValue: value || '',\n  };\n}\n\n/**\n * Browser-compatible helper to add value to comma-separated list\n * @param currentValue The current comma-separated string\n * @param valueToAdd The value to add\n * @returns Updated comma-separated string\n */\nexport function addToCommaSeparatedList(currentValue: string, valueToAdd: string): string {\n  const values = parseCommaSeparatedValues(currentValue);\n  if (!arrayContains(values, valueToAdd)) {\n    values.push(valueToAdd);\n  }\n  return values.join(', ');\n}\n\n/**\n * Browser-compatible helper to remove value from comma-separated list\n * @param currentValue The current comma-separated string\n * @param valueToRemove The value to remove\n * @returns Updated comma-separated string\n */\nexport function removeFromCommaSeparatedList(currentValue: string, valueToRemove: string): string {\n  const values = parseCommaSeparatedValues(currentValue);\n  const result = [];\n  for (let i = 0; i < values.length; i++) {\n    if (values[i] !== valueToRemove) {\n      result.push(values[i]);\n    }\n  }\n  return result.join(', ');\n}\n"],"names":[],"mappings":"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"}