valtech-components 2.0.711 → 2.0.713

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

@@ -0,0 +1,220 @@
+/**
+ * Content Types System
+ *
+ * This module provides a content abstraction layer that transforms
+ * structured content documents (blog posts, documentation, news articles)
+ * into ArticleMetadata for rendering with val-article component.
+ */
+/**
+ * Author information for content documents
+ */
+export interface ContentAuthor {
+    /** Author's display name */
+    name: string;
+    /** URL to author's avatar image */
+    avatar?: string;
+    /** Author's role or title */
+    role?: string;
+    /** Link to author's profile */
+    profileUrl?: string;
+}
+/**
+ * Common metadata for all content documents
+ */
+export interface ContentMeta {
+    /** Unique identifier */
+    id?: string;
+    /** URL-friendly slug */
+    slug?: string;
+    /** Creation date */
+    createdAt?: Date | string;
+    /** Last update date */
+    updatedAt?: Date | string;
+    /** Publication date */
+    publishedAt?: Date | string;
+    /** Content author */
+    author?: ContentAuthor;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Primary category */
+    category?: string;
+    /** Content locale (e.g., 'es', 'en') */
+    locale?: string;
+}
+/**
+ * Heading block - renders as title or subtitle
+ */
+export interface HeadingBlock {
+    type: 'heading';
+    /** Heading level: 1 = title, 2-3 = subtitle */
+    level: 1 | 2 | 3;
+    /** Heading text */
+    text: string;
+}
+/**
+ * Paragraph block - renders as text
+ */
+export interface ParagraphBlock {
+    type: 'paragraph';
+    /** Paragraph text content */
+    text: string;
+    /** Apply emphasis styling */
+    emphasis?: boolean;
+}
+/**
+ * Quote block - renders as blockquote
+ */
+export interface QuoteBlock {
+    type: 'quote';
+    /** Quote text */
+    text: string;
+    /** Quote author name */
+    author?: string;
+    /** Quote source */
+    source?: string;
+}
+/**
+ * Code block - renders as syntax-highlighted code
+ */
+export interface CodeBlock {
+    type: 'code';
+    /** Code content */
+    code: string;
+    /** Programming language for syntax highlighting */
+    language?: string;
+    /** Code block title/filename */
+    title?: string;
+}
+/**
+ * List block - renders as ordered, unordered, or checklist
+ */
+export interface ListBlock {
+    type: 'list';
+    /** List items (simple strings) */
+    items: string[];
+    /** Render as numbered list */
+    ordered?: boolean;
+    /** Render as checklist with checkmarks */
+    checklist?: boolean;
+}
+/**
+ * Image block - renders as image with optional caption
+ */
+export interface ImageBlock {
+    type: 'image';
+    /** Image source URL */
+    src: string;
+    /** Alt text for accessibility */
+    alt: string;
+    /** Image caption */
+    caption?: string;
+    /** Image alignment */
+    alignment?: 'left' | 'center' | 'right';
+}
+/**
+ * Callout block - renders as highlighted note/warning
+ */
+export interface CalloutBlock {
+    type: 'callout';
+    /** Callout text content */
+    text: string;
+    /** Callout variant determines styling */
+    variant: 'info' | 'warning' | 'success' | 'error';
+    /** Optional title/prefix */
+    title?: string;
+}
+/**
+ * Divider block - renders as separator line
+ */
+export interface DividerBlock {
+    type: 'divider';
+    /** Divider style */
+    style?: 'line' | 'dots' | 'space';
+}
+/**
+ * Button block - renders as call-to-action button
+ */
+export interface ButtonBlock {
+    type: 'button';
+    /** Button text */
+    text: string;
+    /** Link URL (for navigation) */
+    href?: string;
+    /** Action identifier (for event handling) */
+    action?: string;
+    /** Button color */
+    color?: 'primary' | 'secondary' | 'success' | 'warning' | 'danger';
+    /** Button alignment */
+    alignment?: 'left' | 'center' | 'right';
+}
+/**
+ * Command block - renders as terminal/CLI command
+ */
+export interface CommandBlock {
+    type: 'command';
+    /** Command to display */
+    command: string;
+    /** Show copy button */
+    copyable?: boolean;
+}
+/**
+ * Union type of all content blocks
+ */
+export type ContentBlock = HeadingBlock | ParagraphBlock | QuoteBlock | CodeBlock | ListBlock | ImageBlock | CalloutBlock | DividerBlock | ButtonBlock | CommandBlock;
+/**
+ * Configuration options for content rendering
+ */
+export interface ContentConfig {
+    /** Article theme */
+    theme?: 'light' | 'dark' | 'auto';
+    /** Maximum width of the content container */
+    maxWidth?: string;
+    /** Show metadata (author, date, etc.) */
+    showMeta?: boolean;
+    /** Show table of contents */
+    showTableOfContents?: boolean;
+    /** Center the content container */
+    centered?: boolean;
+}
+/**
+ * Base interface for all content documents.
+ * Generic type T represents the document type discriminator.
+ *
+ * @example
+ * ```typescript
+ * interface BlogPost extends ContentDocument<'blog'> {
+ *   title: string;
+ *   excerpt: string;
+ * }
+ * ```
+ */
+export interface ContentDocument<T extends string = string> {
+    /** Document type discriminator */
+    type: T;
+    /** Document metadata */
+    meta: ContentMeta;
+    /** Array of content blocks */
+    content: ContentBlock[];
+    /** Rendering configuration */
+    config?: ContentConfig;
+}
+/**
+ * Type guard to check if a block is a heading
+ */
+export declare function isHeadingBlock(block: ContentBlock): block is HeadingBlock;
+/**
+ * Type guard to check if a block is a paragraph
+ */
+export declare function isParagraphBlock(block: ContentBlock): block is ParagraphBlock;
+/**
+ * Type guard to check if a block is a code block
+ */
+export declare function isCodeBlock(block: ContentBlock): block is CodeBlock;
+/**
+ * Type guard to check if a block is a list
+ */
+export declare function isListBlock(block: ContentBlock): block is ListBlock;
+/**
+ * Type guard to check if a block is a callout
+ */
+export declare function isCalloutBlock(block: ContentBlock): block is CalloutBlock;

