valtech-components 2.0.595 → 2.0.596

package/lib/services/feedback/types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Configuración del servicio de Feedback.
+ */
+export interface ValtechFeedbackConfig {
+    /** URL base de la API */
+    apiUrl: string;
+    /** ID de la aplicación (ej: 'my-valtech-app') */
+    appId: string;
+    /** Prefijo para endpoints (default: '/v1/feedback') */
+    feedbackPrefix?: string;
+    /** Número máximo de adjuntos (default: 5) */
+    maxAttachments?: number;
+    /** Tamaño máximo por archivo en bytes (default: 10MB) */
+    maxFileSize?: number;
+    /** Tipos de archivo permitidos (default: ['image/*', 'video/*', 'application/pdf']) */
+    allowedFileTypes?: string[];
+    /** Ruta en Firebase Storage para adjuntos (default: 'feedback') */
+    storagePath?: string;
+}
+/**
+ * Tipos de feedback disponibles.
+ */
+export type FeedbackType = 'issue' | 'poor-content' | 'feedback' | 'suggestion' | 'reaction';
+/**
+ * Valor de reacción (para feedback tipo emoji).
+ */
+export type ReactionValue = 'negative' | 'neutral' | 'positive';
+/**
+ * Estado de un feedback.
+ */
+export type FeedbackStatus = 'new' | 'reviewed' | 'resolved';
+/**
+ * Tipos de contenido para referencia.
+ */
+export type ContentType = 'article' | 'faq' | 'news' | 'page' | 'product' | 'event' | 'other';
+/**
+ * Referencia a contenido específico.
+ */
+export interface ContentRef {
+    contentId: string;
+    contentType: ContentType;
+}
+/**
+ * Referencia a entidad (para reactions y feedback de contenido).
+ */
+export interface EntityRef {
+    /** Tipo de entidad: 'article', 'docs', 'feature', 'bug', etc. */
+    entityType: string;
+    /** ID de la entidad */
+    entityId: string;
+}
+/**
+ * Contexto del dispositivo del usuario.
+ */
+export interface DeviceContext {
+    browser: string;
+    os: string;
+    viewport: string;
+    language: string;
+    userAgent: string;
+    pageUrl: string;
+}
+/**
+ * Entrada de feedback completa.
+ */
+export interface Feedback {
+    feedbackId: string;
+    appId: string;
+    userId: string;
+    type: FeedbackType;
+    title: string;
+    description: string;
+    attachments: string[];
+    contentRef?: ContentRef;
+    entityRef?: EntityRef;
+    reactionValue?: ReactionValue;
+    deviceContext: DeviceContext;
+    status: FeedbackStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Request para crear feedback.
+ */
+export interface CreateFeedbackRequest {
+    type: FeedbackType;
+    title?: string;
+    description?: string;
+    attachments?: string[];
+    contentRef?: ContentRef;
+    entityRef?: EntityRef;
+    reactionValue?: ReactionValue;
+    deviceContext: DeviceContext;
+    appId: string;
+}
+/**
+ * Response al crear feedback.
+ */
+export interface CreateFeedbackResponse {
+    operationId: string;
+    feedbackId: string;
+    status: FeedbackStatus;
+    createdAt: string;
+}
+/**
+ * Response al obtener feedback.
+ */
+export interface GetFeedbackResponse {
+    operationId: string;
+    feedback: Feedback;
+}
+/**
+ * Opciones de tipo de feedback para UI.
+ */
+export interface FeedbackTypeOption {
+    value: FeedbackType;
+    label: string;
+    description?: string;
+    icon?: string;
+}
+/**
+ * Configuración por defecto de tipos de feedback.
+ */
+export declare const DEFAULT_FEEDBACK_TYPE_OPTIONS: FeedbackTypeOption[];
+/**
+ * Response al verificar si existe feedback para una entidad.
+ */
+export interface CheckFeedbackResponse {
+    operationId: string;
+    hasFeedback: boolean;
+    feedbackId?: string;
+    type?: FeedbackType;
+    reactionValue?: ReactionValue;
+    createdAt?: string;
+}
+/**
+ * Request para listar feedback (admin).
+ */
+export interface ListFeedbackRequest {
+    appId?: string;
+    type?: FeedbackType;
+    status?: FeedbackStatus;
+    entityType?: string;
+    entityId?: string;
+    userId?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    nextToken?: string;
+}
+/**
+ * Response al listar feedback.
+ */
+export interface ListFeedbackResponse {
+    operationId: string;
+    feedbacks: Feedback[];
+    nextToken?: string;
+    count: number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.595",
+  "version": "2.0.596",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -235,6 +235,11 @@ export * from './lib/services/skeleton';
 export * from './lib/services/pagination';
 export * from './lib/services/ads';
 export * from './lib/components/molecules/ad-slot/ad-slot.component';
+export * from './lib/services/feedback';
+export * from './lib/components/molecules/feedback-form/feedback-form.component';
+export * from './lib/components/molecules/feedback-form/types';
+export * from './lib/components/molecules/content-reaction/content-reaction.component';
+export * from './lib/components/molecules/content-reaction/types';
 export * from './lib/components/templates/docs-layout/docs-layout.component';
 export * from './lib/components/templates/docs-layout/types';
 export * from './lib/components/organisms/docs-sidebar/docs-sidebar.component';
@@ -252,6 +257,10 @@ export * from './lib/components/molecules/docs-search/types';
 export * from './lib/components/molecules/docs-breadcrumb/docs-breadcrumb.component';
 export * from './lib/components/molecules/docs-breadcrumb/types';
 export * from './lib/components/molecules/docs-callout/docs-callout.component';
+export * from './lib/components/molecules/docs-section/docs-section.component';
+export * from './lib/components/molecules/docs-section/types';
+export * from './lib/components/templates/docs-page/docs-page.component';
+export * from './lib/components/templates/docs-page/types';
 export * from './lib/services/docs/docs-navigation.service';
 export * from './lib/components/types';
 export * from './lib/shared/pipes/process-links.pipe';