ng-firebase-table-kxp 1.0.1 → 1.0.3

package/lib/services/table.service.d.ts

@@ -0,0 +1,74 @@
+import { AngularFirestore, CollectionReference } from '@angular/fire/compat/firestore';
+import firebase from 'firebase/compat/app';
+import { Arrange, Condition, Pagination } from '../types/Table';
+import { MatDialog } from '@angular/material/dialog';
+import { ToastrService } from 'ngx-toastr';
+import { ValidatorFn } from '@angular/forms';
+import * as i0 from "@angular/core";
+interface PaginationResult {
+    items: any[];
+    filterLength: number | null;
+    firstDoc: firebase.firestore.QueryDocumentSnapshot<unknown> | null;
+    lastDoc: firebase.firestore.QueryDocumentSnapshot<unknown> | null;
+    hasNextPage: boolean;
+    hasPreviousPage?: boolean;
+    currentClientPageIndex?: number;
+    totalPages?: number;
+}
+export declare class TableService {
+    private ngFire;
+    private dialog;
+    private toastr;
+    constructor(ngFire: AngularFirestore, dialog: MatDialog, toastr: ToastrService);
+    getItems(collection: CollectionReference<unknown>): Promise<any[]>;
+    private executeQuery;
+    applyFilters(query: firebase.firestore.Query<unknown>, arrange: Arrange, conditions: Condition[] | undefined): firebase.firestore.Query<unknown>;
+    /**
+     * Detecta se a query vai precisar de index composto e deve usar fallback client-side
+     */
+    private shouldUseClientSideFallback;
+    getPaginated(params: Pagination): Promise<PaginationResult>;
+    executeClientSideQuery(params: Pagination): Promise<PaginationResult>;
+    getItemsData(collection: string, arrange: Arrange, conditions?: Condition[] | undefined): Promise<any[]>;
+    operators: {
+        '==': (a: any, b: any) => boolean;
+        '!=': (a: any, b: any) => boolean;
+        '>': (a: any, b: any) => boolean;
+        '<': (a: any, b: any) => boolean;
+        '>=': (a: any, b: any) => boolean;
+        '<=': (a: any, b: any) => boolean;
+        in: (a: any, b: any) => boolean;
+        'not-in': (a: any, b: any) => boolean;
+        'array-contains': (a: any, b: any) => boolean;
+        'array-contains-any': (a: any, b: any) => boolean;
+        includes: (a: any, b: any) => any;
+    };
+    deleteIndex(id: string, col: string): Promise<boolean>;
+    reindex(index: number, col: string, batch: firebase.firestore.WriteBatch): Promise<void>;
+    dateFormatValidator(): ValidatorFn;
+    updateIndex(index: number, id: string, col: string): Promise<void>;
+    /**
+     * Extrai o link de criação de índice da mensagem de erro do Firestore
+     */
+    private extractIndexLink;
+    /**
+     * Rastreia índices ausentes ao usar fallback preventivo
+     */
+    private trackMissingIndexPreventive;
+    /**
+     * Gera uma assinatura única para uma query
+     */
+    private generateQuerySignature;
+    /**
+     * Gera instruções claras para criar o índice manualmente
+     */
+    private generateIndexInstructions;
+    /**
+     * Gera um link de índice baseado na estrutura da query
+     */
+    private generateIndexLink;
+    private trackMissingIndex;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TableService, [{ optional: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TableService>;
+}
+export {};

package/{src/lib/types/Table.ts → lib/types/Table.d.ts}

@@ -1,142 +1,139 @@
-import {
-    CollectionReference,
-    DocumentReference,
-    QueryDocumentSnapshot
-} from '@angular/fire/compat/firestore';
-import {PipeTransform} from '@angular/core';
-import firebase from 'firebase/compat';
-import WhereFilterOp = firebase.firestore.WhereFilterOp;
-import {OrderByDirection} from 'firebase/firestore';
-
-export interface TableData {
-    displayedColumns: Column[];
-    filterableOptions?: FilterableOption[];
-    collectionRef: CollectionReference<unknown>;
-    collection: string;
-    name: string;
-    totalRef?: {ref: DocumentReference<unknown>; field: string}[];
-    download: boolean;
-    pagination: boolean;
-    isNotClickable?: boolean;
-    url?: string;
-    sortBy?: {field: string; order: OrderByDirection};
-    conditions?: {
-        operator: WhereFilterOp;
-        firestoreProperty: string;
-        dashProperty: string | string[];
-    }[];
-    filterFn?: (item: any) => boolean;
-    color?: {bg: string; text: string};
-    actionButton?: {
-        label: string;
-        routerLink: string;
-        icon?: string;
-        colorClass?: string;
-        method?: (row: any, event?: any) => any;
-        condition?: (row?: any) => boolean;
-    };
-    tabs?: Tab;
-}
-
-export interface Tab {
-    method: (tab: any, event?: any) => any;
-    tabsData: TabData[];
-}
-
-export interface TabData {
-    label: string;
-    counter?: number;
-    counterClass?: string;
-}
-
-export interface Column {
-    property: string;
-    title?: string;
-    charLimit?: number;
-    pipe?: PipeTransform;
-    iconClass?: {
-        text?: string;
-        class?: string;
-        condition?: (row: any) => any;
-        buttonMethod?: (row: any, event?: any) => any;
-    }[];
-    isSortable?: boolean;
-    isFilterable?: boolean;
-    isFilterableByDate?: boolean;
-    hasLink?: boolean | string;
-    hasDownload?: boolean | string;
-    relation?: {
-        collection: string;
-        property: string;
-        newProperty: string;
-    };
-    queryLength?: {
-        collection: string;
-        property: string;
-        operator: WhereFilterOp;
-        value: string;
-    };
-    image?: Image;
-    method?: (row: any, event?: any) => any;
-    filterPredicates?: string[];
-    calculateValue?: (row: any) => any;
-    arrayField?: string;
-}
-
-export interface Image {
-    class: string;
-    path?: string;
-    url?: boolean;
-    default?: string;
-}
-
-export interface FilterableOption {
-    title: string;
-    items: {
-        property: string;
-        value: string | boolean;
-        label: string;
-    }[];
-}
-
-export interface Pagination {
-    batchSize: number;
-    collection: string;
-    doc?: {
-        firstDoc: QueryDocumentSnapshot<any> | null;
-        lastDoc: QueryDocumentSnapshot<any> | null;
-    };
-    navigation: 'reload' | 'forward' | 'backward';
-    arrange: Arrange;
-    conditions?: Condition[];
-    filterFn?: (item: any) => boolean;
-    size?: number;
-    clientPageIndex?: number;
-}
-
-export interface Condition {
-    operator: WhereFilterOp;
-    firestoreProperty: string;
-    dashProperty: string | string[];
-}
-
-export interface Arrange {
-    filters: {
-        arrange:
-            | 'ascending'
-            | 'descending'
-            | 'filter'
-            | 'filterByDate'
-            | 'equals'
-            | '';
-        filter?: {property: string; filtering: string} | null;
-        dateFilter?: {
-            initial: Date;
-            final: Date;
-        };
-    }[];
-    sortBy: {field: string; order: OrderByDirection};
-    elementId?: {property: string; value: string};
-}
-
-
+import { CollectionReference, DocumentReference, QueryDocumentSnapshot } from '@angular/fire/compat/firestore';
+import { PipeTransform } from '@angular/core';
+import firebase from 'firebase/compat';
+import WhereFilterOp = firebase.firestore.WhereFilterOp;
+import { OrderByDirection } from 'firebase/firestore';
+export interface TableData {
+    displayedColumns: Column[];
+    filterableOptions?: FilterableOption[];
+    collectionRef: CollectionReference<unknown>;
+    collection: string;
+    name: string;
+    totalRef?: {
+        ref: DocumentReference<unknown>;
+        field: string;
+    }[];
+    download: boolean;
+    pagination: boolean;
+    isNotClickable?: boolean;
+    url?: string;
+    sortBy?: {
+        field: string;
+        order: OrderByDirection;
+    };
+    conditions?: {
+        operator: WhereFilterOp;
+        firestoreProperty: string;
+        dashProperty: string | string[];
+    }[];
+    filterFn?: (item: any) => boolean;
+    color?: {
+        bg: string;
+        text: string;
+    };
+    actionButton?: {
+        label: string;
+        routerLink: string;
+        icon?: string;
+        colorClass?: string;
+        method?: (row: any, event?: any) => any;
+        condition?: (row?: any) => boolean;
+    };
+    tabs?: Tab;
+}
+export interface Tab {
+    method: (tab: any, event?: any) => any;
+    tabsData: TabData[];
+}
+export interface TabData {
+    label: string;
+    counter?: number;
+    counterClass?: string;
+}
+export interface Column {
+    property: string;
+    title?: string;
+    charLimit?: number;
+    pipe?: PipeTransform;
+    iconClass?: {
+        text?: string;
+        class?: string;
+        condition?: (row: any) => any;
+        buttonMethod?: (row: any, event?: any) => any;
+    }[];
+    isSortable?: boolean;
+    isFilterable?: boolean;
+    isFilterableByDate?: boolean;
+    hasLink?: boolean | string;
+    hasDownload?: boolean | string;
+    relation?: {
+        collection: string;
+        property: string;
+        newProperty: string;
+    };
+    queryLength?: {
+        collection: string;
+        property: string;
+        operator: WhereFilterOp;
+        value: string;
+    };
+    image?: Image;
+    method?: (row: any, event?: any) => any;
+    filterPredicates?: string[];
+    calculateValue?: (row: any) => any;
+    arrayField?: string;
+}
+export interface Image {
+    class: string;
+    path?: string;
+    url?: boolean;
+    default?: string;
+}
+export interface FilterableOption {
+    title: string;
+    items: {
+        property: string;
+        value: string | boolean;
+        label: string;
+    }[];
+}
+export interface Pagination {
+    batchSize: number;
+    collection: string;
+    doc?: {
+        firstDoc: QueryDocumentSnapshot<any> | null;
+        lastDoc: QueryDocumentSnapshot<any> | null;
+    };
+    navigation: 'reload' | 'forward' | 'backward';
+    arrange: Arrange;
+    conditions?: Condition[];
+    filterFn?: (item: any) => boolean;
+    size?: number;
+    clientPageIndex?: number;
+}
+export interface Condition {
+    operator: WhereFilterOp;
+    firestoreProperty: string;
+    dashProperty: string | string[];
+}
+export interface Arrange {
+    filters: {
+        arrange: 'ascending' | 'descending' | 'filter' | 'filterByDate' | 'equals' | '';
+        filter?: {
+            property: string;
+            filtering: string;
+        } | null;
+        dateFilter?: {
+            initial: Date;
+            final: Date;
+        };
+    }[];
+    sortBy: {
+        field: string;
+        order: OrderByDirection;
+    };
+    elementId?: {
+        property: string;
+        value: string;
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ng-firebase-table-kxp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Uma biblioteca Angular poderosa para criar tabelas dinâmicas com integração completa ao Firebase Firestore",
   "keywords": [
     "angular",
@@ -32,5 +32,25 @@
   },
   "dependencies": {
     "tslib": "^2.3.0"
-  }
+  },
+  "module": "fesm2015/ng-firebase-table-kxp.mjs",
+  "es2020": "fesm2020/ng-firebase-table-kxp.mjs",
+  "esm2020": "esm2020/ng-firebase-table-kxp.mjs",
+  "fesm2020": "fesm2020/ng-firebase-table-kxp.mjs",
+  "fesm2015": "fesm2015/ng-firebase-table-kxp.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2020": "./esm2020/ng-firebase-table-kxp.mjs",
+      "es2020": "./fesm2020/ng-firebase-table-kxp.mjs",
+      "es2015": "./fesm2015/ng-firebase-table-kxp.mjs",
+      "node": "./fesm2015/ng-firebase-table-kxp.mjs",
+      "default": "./fesm2020/ng-firebase-table-kxp.mjs"
+    }
+  },
+  "sideEffects": false
 }

