@indesad/feedback-widget 0.0.0-stage → 1.1.1

package/dist/sha256.d.ts

@@ -0,0 +1,7 @@
+/** Devuelve el SHA-256 en hexadecimal en mayúsculas (igual que Convert.ToHexString en el servidor). */
+export declare function sha256Hex(text: string): string;
+/**
+ * Busca la prueba de trabajo: un número cuyo SHA-256(token:número) empiece con `difficulty` ceros.
+ * Cede el hilo cada lote para no congelar la página anfitriona.
+ */
+export declare function solveChallenge(token: string, difficulty?: number, maxAttempts?: number): Promise<string>;

package/dist/styles.d.ts

@@ -0,0 +1 @@
+export declare const STYLES = "\n:host {\n  all: initial;\n  --iff-accent: var(--if-brand, #FD0055);\n  --iff-accent-hover: var(--if-brand-hover, #E0004B);\n  --iff-accent-soft: var(--if-brand-soft, rgba(253, 0, 85, 0.12));\n  --iff-accent-contrast: #FFFFFF;\n  --iff-bg: var(--if-bg-elevated, #FFFFFF);\n  --iff-surface: var(--if-bg-surface, #F8F9FA);\n  --iff-hover: var(--if-bg-hover, #F1F3F5);\n  --iff-text: var(--if-text-primary, #000002);\n  --iff-muted: var(--if-text-tertiary, #64748B);\n  --iff-border: var(--if-border-subtle, #E2E8F0);\n  --iff-border-strong: var(--if-border-default, #CBD5E1);\n  --iff-danger: var(--if-danger, #EF4444);\n  --iff-danger-soft: var(--if-danger-soft, rgba(239, 68, 68, 0.12));\n  --iff-success: var(--if-success, #10B981);\n  --iff-success-soft: var(--if-success-soft, rgba(16, 185, 129, 0.12));\n  --iff-shadow: var(--if-shadow-overlay, 0 20px 25px -5px rgba(0, 0, 0, 0.15), 0 8px 10px -6px rgba(0, 0, 0, 0.1));\n  --iff-radius: var(--if-radius-lg, 14px);\n  --iff-radius-sm: var(--if-radius-md, 10px);\n  --iff-font: var(--if-font-sans, 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);\n  --iff-font-heading: var(--if-font-heading, 'Oxanium', 'Inter', sans-serif);\n  position: fixed; z-index: var(--iff-z, 2147483000); font-family: var(--iff-font); color: var(--iff-text);\n  -webkit-font-smoothing: antialiased; line-height: 1.4; font-size: 14px;\n}\n:host([data-theme=\"dark\"]) {\n  --iff-bg: var(--if-bg-elevated, #262626);\n  --iff-surface: var(--if-bg-surface, #181818);\n  --iff-hover: var(--if-bg-hover, #2A2A2A);\n  --iff-text: var(--if-text-primary, #E2E8F0);\n  --iff-muted: var(--if-text-tertiary, #94A3B8);\n  --iff-border: var(--if-border-subtle, rgba(255, 255, 255, 0.08));\n  --iff-border-strong: var(--if-border-default, rgba(255, 255, 255, 0.14));\n  --iff-shadow: var(--if-shadow-overlay, 0 20px 30px -5px rgba(0, 0, 0, 0.9));\n}\n* { box-sizing: border-box; }\nbutton, input, textarea { font: inherit; color: inherit; }\n[hidden] { display: none !important; }\n.launcher {\n  display: inline-flex; align-items: center; gap: 8px; height: 44px; padding: 0 16px 0 12px; border: none; border-radius: 9999px;\n  background: var(--iff-accent); color: var(--iff-accent-contrast); font-weight: 600; font-size: 14px; cursor: pointer;\n  box-shadow: 0 8px 20px -6px rgba(253, 0, 85, 0.45), 0 2px 6px rgba(0, 0, 0, 0.12); transition: transform .15s ease, background .15s ease;\n}\n.launcher:hover { background: var(--iff-accent-hover); transform: translateY(-1px); }\n.launcher.icon-only { width: 44px; padding: 0; justify-content: center; }\n.launcher.icon-only .label { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }\n.launcher:focus-visible, button:focus-visible, a:focus-visible, input:focus-visible, textarea:focus-visible, label.file:focus-within {\n  outline: 2px solid var(--iff-accent); outline-offset: 2px;\n}\n.launcher svg, .launcher img { width: 20px; height: 20px; flex: none; }\n.launcher .emoji { font-size: 18px; line-height: 1; }\n.panel {\n  position: fixed; width: 380px; max-width: calc(100vw - 24px); max-height: min(640px, calc(100vh - 96px)); display: flex; flex-direction: column;\n  background: var(--iff-bg); color: var(--iff-text); border: 1px solid var(--iff-border); border-radius: var(--iff-radius); box-shadow: var(--iff-shadow);\n  overflow: hidden; animation: iff-in .18s ease-out;\n}\n@keyframes iff-in { from { opacity: 0; transform: translateY(8px) scale(.98); } to { opacity: 1; transform: none; } }\n@media (prefers-reduced-motion: reduce) { .panel { animation: none; } .launcher { transition: none; } }\n.head { display: flex; align-items: flex-start; gap: 10px; padding: 16px 16px 12px; border-bottom: 1px solid var(--iff-border); }\n.head .titles { flex: 1; min-width: 0; }\n.brand { font-family: var(--iff-font-heading); font-size: 11px; letter-spacing: .08em; text-transform: uppercase; color: var(--iff-accent); font-weight: 700; }\n.title { margin: 2px 0 0; font-size: 17px; font-weight: 700; line-height: 1.25; }\n.subtitle { margin: 4px 0 0; font-size: 12.5px; color: var(--iff-muted); }\n.icon-btn { flex: none; width: 32px; height: 32px; display: inline-grid; place-items: center; border: none; border-radius: 8px; background: transparent; cursor: pointer; color: var(--iff-muted); }\n.icon-btn:hover { background: var(--iff-hover); color: var(--iff-text); }\n.icon-btn svg { width: 18px; height: 18px; }\n.body { padding: 14px 16px 16px; overflow-y: auto; display: flex; flex-direction: column; gap: 12px; }\n.kinds { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }\n.kind {\n  display: flex; flex-direction: column; align-items: flex-start; gap: 6px; padding: 12px; text-align: left; cursor: pointer;\n  background: var(--iff-surface); border: 1px solid var(--iff-border); border-radius: var(--iff-radius-sm); transition: border-color .15s ease, background .15s ease;\n}\n.kind:hover { border-color: var(--iff-accent); background: var(--iff-accent-soft); }\n.kind .k-icon { width: 30px; height: 30px; border-radius: 8px; display: inline-grid; place-items: center; background: var(--iff-accent-soft); color: var(--iff-accent); }\n.kind .k-icon svg { width: 18px; height: 18px; }\n.kind strong { font-size: 13.5px; font-weight: 600; }\n.kind span { font-size: 12px; color: var(--iff-muted); }\n.help { display: flex; align-items: center; gap: 8px; font-size: 12.5px; color: var(--iff-muted); text-decoration: none; padding: 8px 10px; border-radius: 8px; border: 1px dashed var(--iff-border-strong); }\n.help:hover { color: var(--iff-text); border-color: var(--iff-accent); }\n.help svg { width: 16px; height: 16px; flex: none; }\n.chip { align-self: flex-start; display: inline-flex; align-items: center; gap: 6px; font-size: 12px; font-weight: 600; color: var(--iff-accent); background: var(--iff-accent-soft); padding: 4px 10px; border-radius: 9999px; }\n.chip svg { width: 14px; height: 14px; }\nlabel.field { display: flex; flex-direction: column; gap: 6px; font-size: 12.5px; font-weight: 600; }\nlabel.field .hint { font-weight: 400; color: var(--iff-muted); }\ninput[type=\"text\"], input[type=\"email\"], textarea {\n  width: 100%; padding: 10px 12px; border-radius: var(--iff-radius-sm); border: 1px solid var(--iff-border-strong); background: var(--iff-surface);\n  font-size: 14px; font-weight: 400;\n}\ntextarea { min-height: 120px; resize: vertical; }\ninput::placeholder, textarea::placeholder { color: var(--iff-muted); opacity: .9; }\n.row { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }\n.meta { display: flex; justify-content: space-between; gap: 8px; font-size: 11.5px; color: var(--iff-muted); }\n.as { font-size: 12px; color: var(--iff-muted); background: var(--iff-surface); border: 1px solid var(--iff-border); border-radius: 8px; padding: 8px 10px; overflow-wrap: anywhere; }\nlabel.file { display: flex; align-items: center; gap: 8px; font-size: 13px; cursor: pointer; padding: 9px 12px; border: 1px dashed var(--iff-border-strong); border-radius: var(--iff-radius-sm); color: var(--iff-muted); }\nlabel.file:hover { border-color: var(--iff-accent); color: var(--iff-text); }\nlabel.file svg { width: 16px; height: 16px; }\nlabel.file input { position: absolute; width: 1px; height: 1px; opacity: 0; }\n.preview { display: flex; align-items: center; gap: 10px; padding: 8px; border: 1px solid var(--iff-border); border-radius: var(--iff-radius-sm); background: var(--iff-surface); }\n.preview + .preview { margin-top: -6px; }\n.preview img { width: 56px; height: 40px; object-fit: cover; border-radius: 6px; }\n.preview .name { flex: 1; min-width: 0; font-size: 12px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.link-btn { border: none; background: none; color: var(--iff-accent); cursor: pointer; font-size: 12.5px; font-weight: 600; padding: 4px; }\n.privacy { font-size: 11.5px; color: var(--iff-muted); margin: 0; }\n.error { font-size: 12.5px; color: var(--iff-danger); background: var(--iff-danger-soft); border-radius: 8px; padding: 8px 10px; margin: 0; }\n.actions { display: flex; justify-content: flex-end; gap: 8px; }\n.primary {\n  display: inline-flex; align-items: center; justify-content: center; gap: 8px; min-width: 120px; height: 40px; padding: 0 18px; border: none; border-radius: var(--iff-radius-sm);\n  background: var(--iff-accent); color: var(--iff-accent-contrast); font-weight: 600; cursor: pointer;\n}\n.primary:hover { background: var(--iff-accent-hover); }\n.primary[disabled] { opacity: .65; cursor: progress; }\n.secondary { height: 40px; padding: 0 14px; border-radius: var(--iff-radius-sm); border: 1px solid var(--iff-border-strong); background: transparent; cursor: pointer; font-weight: 600; }\n.secondary:hover { background: var(--iff-hover); }\n.spinner { width: 16px; height: 16px; border-radius: 50%; border: 2px solid rgba(255,255,255,.45); border-top-color: #fff; animation: iff-spin .8s linear infinite; }\n@keyframes iff-spin { to { transform: rotate(360deg); } }\n.done { display: flex; flex-direction: column; align-items: center; text-align: center; gap: 10px; padding: 8px 4px 4px; }\n.done .ok { width: 52px; height: 52px; border-radius: 50%; display: grid; place-items: center; background: var(--iff-success-soft); color: var(--iff-success); }\n.done .ok svg { width: 26px; height: 26px; }\n.done h3 { margin: 0; font-size: 17px; }\n.done p { margin: 0; font-size: 13px; color: var(--iff-muted); }\n.done .folio { font-family: var(--if-font-mono, ui-monospace, monospace); font-weight: 700; color: var(--iff-text); }\n.done .buttons { display: flex; gap: 8px; flex-wrap: wrap; justify-content: center; margin-top: 6px; }\n.done a.primary { text-decoration: none; }\n.foot { padding: 8px 16px; border-top: 1px solid var(--iff-border); font-size: 11px; color: var(--iff-muted); text-align: center; }\n@media (max-width: 480px) {\n  .panel { inset: 0 !important; width: 100vw; max-width: 100vw; height: 100dvh; max-height: 100dvh; border-radius: 0; border: none;\n    padding: var(--if-safe-top, env(safe-area-inset-top, 0px)) var(--if-safe-right, env(safe-area-inset-right, 0px)) var(--if-safe-bottom, env(safe-area-inset-bottom, 0px)) var(--if-safe-left, env(safe-area-inset-left, 0px)); }\n  .kinds { grid-template-columns: 1fr; }\n  .row { grid-template-columns: 1fr; }\n  .launcher .label { display: none; }\n  .launcher { width: 48px; height: 48px; padding: 0; justify-content: center; }\n}\n";

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+export type FeedbackKind = 'bug' | 'improvement' | 'question' | 'praise';
+export type FeedbackLocale = 'es-419' | 'en' | 'pt-BR';
+/** Identidad que declara la app anfitriona para la persona que ya inició sesión en ella. IndeFlow no la verifica. */
+export interface FeedbackUser {
+    name?: string;
+    email?: string;
+    company?: string;
+    externalUserId?: string;
+}
+/** Colores del widget. Se aplican como variables CSS --iff-*; por defecto heredan los tokens --if-* de la app si existen. */
+export interface FeedbackTheme {
+    accent: string;
+    accentContrast: string;
+    background: string;
+    surface: string;
+    text: string;
+    muted: string;
+    border: string;
+    danger: string;
+    success: string;
+    radius: string;
+    font: string;
+}
+export interface IndeFlowFeedbackConfig {
+    /** Base de la API de IndeFlow, por ejemplo https://api.indeflow.app/api */
+    apiUrl: string;
+    /** Token de la fuente (if_obs_...) con opiniones activas. Es público por naturaleza: solo permite enviar opiniones. */
+    sourceToken: string;
+    /** Persona con sesión en la app. Sin user, el formulario pide nombre y correo (si la fuente permite anónimos). */
+    user?: FeedbackUser | null;
+    /** Idioma del widget y de los correos al reportante. 'auto' usa el del navegador. */
+    locale?: FeedbackLocale | 'auto' | string;
+    /** Nombre que se muestra arriba (por defecto, el que configuró la fuente). */
+    brandLabel?: string;
+    title?: string;
+    position?: 'bottom-right' | 'bottom-left';
+    /** Separación del borde en píxeles, para no tapar otros botones flotantes. */
+    offset?: {
+        x?: number;
+        y?: number;
+    };
+    /** 'bubble' muestra el botón flotante; 'none' lo oculta y la app abre el panel con open(). */
+    launcher?: 'bubble' | 'none';
+    /** 'pill' muestra ícono y texto; 'icon' un botón redondo compacto (el texto queda para lectores de pantalla). */
+    launcherStyle?: 'pill' | 'icon';
+    launcherLabel?: string;
+    launcherIcon?: string;
+    launcherIconType?: 'default' | 'emoji' | 'image' | 'svg';
+    /** 'auto' sigue a la app (html.dark, data-theme o themeSelector) y, si no hay pista, a prefers-color-scheme. */
+    theme?: 'light' | 'dark' | 'auto';
+    themeSelector?: string;
+    colors?: Partial<FeedbackTheme>;
+    /** Tipos que ofrece. Si falta, usa los de la fuente. */
+    kinds?: FeedbackKind[];
+    /** Enlace «Necesito ayuda» hacia el soporte de la app (portal, WhatsApp…). Una urgencia no es una opinión. */
+    supportUrl?: string;
+    supportLabel?: string;
+    /** Ofrece adjuntar capturas (hasta 5 imágenes de 5 MB; el servidor fija los límites). Por defecto true. */
+    screenshot?: boolean;
+    /** Datos fijos que acompañan cada envío (módulo, plan…). Máximo 20 claves. No pongas secretos. */
+    context?: Record<string, string>;
+    appVersion?: string;
+    /** Adjunta la ruta actual (sin parámetros). Por defecto true. */
+    collectRoute?: boolean;
+    zIndex?: number;
+    showPoweredBy?: boolean;
+    onSubmitted?: (result: {
+        folio: string;
+        trackingUrl: string;
+    }) => void;
+    onError?: (error: {
+        code: string;
+        message: string;
+    }) => void;
+}
+export interface RemoteConfig {
+    appName: string;
+    kinds: FeedbackKind[];
+    allowAnonymous: boolean;
+    requireEmail: boolean;
+    defaultLocale: string;
+    maxAttachmentBytes: number;
+    /** FB-000005: imágenes por opinión. Un servidor anterior no lo manda: el widget asume 5. */
+    maxAttachments?: number;
+    attachmentTypes: string[];
+    maxMessage: number;
+}
+export interface IndeFlowFeedbackController {
+    open(kind?: FeedbackKind): void;
+    close(): void;
+    toggle(): void;
+    setUser(user: FeedbackUser | null): void;
+    setContext(context: Record<string, string>): void;
+    update(config: Partial<IndeFlowFeedbackConfig>): void;
+    destroy(): void;
+    readonly ready: Promise<boolean>;
+}

