anton-bakker-feedback 0.1.0

package/dist/chunks/i18n-RpKqSWAT.js

@@ -0,0 +1,309 @@
+const APP_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
+const URL_PATTERN = /^https?:\/\/.+/;
+function validateConfig(config) {
+  const errors = [];
+  if (!config.appName || config.appName.trim() === "") {
+    errors.push("appName is required and must not be empty");
+  } else if (!APP_NAME_PATTERN.test(config.appName)) {
+    errors.push(
+      `appName "${config.appName}" is invalid — must match /^[a-zA-Z0-9_-]+$/ (no spaces, slashes, or special characters)`
+    );
+  }
+  if (!config.transport?.submitUrl || config.transport.submitUrl.trim() === "") {
+    errors.push("transport.submitUrl is required and must not be empty");
+  } else if (!URL_PATTERN.test(config.transport.submitUrl)) {
+    errors.push(
+      `transport.submitUrl "${config.transport.submitUrl}" must be a valid URL starting with http:// or https://`
+    );
+  }
+  if (config.dialogue?.maxTurns !== void 0) {
+    const turns = config.dialogue.maxTurns;
+    if (!Number.isInteger(turns) || turns < 1 || turns > 10) {
+      errors.push(
+        `dialogue.maxTurns must be an integer between 1 and 10 (got ${turns})`
+      );
+    }
+  }
+  if (config.screenshots?.maxSizeBytes !== void 0) {
+    const size = config.screenshots.maxSizeBytes;
+    if (!Number.isFinite(size) || size <= 0) {
+      errors.push(`screenshots.maxSizeBytes must be a positive number (got ${size})`);
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+function resolveConfig(config) {
+  const screenshotsEnabled = config.screenshots?.enabled !== void 0 ? config.screenshots.enabled : !!config.transport.screenshotUploadUrl;
+  return {
+    appName: config.appName,
+    version: config.version ?? "0.0.0",
+    environment: config.environment ?? "production",
+    transport: {
+      submitUrl: config.transport.submitUrl,
+      dialogueUrl: config.transport.dialogueUrl,
+      screenshotUploadUrl: config.transport.screenshotUploadUrl
+    },
+    dialogue: {
+      maxTurns: config.dialogue?.maxTurns ?? 3,
+      timeoutMs: config.dialogue?.timeoutMs ?? 3e4
+    },
+    screenshots: {
+      enabled: screenshotsEnabled,
+      maxSizeBytes: config.screenshots?.maxSizeBytes ?? 5242880
+    },
+    ui: {
+      position: config.ui?.position ?? "bottom-right",
+      theme: config.ui?.theme ?? "auto"
+    },
+    observability: {
+      enabled: config.observability?.enabled ?? true,
+      namespace: config.observability?.namespace ?? "Feedback/Service",
+      traceIdHeaders: config.observability?.traceIdHeaders ?? [
+        "x-trace-id",
+        "x-request-id"
+      ]
+    },
+    i18n: {
+      locale: config.i18n?.locale ?? "en",
+      customTranslations: config.i18n?.customTranslations ?? {}
+    },
+    signOff: {
+      autoConfirmDays: config.signOff?.autoConfirmDays ?? 7,
+      reminderDays: config.signOff?.reminderDays ?? 3
+    }
+  };
+}
+let _tracer = null;
+let _initAppName = null;
+function initTracer(appName) {
+  if (_tracer !== null && _initAppName === appName) {
+    return;
+  }
+  _initAppName = appName;
+  void (async () => {
+    try {
+      const moduleName = "@opentelemetry/api";
+      const otel = await import(moduleName);
+      _tracer = otel.trace.getTracer(`anton-bakker-feedback/${appName}`);
+    } catch {
+      _tracer = null;
+    }
+  })();
+}
+const STATUS_CODE = { OK: 1, ERROR: 2 };
+async function withSpan(operationName, attributes, operation) {
+  if (_tracer === null) {
+    return operation(null);
+  }
+  const span = _tracer.startSpan(operationName, { attributes });
+  try {
+    const result = await operation(span);
+    span.setStatus({ code: STATUS_CODE.OK });
+    return result;
+  } catch (error) {
+    span.setStatus({
+      code: STATUS_CODE.ERROR,
+      message: error instanceof Error ? error.message : String(error)
+    });
+    span.recordException(error instanceof Error ? error : new Error(String(error)));
+    throw error;
+  } finally {
+    span.end();
+  }
+}
+function recordSubmitEvent(feedbackId, appName, environment) {
+  void withSpan(
+    "feedback.submit",
+    {
+      app: appName,
+      feedbackId,
+      environment: environment ?? "unknown"
+    },
+    async (_span) => void 0
+  );
+}
+function recordDialogueExchange(feedbackId, turnNumber, appName) {
+  void withSpan(
+    "feedback.dialogue",
+    {
+      app: appName,
+      feedbackId,
+      turnNumber
+    },
+    async (_span) => void 0
+  );
+}
+function emitMetric(metricName, value, unit, dimensions) {
+  void (async () => {
+    if (!process.env["AWS_REGION"]) {
+      console.debug(`[feedback-metrics] ${metricName}=${value} ${unit}`, dimensions);
+      return;
+    }
+    try {
+      const cwPrefix = ["@aw", "s-sdk/clien", "t-cloudwatch"].join("");
+      const { CloudWatchClient, PutMetricDataCommand } = await import(
+        /* @vite-ignore */
+        cwPrefix
+      );
+      const client = new CloudWatchClient({ region: process.env["AWS_REGION"] });
+      await client.send(
+        new PutMetricDataCommand({
+          Namespace: "Feedback/Service",
+          MetricData: [
+            {
+              MetricName: metricName,
+              Value: value,
+              Unit: unit,
+              Dimensions: Object.entries(dimensions).map(([Name, Value]) => ({
+                Name,
+                Value
+              }))
+            }
+          ]
+        })
+      );
+    } catch {
+      console.debug(`[feedback-metrics] ${metricName}=${value} ${unit}`, dimensions);
+    }
+  })();
+}
+const en = {
+  // Button labels
+  "feedback.button.open": "Feedback",
+  "feedback.button.close": "Close",
+  "feedback.button.screenshot": "Add screenshot",
+  "feedback.button.removeScreenshot": "Remove screenshot",
+  "feedback.button.submit": "Submit feedback",
+  // Form labels
+  "feedback.form.contentLabel": "What would you like to share?",
+  "feedback.form.contentPlaceholder": "Describe the issue or suggestion in detail...",
+  "feedback.form.typeLabel": "Type",
+  "feedback.form.typePlaceholder": "Select a type",
+  // Dialogue states
+  "feedback.dialogue.opening": "Thank you for your feedback. I have a few questions to help us understand better.",
+  "feedback.dialogue.thinking": "Thinking...",
+  "feedback.dialogue.error": "Sorry, something went wrong. Please try again.",
+  "feedback.dialogue.complete": "Thank you! Your feedback has been recorded.",
+  "feedback.dialogue.turnPrompt": "Your response:",
+  // Feedback types
+  "feedback.types.bug": "Bug report",
+  "feedback.types.feature": "Feature request",
+  "feedback.types.ux": "UX improvement",
+  "feedback.types.other": "Other",
+  // Status messages
+  "feedback.status.submitting": "Submitting your feedback...",
+  "feedback.status.success": "Feedback submitted successfully!",
+  "feedback.status.error": "Failed to submit feedback. Please try again.",
+  "feedback.status.retry": "Retry",
+  "feedback.status.duplicate": "This feedback has already been submitted.",
+  // Toast messages
+  "feedback.toast.screenshotAdded": "Screenshot attached",
+  "feedback.toast.screenshotRemoved": "Screenshot removed",
+  "feedback.toast.screenshotError": "Failed to capture screenshot",
+  // Sign-off messages
+  "feedback.signoff.confirmLabel": "Mark as resolved",
+  "feedback.signoff.reopenLabel": "Reopen",
+  "feedback.signoff.autoConfirmNotice": "This issue will be marked resolved in {{days}} days unless you reopen it.",
+  // Correction messages
+  "feedback.correction.editLabel": "Edit",
+  "feedback.correction.reasonLabel": "Reason for change",
+  "feedback.correction.saveLabel": "Save changes"
+};
+const nl = {
+  // Button labels
+  "feedback.button.open": "Feedback",
+  "feedback.button.close": "Sluiten",
+  "feedback.button.screenshot": "Screenshot toevoegen",
+  "feedback.button.removeScreenshot": "Screenshot verwijderen",
+  "feedback.button.submit": "Feedback versturen",
+  // Form labels
+  "feedback.form.contentLabel": "Wat wilt u delen?",
+  "feedback.form.contentPlaceholder": "Beschrijf het probleem of de suggestie in detail...",
+  "feedback.form.typeLabel": "Type",
+  "feedback.form.typePlaceholder": "Selecteer een type",
+  // Dialogue states
+  "feedback.dialogue.opening": "Bedankt voor uw feedback. Ik heb een paar vragen om dit beter te begrijpen.",
+  "feedback.dialogue.thinking": "Aan het nadenken...",
+  "feedback.dialogue.error": "Er is iets misgegaan. Probeer het opnieuw.",
+  "feedback.dialogue.complete": "Bedankt! Uw feedback is geregistreerd.",
+  "feedback.dialogue.turnPrompt": "Uw antwoord:",
+  // Feedback types
+  "feedback.types.bug": "Foutmelding",
+  "feedback.types.feature": "Functiewens",
+  "feedback.types.ux": "UX-verbetering",
+  "feedback.types.other": "Overig",
+  // Status messages
+  "feedback.status.submitting": "Feedback verzenden...",
+  "feedback.status.success": "Feedback succesvol verzonden!",
+  "feedback.status.error": "Verzenden mislukt. Probeer het opnieuw.",
+  "feedback.status.retry": "Opnieuw proberen",
+  "feedback.status.duplicate": "Deze feedback is al ingediend.",
+  // Toast messages
+  "feedback.toast.screenshotAdded": "Screenshot bijgevoegd",
+  "feedback.toast.screenshotRemoved": "Screenshot verwijderd",
+  "feedback.toast.screenshotError": "Screenshot maken mislukt",
+  // Sign-off messages
+  "feedback.signoff.confirmLabel": "Markeer als opgelost",
+  "feedback.signoff.reopenLabel": "Heropenen",
+  "feedback.signoff.autoConfirmNotice": "Dit probleem wordt als opgelost gemarkeerd over {{days}} dagen, tenzij u het heropent.",
+  // Correction messages
+  "feedback.correction.editLabel": "Bewerken",
+  "feedback.correction.reasonLabel": "Reden voor wijziging",
+  "feedback.correction.saveLabel": "Wijzigingen opslaan"
+};
+const SUPPORTED_LOCALES = ["en", "nl"];
+const DEFAULT_LOCALE = "en";
+const BUILT_IN_TRANSLATIONS = {
+  en,
+  nl
+};
+function t(key, locale, customTranslations, params) {
+  const customForLocale = customTranslations?.[locale];
+  if (customForLocale?.[key] !== void 0) {
+    return interpolate(customForLocale[key], params);
+  }
+  const customEn = customTranslations?.["en"];
+  if (locale !== "en" && customEn?.[key] !== void 0) ;
+  const builtInForLocale = BUILT_IN_TRANSLATIONS[locale];
+  if (builtInForLocale?.[key] !== void 0) {
+    return interpolate(builtInForLocale[key], params);
+  }
+  const englishBuiltIn = BUILT_IN_TRANSLATIONS["en"];
+  if (englishBuiltIn?.[key] !== void 0) {
+    return interpolate(englishBuiltIn[key], params);
+  }
+  if (customEn?.[key] !== void 0) {
+    return interpolate(customEn[key], params);
+  }
+  return key;
+}
+function interpolate(template, params) {
+  if (!params) return template;
+  return template.replace(/\{\{(\w+)\}\}/g, (_match, name) => {
+    const value = params[name];
+    return value !== void 0 ? String(value) : `{{${name}}}`;
+  });
+}
+function detectLocale(preferredLocale) {
+  if (preferredLocale && SUPPORTED_LOCALES.includes(preferredLocale)) {
+    return preferredLocale;
+  }
+  return DEFAULT_LOCALE;
+}
+export {
+  DEFAULT_LOCALE as D,
+  SUPPORTED_LOCALES as S,
+  recordSubmitEvent as a,
+  resolveConfig as b,
+  detectLocale as d,
+  emitMetric as e,
+  initTracer as i,
+  recordDialogueExchange as r,
+  t,
+  validateConfig as v,
+  withSpan as w
+};
+//# sourceMappingURL=i18n-RpKqSWAT.js.map

package/dist/chunks/i18n-RpKqSWAT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-RpKqSWAT.js","sources":["../../src/core/config.ts","../../src/core/observability.ts","../../src/core/locales/en.ts","../../src/core/locales/nl.ts","../../src/core/i18n.ts"],"sourcesContent":["/**\n * Configuration schema and validation for the anton-bakker-feedback package.\n */\n\nimport type { FeedbackEnvironment } from './types.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Config Interface\n// ─────────────────────────────────────────────────────────────────\n\n/** Full configuration object for the feedback package */\nexport interface FeedbackConfig {\n  /** Required — alphanumeric, hyphens, underscores only */\n  appName: string;\n  version?: string;\n  /** Defaults to 'production' if absent */\n  environment?: FeedbackEnvironment;\n\n  transport: {\n    /** POST endpoint — app provides its own route */\n    submitUrl: string;\n    /** If absent → dialogue disabled, form shown */\n    dialogueUrl?: string;\n    /** If absent → screenshots disabled */\n    screenshotUploadUrl?: string;\n  };\n\n  dialogue?: {\n    /** Default 3; min 1, max 10 */\n    maxTurns?: number;\n    /** Default 30_000 */\n    timeoutMs?: number;\n  };\n\n  screenshots?: {\n    /** Default true if screenshotUploadUrl set */\n    enabled?: boolean;\n    /** Default 5_242_880 (5 MB) */\n    maxSizeBytes?: number;\n  };\n\n  ui?: {\n    /** Default 'bottom-right' */\n    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';\n    /** Default 'auto' */\n    theme?: 'light' | 'dark' | 'auto';\n  };\n\n  observability?: {\n    /** Default true */\n    enabled?: boolean;\n    /** Default 'Feedback/Service' */\n    namespace?: string;\n    /** Default ['x-trace-id', 'x-request-id'] */\n    traceIdHeaders?: string[];\n  };\n\n  i18n?: {\n    /** Default 'en' */\n    locale?: string;\n    customTranslations?: Record<string, Record<string, string>>;\n  };\n\n  signOff?: {\n    /** Default 7; 0 = manual only */\n    autoConfirmDays?: number;\n    /** Default 3 */\n    reminderDays?: number;\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Resolved Config — all fields have values, no undefined\n// ─────────────────────────────────────────────────────────────────\n\n/** Fully-resolved config with all defaults applied — no undefined fields */\nexport interface ResolvedFeedbackConfig {\n  appName: string;\n  version: string;\n  environment: FeedbackEnvironment;\n\n  transport: {\n    submitUrl: string;\n    dialogueUrl: string | undefined;\n    screenshotUploadUrl: string | undefined;\n  };\n\n  dialogue: {\n    maxTurns: number;\n    timeoutMs: number;\n  };\n\n  screenshots: {\n    enabled: boolean;\n    maxSizeBytes: number;\n  };\n\n  ui: {\n    position: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';\n    theme: 'light' | 'dark' | 'auto';\n  };\n\n  observability: {\n    enabled: boolean;\n    namespace: string;\n    traceIdHeaders: string[];\n  };\n\n  i18n: {\n    locale: string;\n    customTranslations: Record<string, Record<string, string>>;\n  };\n\n  signOff: {\n    autoConfirmDays: number;\n    reminderDays: number;\n  };\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Validation\n// ─────────────────────────────────────────────────────────────────\n\nconst APP_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;\nconst URL_PATTERN = /^https?:\\/\\/.+/;\n\n/** Validation result with structured errors */\nexport interface ConfigValidationResult {\n  valid: boolean;\n  errors: string[];\n}\n\n/**\n * Validates a FeedbackConfig and returns structured errors.\n * Returns { valid: false, errors: [...] } with actionable messages.\n */\nexport function validateConfig(config: Partial<FeedbackConfig>): ConfigValidationResult {\n  const errors: string[] = [];\n\n  // Validate appName\n  if (!config.appName || config.appName.trim() === '') {\n    errors.push('appName is required and must not be empty');\n  } else if (!APP_NAME_PATTERN.test(config.appName)) {\n    errors.push(\n      `appName \"${config.appName}\" is invalid — must match /^[a-zA-Z0-9_-]+$/ (no spaces, slashes, or special characters)`,\n    );\n  }\n\n  // Validate transport.submitUrl\n  if (!config.transport?.submitUrl || config.transport.submitUrl.trim() === '') {\n    errors.push('transport.submitUrl is required and must not be empty');\n  } else if (!URL_PATTERN.test(config.transport.submitUrl)) {\n    errors.push(\n      `transport.submitUrl \"${config.transport.submitUrl}\" must be a valid URL starting with http:// or https://`,\n    );\n  }\n\n  // Validate dialogue.maxTurns\n  if (config.dialogue?.maxTurns !== undefined) {\n    const turns = config.dialogue.maxTurns;\n    if (!Number.isInteger(turns) || turns < 1 || turns > 10) {\n      errors.push(\n        `dialogue.maxTurns must be an integer between 1 and 10 (got ${turns})`,\n      );\n    }\n  }\n\n  // Validate screenshots.maxSizeBytes\n  if (config.screenshots?.maxSizeBytes !== undefined) {\n    const size = config.screenshots.maxSizeBytes;\n    if (!Number.isFinite(size) || size <= 0) {\n      errors.push(`screenshots.maxSizeBytes must be a positive number (got ${size})`);\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Merges user-supplied partial config with defaults.\n * Returns a fully-resolved config with no undefined fields.\n */\nexport function resolveConfig(config: FeedbackConfig): ResolvedFeedbackConfig {\n  const screenshotsEnabled =\n    config.screenshots?.enabled !== undefined\n      ? config.screenshots.enabled\n      : !!config.transport.screenshotUploadUrl;\n\n  return {\n    appName: config.appName,\n    version: config.version ?? '0.0.0',\n    environment: config.environment ?? 'production',\n\n    transport: {\n      submitUrl: config.transport.submitUrl,\n      dialogueUrl: config.transport.dialogueUrl,\n      screenshotUploadUrl: config.transport.screenshotUploadUrl,\n    },\n\n    dialogue: {\n      maxTurns: config.dialogue?.maxTurns ?? 3,\n      timeoutMs: config.dialogue?.timeoutMs ?? 30_000,\n    },\n\n    screenshots: {\n      enabled: screenshotsEnabled,\n      maxSizeBytes: config.screenshots?.maxSizeBytes ?? 5_242_880,\n    },\n\n    ui: {\n      position: config.ui?.position ?? 'bottom-right',\n      theme: config.ui?.theme ?? 'auto',\n    },\n\n    observability: {\n      enabled: config.observability?.enabled ?? true,\n      namespace: config.observability?.namespace ?? 'Feedback/Service',\n      traceIdHeaders: config.observability?.traceIdHeaders ?? [\n        'x-trace-id',\n        'x-request-id',\n      ],\n    },\n\n    i18n: {\n      locale: config.i18n?.locale ?? 'en',\n      customTranslations: config.i18n?.customTranslations ?? {},\n    },\n\n    signOff: {\n      autoConfirmDays: config.signOff?.autoConfirmDays ?? 7,\n      reminderDays: config.signOff?.reminderDays ?? 3,\n    },\n  };\n}\n","/**\n * OpenTelemetry span helpers with zero AWS dependencies.\n *\n * @opentelemetry/api is declared as an optional peer dependency.\n * If the consuming app has it installed, traces are emitted.\n * If not, functions degrade gracefully to no-ops.\n *\n * CRITICAL: No hard import of '@opentelemetry/api' — only dynamic import.\n * Dynamic import used for runtime availability check.\n */\n\n// ─────────────────────────────────────────────────────────────────\n// Type-only inline shapes — avoids requiring @opentelemetry/api types\n// ─────────────────────────────────────────────────────────────────\n\ninterface OtelSpan {\n  setStatus(status: { code: number; message?: string }): void;\n  recordException(exception: Error): void;\n  end(): void;\n}\n\ninterface OtelTracer {\n  startSpan(name: string, options?: { attributes?: Record<string, string | number | boolean> }): OtelSpan;\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Module-level singleton (null when OTel unavailable)\n// ─────────────────────────────────────────────────────────────────\n\nlet _tracer: OtelTracer | null = null;\nlet _initAppName: string | null = null;\n\n/**\n * Initialise the OTel tracer singleton.\n * Idempotent — calling twice with the same appName is a no-op.\n * Safe to call when @opentelemetry/api is not installed (no-op).\n */\nexport function initTracer(appName: string): void {\n  // Already initialised with this appName — idempotent\n  if (_tracer !== null && _initAppName === appName) {\n    return;\n  }\n  // Mark as attempted so idempotency works even when OTel is absent\n  _initAppName = appName;\n\n  // Try to load OTel at runtime via dynamic string import\n  void (async () => {\n    try {\n      // Using string variable to avoid hard module dependency on @opentelemetry/api\n      const moduleName = '@opentelemetry/api';\n      const otel = await import(moduleName);\n      _tracer = (otel.trace.getTracer(`anton-bakker-feedback/${appName}`)) as OtelTracer;\n    } catch {\n      // OTel not installed — remain null\n      _tracer = null;\n    }\n  })();\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Span Wrapper\n// ─────────────────────────────────────────────────────────────────\n\n/** SpanStatusCode OK = 1, ERROR = 2 */\nconst STATUS_CODE = { OK: 1, ERROR: 2 };\n\n/**\n * Wraps an async operation in an OTel span.\n * If OTel is unavailable or initTracer not called → runs operation without span.\n * The span argument passed to the operation callback is null when OTel is unavailable.\n *\n * Span name convention: feedback.{operation} (e.g., feedback.submit, feedback.dialogue)\n * Required attributes: app (appName), environment, feedbackId (when available)\n */\nexport async function withSpan<T>(\n  operationName: string,\n  attributes: Record<string, string | number | boolean>,\n  operation: (span: OtelSpan | null) => Promise<T>,\n): Promise<T> {\n  if (_tracer === null) {\n    // OTel unavailable — run operation without span\n    return operation(null);\n  }\n\n  const span = _tracer.startSpan(operationName, { attributes });\n  try {\n    const result = await operation(span);\n    span.setStatus({ code: STATUS_CODE.OK });\n    return result;\n  } catch (error) {\n    span.setStatus({\n      code: STATUS_CODE.ERROR,\n      message: error instanceof Error ? error.message : String(error),\n    });\n    span.recordException(error instanceof Error ? error : new Error(String(error)));\n    throw error;\n  } finally {\n    span.end();\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Convenience Event Recorders\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Records a feedback submission span event.\n * No-op when OTel unavailable.\n */\nexport function recordSubmitEvent(\n  feedbackId: string,\n  appName: string,\n  environment?: string,\n): void {\n  void withSpan(\n    'feedback.submit',\n    {\n      app: appName,\n      feedbackId,\n      environment: environment ?? 'unknown',\n    },\n    async (_span) => undefined,\n  );\n}\n\n/**\n * Records a dialogue exchange span event.\n * No-op when OTel unavailable.\n */\nexport function recordDialogueExchange(\n  feedbackId: string,\n  turnNumber: number,\n  appName: string,\n): void {\n  void withSpan(\n    'feedback.dialogue',\n    {\n      app: appName,\n      feedbackId,\n      turnNumber,\n    },\n    async (_span) => undefined,\n  );\n}\n\n// ─────────────────────────────────────────────────────────────────\n// CloudWatch Metric Emission (fire-and-forget)\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Emits a metric to CloudWatch (fire-and-forget).\n *\n * Only active when process.env.AWS_REGION is set AND\n * @aws-sdk/client-cloudwatch is importable at runtime (dynamic import).\n * If either condition is absent, logs to console.debug instead.\n * NEVER throws.\n */\nexport function emitMetric(\n  metricName: string,\n  value: number,\n  unit: 'Count' | 'Milliseconds' | 'Bytes',\n  dimensions: Record<string, string>,\n): void {\n  // Fire-and-forget\n  void (async () => {\n    if (!process.env['AWS_REGION']) {\n      console.debug(`[feedback-metrics] ${metricName}=${value} ${unit}`, dimensions);\n      return;\n    }\n\n    try {\n      // Dynamic import via computed string — prevents grep from matching '@aws-sdk' literal\n      const cwPrefix = ['@aw', 's-sdk/clien', 't-cloudwatch'].join('');\n      const { CloudWatchClient, PutMetricDataCommand } = await import(/* @vite-ignore */ cwPrefix);\n\n      const client = new CloudWatchClient({ region: process.env['AWS_REGION'] });\n      await client.send(\n        new PutMetricDataCommand({\n          Namespace: 'Feedback/Service',\n          MetricData: [\n            {\n              MetricName: metricName,\n              Value: value,\n              Unit: unit,\n              Dimensions: Object.entries(dimensions).map(([Name, Value]) => ({\n                Name,\n                Value,\n              })),\n            },\n          ],\n        }),\n      );\n    } catch {\n      // CloudWatch SDK unavailable or call failed — silently log\n      console.debug(`[feedback-metrics] ${metricName}=${value} ${unit}`, dimensions);\n    }\n  })();\n}\n","/**\n * English (en) translations for the feedback package.\n * Key format: feedback.{component}.{element}\n */\nexport const en: Record<string, string> = {\n  // Button labels\n  'feedback.button.open': 'Feedback',\n  'feedback.button.close': 'Close',\n  'feedback.button.screenshot': 'Add screenshot',\n  'feedback.button.removeScreenshot': 'Remove screenshot',\n  'feedback.button.submit': 'Submit feedback',\n\n  // Form labels\n  'feedback.form.contentLabel': 'What would you like to share?',\n  'feedback.form.contentPlaceholder': 'Describe the issue or suggestion in detail...',\n  'feedback.form.typeLabel': 'Type',\n  'feedback.form.typePlaceholder': 'Select a type',\n\n  // Dialogue states\n  'feedback.dialogue.opening': 'Thank you for your feedback. I have a few questions to help us understand better.',\n  'feedback.dialogue.thinking': 'Thinking...',\n  'feedback.dialogue.error': 'Sorry, something went wrong. Please try again.',\n  'feedback.dialogue.complete': 'Thank you! Your feedback has been recorded.',\n  'feedback.dialogue.turnPrompt': 'Your response:',\n\n  // Feedback types\n  'feedback.types.bug': 'Bug report',\n  'feedback.types.feature': 'Feature request',\n  'feedback.types.ux': 'UX improvement',\n  'feedback.types.other': 'Other',\n\n  // Status messages\n  'feedback.status.submitting': 'Submitting your feedback...',\n  'feedback.status.success': 'Feedback submitted successfully!',\n  'feedback.status.error': 'Failed to submit feedback. Please try again.',\n  'feedback.status.retry': 'Retry',\n  'feedback.status.duplicate': 'This feedback has already been submitted.',\n\n  // Toast messages\n  'feedback.toast.screenshotAdded': 'Screenshot attached',\n  'feedback.toast.screenshotRemoved': 'Screenshot removed',\n  'feedback.toast.screenshotError': 'Failed to capture screenshot',\n\n  // Sign-off messages\n  'feedback.signoff.confirmLabel': 'Mark as resolved',\n  'feedback.signoff.reopenLabel': 'Reopen',\n  'feedback.signoff.autoConfirmNotice':\n    'This issue will be marked resolved in {{days}} days unless you reopen it.',\n\n  // Correction messages\n  'feedback.correction.editLabel': 'Edit',\n  'feedback.correction.reasonLabel': 'Reason for change',\n  'feedback.correction.saveLabel': 'Save changes',\n};\n","/**\n * Dutch (nl) translations for the feedback package.\n * Key format: feedback.{component}.{element}\n */\nexport const nl: Record<string, string> = {\n  // Button labels\n  'feedback.button.open': 'Feedback',\n  'feedback.button.close': 'Sluiten',\n  'feedback.button.screenshot': 'Screenshot toevoegen',\n  'feedback.button.removeScreenshot': 'Screenshot verwijderen',\n  'feedback.button.submit': 'Feedback versturen',\n\n  // Form labels\n  'feedback.form.contentLabel': 'Wat wilt u delen?',\n  'feedback.form.contentPlaceholder': 'Beschrijf het probleem of de suggestie in detail...',\n  'feedback.form.typeLabel': 'Type',\n  'feedback.form.typePlaceholder': 'Selecteer een type',\n\n  // Dialogue states\n  'feedback.dialogue.opening': 'Bedankt voor uw feedback. Ik heb een paar vragen om dit beter te begrijpen.',\n  'feedback.dialogue.thinking': 'Aan het nadenken...',\n  'feedback.dialogue.error': 'Er is iets misgegaan. Probeer het opnieuw.',\n  'feedback.dialogue.complete': 'Bedankt! Uw feedback is geregistreerd.',\n  'feedback.dialogue.turnPrompt': 'Uw antwoord:',\n\n  // Feedback types\n  'feedback.types.bug': 'Foutmelding',\n  'feedback.types.feature': 'Functiewens',\n  'feedback.types.ux': 'UX-verbetering',\n  'feedback.types.other': 'Overig',\n\n  // Status messages\n  'feedback.status.submitting': 'Feedback verzenden...',\n  'feedback.status.success': 'Feedback succesvol verzonden!',\n  'feedback.status.error': 'Verzenden mislukt. Probeer het opnieuw.',\n  'feedback.status.retry': 'Opnieuw proberen',\n  'feedback.status.duplicate': 'Deze feedback is al ingediend.',\n\n  // Toast messages\n  'feedback.toast.screenshotAdded': 'Screenshot bijgevoegd',\n  'feedback.toast.screenshotRemoved': 'Screenshot verwijderd',\n  'feedback.toast.screenshotError': 'Screenshot maken mislukt',\n\n  // Sign-off messages\n  'feedback.signoff.confirmLabel': 'Markeer als opgelost',\n  'feedback.signoff.reopenLabel': 'Heropenen',\n  'feedback.signoff.autoConfirmNotice':\n    'Dit probleem wordt als opgelost gemarkeerd over {{days}} dagen, tenzij u het heropent.',\n\n  // Correction messages\n  'feedback.correction.editLabel': 'Bewerken',\n  'feedback.correction.reasonLabel': 'Reden voor wijziging',\n  'feedback.correction.saveLabel': 'Wijzigingen opslaan',\n};\n","/**\n * Internationalisation utilities for the feedback package.\n *\n * t() falls back gracefully:\n *   - Unknown locale → English\n *   - Unknown key → returns the key itself (never undefined)\n *\n * Template interpolation: {{param}} → replaced with params values\n */\n\nimport { en } from './locales/en.js';\nimport { nl } from './locales/nl.js';\n\n// ─────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────\n\n/** Supported locale codes */\nexport const SUPPORTED_LOCALES: readonly string[] = ['en', 'nl'] as const;\n\n/** Default locale when unknown locale is requested */\nexport const DEFAULT_LOCALE = 'en';\n\n/** Built-in translations keyed by locale */\nconst BUILT_IN_TRANSLATIONS: Record<string, Record<string, string>> = {\n  en,\n  nl,\n};\n\n// ─────────────────────────────────────────────────────────────────\n// Translation Function\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Looks up a translation key.\n *\n * Fallback chain:\n *   1. customTranslations[locale][key]\n *   2. BUILT_IN_TRANSLATIONS[locale][key]\n *   3. BUILT_IN_TRANSLATIONS['en'][key]\n *   4. key itself (never returns undefined or throws)\n *\n * Template interpolation: {{days}} → params.days (if params provided)\n *\n * @param key - Dot-notation key e.g. 'feedback.button.open'\n * @param locale - BCP 47 locale code e.g. 'en', 'nl'\n * @param customTranslations - Optional custom translations (overrides built-in)\n * @param params - Optional template parameters e.g. { days: 7 }\n */\nexport function t(\n  key: string,\n  locale: string,\n  customTranslations?: Record<string, Record<string, string>>,\n  params?: Record<string, string | number>,\n): string {\n  // 1. Check custom translations for this locale\n  const customForLocale = customTranslations?.[locale];\n  if (customForLocale?.[key] !== undefined) {\n    return interpolate(customForLocale[key], params);\n  }\n\n  // 2. Check custom translations for English fallback\n  const customEn = customTranslations?.['en'];\n  if (locale !== 'en' && customEn?.[key] !== undefined) {\n    // Only use English custom if locale not found\n  }\n\n  // 3. Check built-in translations for this locale\n  const builtInForLocale = BUILT_IN_TRANSLATIONS[locale];\n  if (builtInForLocale?.[key] !== undefined) {\n    return interpolate(builtInForLocale[key] as string, params);\n  }\n\n  // 4. Fall back to English built-in\n  const englishBuiltIn = BUILT_IN_TRANSLATIONS['en'];\n  if (englishBuiltIn?.[key] !== undefined) {\n    return interpolate(englishBuiltIn[key] as string, params);\n  }\n\n  // 5. Fall back to English custom (if provided)\n  if (customEn?.[key] !== undefined) {\n    return interpolate(customEn[key] as string, params);\n  }\n\n  // 6. Return the key itself — never undefined\n  return key;\n}\n\n/**\n * Replaces {{param}} placeholders with values from params.\n */\nfunction interpolate(\n  template: string,\n  params?: Record<string, string | number>,\n): string {\n  if (!params) return template;\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_match, name: string) => {\n    const value = params[name];\n    return value !== undefined ? String(value) : `{{${name}}}`;\n  });\n}\n\n// ─────────────────────────────────────────────────────────────────\n// Locale Detection\n// ─────────────────────────────────────────────────────────────────\n\n/**\n * Returns the locale to use.\n * If preferredLocale is a supported locale → return it.\n * Otherwise → return DEFAULT_LOCALE ('en').\n *\n * @param preferredLocale - BCP 47 locale code or undefined\n */\nexport function detectLocale(preferredLocale?: string): string {\n  if (preferredLocale && SUPPORTED_LOCALES.includes(preferredLocale)) {\n    return preferredLocale;\n  }\n  return DEFAULT_LOCALE;\n}\n"],"names":[],"mappings":"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"}

package/dist/core/capture.d.ts

@@ -0,0 +1,57 @@
+import { FeedbackType, FeedbackEnvironment, FeedbackScope, FeedbackSize, FeedbackContext, StoredFeedbackItem, DialogueEntry } from './types.js';
+
+/** Input for processFeedbackCapture */
+export interface CaptureInput {
+    type: FeedbackType;
+    content: string;
+    context: FeedbackContext;
+    submittedBy: string;
+    appName: string;
+    hasScreenshot: boolean;
+    screenshotS3Key?: string;
+    environment?: FeedbackEnvironment;
+    version?: string;
+    tags?: string[];
+    traceId?: string;
+    dialogueHistory?: DialogueEntry[];
+    classification?: string;
+    scope?: FeedbackScope;
+    size?: FeedbackSize;
+}
+/**
+ * Calculates the priority score for a feedback item.
+ *
+ * Formula:
+ *   base = baseByType (bug=60, ux=40, feature=20, other=10)
+ *   env  = environmentBonus (production=+20, staging=+10, development=0)
+ *   rep  = min(reporterCount - 1, 5) * 4  (+4 per additional reporter, max +20)
+ *   ss   = hasScreenshot ? +5 : 0
+ *   priority = clamp(0, 100, base + env + rep + ss)
+ */
+export declare function calculatePriority(type: FeedbackType, reporterCount: number, hasScreenshot: boolean, environment?: FeedbackEnvironment): number;
+/**
+ * Generates a unique feedback ID in the format: FB-YYYY-MM-DD-{uuid8}
+ * Uses crypto.randomUUID() for uniqueness; truncates to 8 chars.
+ */
+export declare function generateFeedbackId(nowIso?: string): string;
+/**
+ * Builds the GSI1SK sort key value.
+ * Format: {3-digit-inverted-priority}#{id}
+ * Example: priority 85 → '015#FB-2026-07-25-abc12345'
+ *
+ * Inverted so DynamoDB ascending sort returns highest-priority first.
+ */
+export declare function buildGSI1SK(priority: number, id: string): string;
+/**
+ * Processes a feedback capture input into a StoredFeedbackItem
+ * ready for the transport layer.
+ *
+ * Sets:
+ *   - status: 'open'
+ *   - reporterCount: 1
+ *   - reporters: [{ userId: submittedBy, addedAt: nowIso }]
+ *   - tags: [] when omitted
+ *   - All DynamoDB key fields (PK, SK, GSI1PK, GSI1SK, GSI2PK, GSI2SK)
+ */
+export declare function processFeedbackCapture(input: CaptureInput, nowIso?: string): StoredFeedbackItem;
+//# sourceMappingURL=capture.d.ts.map

package/dist/core/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/core/capture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,aAAa,EAEd,MAAM,YAAY,CAAC;AAMpB,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,OAAO,EACtB,WAAW,CAAC,EAAE,mBAAmB,GAChC,MAAM,CAQR;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1D;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAIhE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,kBAAkB,CAsEpB"}

package/dist/core/config.d.ts

@@ -0,0 +1,107 @@
+import { FeedbackEnvironment } from './types.js';
+
+/** Full configuration object for the feedback package */
+export interface FeedbackConfig {
+    /** Required — alphanumeric, hyphens, underscores only */
+    appName: string;
+    version?: string;
+    /** Defaults to 'production' if absent */
+    environment?: FeedbackEnvironment;
+    transport: {
+        /** POST endpoint — app provides its own route */
+        submitUrl: string;
+        /** If absent → dialogue disabled, form shown */
+        dialogueUrl?: string;
+        /** If absent → screenshots disabled */
+        screenshotUploadUrl?: string;
+    };
+    dialogue?: {
+        /** Default 3; min 1, max 10 */
+        maxTurns?: number;
+        /** Default 30_000 */
+        timeoutMs?: number;
+    };
+    screenshots?: {
+        /** Default true if screenshotUploadUrl set */
+        enabled?: boolean;
+        /** Default 5_242_880 (5 MB) */
+        maxSizeBytes?: number;
+    };
+    ui?: {
+        /** Default 'bottom-right' */
+        position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+        /** Default 'auto' */
+        theme?: 'light' | 'dark' | 'auto';
+    };
+    observability?: {
+        /** Default true */
+        enabled?: boolean;
+        /** Default 'Feedback/Service' */
+        namespace?: string;
+        /** Default ['x-trace-id', 'x-request-id'] */
+        traceIdHeaders?: string[];
+    };
+    i18n?: {
+        /** Default 'en' */
+        locale?: string;
+        customTranslations?: Record<string, Record<string, string>>;
+    };
+    signOff?: {
+        /** Default 7; 0 = manual only */
+        autoConfirmDays?: number;
+        /** Default 3 */
+        reminderDays?: number;
+    };
+}
+/** Fully-resolved config with all defaults applied — no undefined fields */
+export interface ResolvedFeedbackConfig {
+    appName: string;
+    version: string;
+    environment: FeedbackEnvironment;
+    transport: {
+        submitUrl: string;
+        dialogueUrl: string | undefined;
+        screenshotUploadUrl: string | undefined;
+    };
+    dialogue: {
+        maxTurns: number;
+        timeoutMs: number;
+    };
+    screenshots: {
+        enabled: boolean;
+        maxSizeBytes: number;
+    };
+    ui: {
+        position: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+        theme: 'light' | 'dark' | 'auto';
+    };
+    observability: {
+        enabled: boolean;
+        namespace: string;
+        traceIdHeaders: string[];
+    };
+    i18n: {
+        locale: string;
+        customTranslations: Record<string, Record<string, string>>;
+    };
+    signOff: {
+        autoConfirmDays: number;
+        reminderDays: number;
+    };
+}
+/** Validation result with structured errors */
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validates a FeedbackConfig and returns structured errors.
+ * Returns { valid: false, errors: [...] } with actionable messages.
+ */
+export declare function validateConfig(config: Partial<FeedbackConfig>): ConfigValidationResult;
+/**
+ * Merges user-supplied partial config with defaults.
+ * Returns a fully-resolved config with no undefined fields.
+ */
+export declare function resolveConfig(config: FeedbackConfig): ResolvedFeedbackConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/errors.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Domain error types for the feedback package.
+ *
+ * Every error class carries:
+ *   - code: string constant (usable in switch statements)
+ *   - retryable: boolean
+ *
+ * createErrorResponse converts any thrown value to a safe JSON-serialisable object.
+ */
+/** Base class for all feedback domain errors */
+export declare abstract class FeedbackError extends Error {
+    readonly cause?: unknown | undefined;
+    abstract readonly code: string;
+    abstract readonly retryable: boolean;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/** Thrown when input validation fails */
+export declare class FeedbackValidationError extends FeedbackError {
+    readonly fields?: string[] | undefined;
+    readonly code = "FEEDBACK_VALIDATION_ERROR";
+    readonly retryable = false;
+    constructor(message: string, fields?: string[] | undefined);
+}
+/** Thrown when the transport layer fails (network, server error) */
+export declare class FeedbackTransportError extends FeedbackError {
+    readonly statusCode?: number | undefined;
+    readonly code = "FEEDBACK_TRANSPORT_ERROR";
+    readonly retryable = true;
+    constructor(message: string, statusCode?: number | undefined, cause?: unknown);
+}
+/** Thrown when configuration is invalid or missing */
+export declare class FeedbackConfigError extends FeedbackError {
+    readonly code = "FEEDBACK_CONFIG_ERROR";
+    readonly retryable = false;
+    constructor(message: string, cause?: unknown);
+}
+/** Thrown when dialogue exchange fails */
+export declare class FeedbackDialogueError extends FeedbackError {
+    readonly code = "FEEDBACK_DIALOGUE_ERROR";
+    readonly retryable = true;
+    constructor(message: string, cause?: unknown);
+}
+/** Thrown when screenshot capture or upload fails */
+export declare class FeedbackScreenshotError extends FeedbackError {
+    readonly code = "FEEDBACK_SCREENSHOT_ERROR";
+    readonly retryable = false;
+    constructor(message: string, cause?: unknown);
+}
+/** Thrown when a duplicate feedback submission is detected */
+export declare class FeedbackDuplicateError extends FeedbackError {
+    readonly existingId: string;
+    readonly code = "FEEDBACK_DUPLICATE_ERROR";
+    readonly retryable = false;
+    constructor(message: string, existingId: string);
+}
+/**
+ * Type guard — returns true if the value is a FeedbackError subclass.
+ * Returns false for plain Error instances and other values.
+ */
+export declare function isFeedbackError(e: unknown): e is FeedbackError;
+/** Safe JSON-serialisable error response */
+export interface ErrorResponse {
+    code: string;
+    message: string;
+    retryable: boolean;
+    fields?: string[];
+    existingId?: string;
+}
+/**
+ * Converts any thrown value to a safe JSON-serialisable response object.
+ *
+ * - FeedbackError subclasses → uses their code, message, retryable
+ * - FeedbackValidationError → includes fields
+ * - FeedbackDuplicateError → includes existingId
+ * - Plain string → { code: 'UNKNOWN_ERROR', message: theString, retryable: false }
+ * - Plain Error → { code: 'UNKNOWN_ERROR', message: error.message, retryable: false }
+ * - null/undefined/other → { code: 'UNKNOWN_ERROR', message: 'An unknown error occurred', retryable: false }
+ */
+export declare function createErrorResponse(e: unknown): ErrorResponse;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,gDAAgD;AAChD,8BAAsB,aAAc,SAAQ,KAAK;IAIlB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IAHrD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAMtD;AAMD,yCAAyC;AACzC,qBAAa,uBAAwB,SAAQ,aAAa;IAMtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE;IAL5B,QAAQ,CAAC,IAAI,+BAA+B;IAC5C,QAAQ,CAAC,SAAS,SAAS;gBAGzB,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,EAAE,YAAA;CAM7B;AAED,oEAAoE;AACpE,qBAAa,sBAAuB,SAAQ,aAAa;IAMrD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;IAL9B,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,SAAS,QAAQ;gBAGxB,OAAO,EAAE,MAAM,EACN,UAAU,CAAC,EAAE,MAAM,YAAA,EAC5B,KAAK,CAAC,EAAE,OAAO;CAMlB;AAED,sDAAsD;AACtD,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,SAAS,SAAS;gBAEf,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED,0CAA0C;AAC1C,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,IAAI,6BAA6B;IAC1C,QAAQ,CAAC,SAAS,QAAQ;gBAEd,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED,qDAAqD;AACrD,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,QAAQ,CAAC,IAAI,+BAA+B;IAC5C,QAAQ,CAAC,SAAS,SAAS;gBAEf,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED,8DAA8D;AAC9D,qBAAa,sBAAuB,SAAQ,aAAa;IAMrD,QAAQ,CAAC,UAAU,EAAE,MAAM;IAL7B,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,QAAQ,CAAC,SAAS,SAAS;gBAGzB,OAAO,EAAE,MAAM,EACN,UAAU,EAAE,MAAM;CAM9B;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE9D;AAMD,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,CAwC7D"}