package/lib/services/firebase/firestore-collection.d.ts

@@ -99,8 +99,8 @@ export declare class TypedCollection<T extends FirestoreDocument> {
      */
     getFirst(options?: QueryOptions): Promise<T | null>;
     /**
-     * Cuenta los documentos que coinciden con la query.
-     * Nota: Esto carga todos los documentos, usar con cuidado en colecciones grandes.
+     * Cuenta los documentos que coinciden con la query (server-side aggregation).
+     * No descarga documentos — usa getCountFromServer() de Firestore.
      */
     count(options?: QueryOptions): Promise<number>;
     /**

package/lib/services/firebase/firestore.service.d.ts

@@ -80,6 +80,11 @@ export declare class FirestoreService {
      * ```
      */
     getDocs<T extends FirestoreDocument>(collectionPath: string, options?: QueryOptions): Promise<T[]>;
+    /**
+     * Cuenta documentos usando aggregation query del servidor.
+     * No descarga los documentos — mucho más eficiente para conteos y badges.
+     */
+    countDocs(collectionPath: string, options?: QueryOptions): Promise<number>;
     /**
      * Obtiene documentos con paginación basada en cursores.
      *

package/lib/services/firebase/notifications.service.d.ts

@@ -54,6 +54,7 @@ export declare class NotificationsService {
     private collectionFactory;
     private collection;
     private currentUserId;
+    private collectionReady$;
     private authService;
     constructor(injector: Injector, collectionFactory: FirestoreCollectionFactory);
     /**
@@ -98,8 +99,8 @@ export declare class NotificationsService {
      */
     getUnread(limit?: number): Observable<NotificationDocument[]>;
     /**
-     * Cuenta notificaciones no leídas (real-time, filtrado server-side).
-     * Útil para badges en UI.
+     * Cuenta notificaciones no leídas usando server-side aggregation query.
+     * No descarga documentos — eficiente para badges en UI.
      */
     getUnreadCount(): Observable<number>;
     /**

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "2.0.711";
+export declare const VERSION = "2.0.713";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.711",
+  "version": "2.0.713",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"
@@ -19,10 +19,7 @@
     "@ionic/angular": "^8.0.0",
     "firebase": "^10.0.0",
     "ionicons": "^7.2.1",
-    "prismjs": "^1.30.0",
-    "qr-code-styling": "^1.9.0",
-    "rxjs": "~7.8.0",
-    "swiper": "^11.2.8"
+    "rxjs": "~7.8.0"
   },
   "peerDependenciesMeta": {
     "@capacitor/app": {
@@ -33,6 +30,9 @@
     "@capacitor/browser": "^6.0.3",
     "ng-otp-input": "^1.9.3",
     "ngx-image-cropper": "^9.0.0",
+    "prismjs": "^1.30.0",
+    "qr-code-styling": "^1.9.0",
+    "swiper": "^11.2.8",
     "tslib": "^2.3.0"
   },
   "sideEffects": false,

package/public-api.d.ts

@@ -258,6 +258,7 @@ export * from './lib/services/pagination';
 export * from './lib/services/image';
 export * from './lib/services/ads';
 export * from './lib/components/molecules/ad-slot/ad-slot.component';
+export * from './lib/services/content';
 export * from './lib/services/feedback';
 export * from './lib/components/molecules/feedback-form/feedback-form.component';
 export * from './lib/components/molecules/feedback-form/types';