package/dist/widget.d.ts

@@ -0,0 +1,67 @@
+import type { FeedbackKind, FeedbackUser, IndeFlowFeedbackConfig, IndeFlowFeedbackController } from './types';
+export declare const VERSION = "1.1.1";
+export declare class IndeFlowFeedbackWidget implements IndeFlowFeedbackController {
+    private config;
+    private remote;
+    private host;
+    private root;
+    private launcherButton;
+    private panel;
+    private step;
+    private kind;
+    private draft;
+    private attachments;
+    private submissionId;
+    private sending;
+    private error;
+    private result;
+    private extraContext;
+    private themeObserver;
+    private media;
+    private readonly onMedia;
+    private readonly onKey;
+    private destroyed;
+    readonly ready: Promise<boolean>;
+    constructor(config: IndeFlowFeedbackConfig);
+    private get locale();
+    private get t();
+    private get endpoint();
+    private get appName();
+    private get user();
+    private get anonymous();
+    private get kinds();
+    /** Sin identidad de la app y con anónimos apagados en la fuente, no hay a quién pedirle nada: no se muestra. */
+    private get available();
+    private headers;
+    private start;
+    private mount;
+    private applyColors;
+    private isDark;
+    private applyTheme;
+    private watchTheme;
+    private place;
+    private render;
+    private renderLauncher;
+    private renderPanel;
+    private renderKinds;
+    private renderForm;
+    private renderDone;
+    private choose;
+    private reset;
+    private maxAttachments;
+    private maxMegabytes;
+    /** Adds each valid image up to the limit; the ones that fail leave their message and the rest still get attached. */
+    private attach;
+    private validate;
+    private context;
+    private submit;
+    private handleKey;
+    open(kind?: FeedbackKind): void;
+    close(): void;
+    toggle(): void;
+    setUser(user: FeedbackUser | null): void;
+    setContext(context: Record<string, string>): void;
+    update(config: Partial<IndeFlowFeedbackConfig>): void;
+    destroy(): void;
+}
+export declare function createIndeFlowFeedback(config: IndeFlowFeedbackConfig): IndeFlowFeedbackController;

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@indesad/feedback-widget",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.1",
+  "description": "Widget de opiniones de producto de IndeFlow: reportar problemas, sugerir mejoras, preguntar y felicitar desde cualquier app web. Sin dependencias, Shadow DOM, claro/oscuro, es/en/pt.",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "author": "INDESAD",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/INDESAD/IndeFlow.git",
+    "directory": "packages/web/feedback-widget"
+  },
+  "homepage": "https://indeflow.app",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}