package/{src/public-api.ts → public-api.d.ts}

@@ -1,19 +1,6 @@
-/*
- * Public API Surface of firebase-table-kxp-lib
- */
-
-// Main module
-export * from './lib/firebase-table-kxp-lib.module';
-
-// Legacy components (se existirem)
-export * from './lib/firebase-table-kxp-lib.service';
-export * from './lib/firebase-table-kxp-lib.component';
-
-// Components
-export * from './lib/components/table/table.component';
-
-// Services
-export * from './lib/services/table.service';
-
-// Types
-export * from './lib/types/Table';
+export * from './lib/firebase-table-kxp-lib.module';
+export * from './lib/firebase-table-kxp-lib.service';
+export * from './lib/firebase-table-kxp-lib.component';
+export * from './lib/components/table/table.component';
+export * from './lib/services/table.service';
+export * from './lib/types/Table';

package/CHANGELOG.md

@@ -1,88 +0,0 @@
-# Changelog
-
-Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
-
-O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/1.0.0/),
-e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR/).
-
-## [Unreleased]
-
-## [0.0.1] - 2024-11-03
-
-### Adicionado
-- ✨ Componente principal de tabela (`TableComponent`)
-- 🔥 Integração completa com Firebase Firestore
-- 📊 Sistema de paginação avançado (client-side e server-side)
-- 🔍 Sistema de filtros:
-  - Filtro por texto
-  - Filtro por data
-  - Filtro por igualdade (equals)
-  - Filtros personalizados com dropdown
-  - Função de filtro customizada (filterFn)
-- ⚡ Fallback automático client-side quando índices compostos não existem
-- 📈 Rastreamento automático de índices ausentes
-- 🔗 Suporte a relações entre collections
-- 🖼️ Suporte a exibição de imagens
-- 🎯 Botões de ação customizáveis
-- 📥 Sistema de exportação de dados
-- 🎨 Interface Material Design responsiva
-- 📝 Suporte a valores calculados
-- 🔢 Suporte a arrays e propriedades aninhadas
-- 💬 Tooltips para valores longos com charLimit
-- 🎨 Customização de cores e estilos
-- 📑 Sistema de tabs
-- 🔄 Método público `reloadTable()` para atualização manual
-- 📊 Query lengths para contar documentos relacionados
-
-### Serviços
-- `TableService` com métodos:
-  - `getPaginated()` - Paginação otimizada
-  - `getItems()` - Buscar todos os itens
-  - `getItemsData()` - Buscar itens com filtros
-  - `executeClientSideQuery()` - Fallback client-side
-  - `deleteIndex()` - Deletar com reindexação
-  - `dateFormatValidator()` - Validador de data
-  - `operators` - Operadores de comparação
-
-### Tipos
-- `TableData` - Interface principal de configuração
-- `Column` - Interface de configuração de colunas
-- `Arrange` - Interface de arranjo (filtros e ordenação)
-- `Condition` - Interface de condições where
-- `Pagination` - Interface de paginação
-- `FilterableOption` - Interface de opções filtráveis
-- `Tab` e `TabData` - Interfaces para tabs
-- `Image` - Interface para imagens
-
-### Documentação
-- README.md completo com exemplos
-- USAGE_EXAMPLE.md com casos de uso detalhados
-- BUILD.md com guia de publicação
-- CHANGELOG.md
-
-### Dependências Peer
-- @angular/common ^15.0.0
-- @angular/core ^15.0.0
-- @angular/forms ^15.0.0
-- @angular/router ^15.0.0
-- @angular/material ^15.0.0
-- @angular/cdk ^15.0.0
-- @angular/fire ^7.0.0
-- firebase ^9.0.0
-- ngx-toastr ^16.0.0
-- moment ^2.29.0
-- ngx-mask ^15.0.0
-
-## Tipos de Mudanças
-
-- `Added` - para novas funcionalidades
-- `Changed` - para mudanças em funcionalidades existentes
-- `Deprecated` - para funcionalidades que serão removidas
-- `Removed` - para funcionalidades removidas
-- `Fixed` - para correção de bugs
-- `Security` - para vulnerabilidades de segurança
-
-[Unreleased]: https://github.com/adryanmmm/firebase-table-kxp-lib/compare/v0.0.1...HEAD
-[0.0.1]: https://github.com/adryanmmm/firebase-table-kxp-lib/releases/tag/v0.0.1
-
-

package/ng-package.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json",
-  "dest": "../../dist/ng-firebase-table-kxp",
-  "lib": {
-    "entryFile": "src/public-api.ts"
-  }
-}