@ikxvxn/databi-sharedtypes 0.0.42

package/dist/externalDb.d.ts

@@ -0,0 +1,57 @@
+import { Document } from 'mongoose';
+export declare enum DataSourceStatusEnum {
+    inactive = 0,
+    active = 1,
+    syncing = 2,
+    error = 3,
+    incomplete = 4,
+    unknown = 5
+}
+export type DataSourceStatus = keyof typeof DataSourceStatusEnum;
+export declare enum SyncModeEnum {
+    inactive = 0,
+    manual = 1,
+    automatic = 2
+}
+export type SyncMode = keyof typeof SyncModeEnum;
+export declare enum AutomaticSyncModeEnum {
+    daily = 0,
+    weekly = 1,
+    monthly = 2
+}
+export type AutomaticSyncMode = keyof typeof AutomaticSyncModeEnum;
+export declare enum TypeOfOriginEnum {
+    quickbooks_desktop = 0
+}
+export type TypeOfOrigin = keyof typeof TypeOfOriginEnum;
+export interface ExternalDbShared {
+    name: string;
+    typeOfOrigin: TypeOfOrigin;
+    endpointUrl: string;
+    auth: any;
+    tables: ITable[];
+    status?: DataSourceStatus;
+    syncMode?: SyncMode;
+    automaticSyncMode?: AutomaticSyncMode;
+    createdAt?: Date | string;
+}
+export interface IParam {
+    name: string;
+    alias?: string;
+    type: string;
+    sourceRef?: string;
+    isKey?: boolean;
+}
+export interface ITable {
+    name: string;
+    alias?: string;
+    params?: IParam[];
+    lastSync?: Date | string;
+    initiallySynced: boolean;
+    progressiveSyncField?: string;
+}
+export interface IExternalDb extends ExternalDbShared, Document {
+}
+export interface IExternalDbClient extends ExternalDbShared {
+    id: string;
+}

package/dist/externalDb.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeOfOriginEnum = exports.AutomaticSyncModeEnum = exports.SyncModeEnum = exports.DataSourceStatusEnum = void 0;
+var DataSourceStatusEnum;
+(function (DataSourceStatusEnum) {
+    DataSourceStatusEnum[DataSourceStatusEnum["inactive"] = 0] = "inactive";
+    DataSourceStatusEnum[DataSourceStatusEnum["active"] = 1] = "active";
+    DataSourceStatusEnum[DataSourceStatusEnum["syncing"] = 2] = "syncing";
+    DataSourceStatusEnum[DataSourceStatusEnum["error"] = 3] = "error";
+    DataSourceStatusEnum[DataSourceStatusEnum["incomplete"] = 4] = "incomplete";
+    DataSourceStatusEnum[DataSourceStatusEnum["unknown"] = 5] = "unknown";
+})(DataSourceStatusEnum || (exports.DataSourceStatusEnum = DataSourceStatusEnum = {}));
+var SyncModeEnum;
+(function (SyncModeEnum) {
+    SyncModeEnum[SyncModeEnum["inactive"] = 0] = "inactive";
+    SyncModeEnum[SyncModeEnum["manual"] = 1] = "manual";
+    SyncModeEnum[SyncModeEnum["automatic"] = 2] = "automatic";
+})(SyncModeEnum || (exports.SyncModeEnum = SyncModeEnum = {}));
+var AutomaticSyncModeEnum;
+(function (AutomaticSyncModeEnum) {
+    AutomaticSyncModeEnum[AutomaticSyncModeEnum["daily"] = 0] = "daily";
+    AutomaticSyncModeEnum[AutomaticSyncModeEnum["weekly"] = 1] = "weekly";
+    AutomaticSyncModeEnum[AutomaticSyncModeEnum["monthly"] = 2] = "monthly";
+})(AutomaticSyncModeEnum || (exports.AutomaticSyncModeEnum = AutomaticSyncModeEnum = {}));
+// Enum para origen de datos
+var TypeOfOriginEnum;
+(function (TypeOfOriginEnum) {
+    TypeOfOriginEnum[TypeOfOriginEnum["quickbooks_desktop"] = 0] = "quickbooks_desktop";
+})(TypeOfOriginEnum || (exports.TypeOfOriginEnum = TypeOfOriginEnum = {}));

package/dist/geographic.d.ts

@@ -0,0 +1,14 @@
+export interface IDistrito {
+    idDistrito: number;
+    idCanton: number;
+    nombre: string;
+}
+export interface ICanton {
+    idCanton: number;
+    idProvincia: number;
+    nombre: string;
+}
+export interface IProvincia {
+    idProvincia: number;
+    nombre: string;
+}

package/dist/geographic.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './company';
+export * from './externalDb';
+export * from './queryResult';
+export * from './pagination';
+export * from './defaultTablesByExternalDb';
+export * from './auth';
+export * from './geographic';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./company"), exports);
+__exportStar(require("./externalDb"), exports);
+__exportStar(require("./queryResult"), exports);
+__exportStar(require("./pagination"), exports);
+__exportStar(require("./defaultTablesByExternalDb"), exports);
+__exportStar(require("./auth"), exports);
+__exportStar(require("./geographic"), exports);

package/dist/metabase.d.ts

@@ -0,0 +1,53 @@
+import type { IPaginationInfo } from './pagination';
+/** Tipos de visualización disponibles en Metabase */
+export type MetabaseDisplayType = 'table' | 'bar' | 'line' | 'pie' | 'scalar' | 'row' | 'area' | 'combo' | 'pivot' | 'funnel' | 'scatter' | 'waterfall' | 'map';
+/** Referencia a una pregunta/chart de Metabase */
+export interface IMetabaseQuestion {
+    id: number;
+    name: string;
+    description?: string;
+    display: MetabaseDisplayType;
+    databaseId: number;
+    tableId?: number;
+}
+/** Configuración de embed firmado */
+export interface IMetabaseEmbedPayload {
+    embedUrl: string;
+    expiresAt: number;
+}
+/** Resumen de base de datos en Metabase */
+export interface IMetabaseDatabaseRef {
+    id: number;
+    name: string;
+    engine: string;
+}
+/** Respuesta al listar visualizaciones disponibles para una BD */
+export interface IVisualizationListResponse {
+    questions: IMetabaseQuestion[];
+    metabaseDatabaseId: number | null;
+}
+/** URL de exploración para abrir Metabase query builder */
+export interface IMetabaseExploreResponse {
+    url: string;
+    metabaseDatabaseId: number | null;
+}
+/** Categorías de análisis para agrupar visualizaciones */
+export type AnalysisCategory = 'all' | 'counts' | 'charts' | 'distribution' | 'trends';
+/** Tipos de display que representan datos crudos (excluidos de análisis) */
+export declare const NON_ANALYSIS_DISPLAY_TYPES: MetabaseDisplayType[];
+/** Mapeo de categoría de análisis → tipos de display de Metabase */
+export declare const ANALYSIS_CATEGORY_DISPLAY_MAP: Record<Exclude<AnalysisCategory, 'all'>, MetabaseDisplayType[]>;
+/** Tamaño de página por defecto para visualizaciones de análisis (2×2 grid) */
+export declare const DEFAULT_ANALYSIS_PAGE_SIZE = 4;
+/** Opciones de consulta para listar visualizaciones */
+export interface IVisualizationQueryOptions {
+    page?: number;
+    limit?: number;
+    category?: AnalysisCategory;
+}
+/** Respuesta paginada de visualizaciones/análisis */
+export interface IPaginatedVisualizationResponse {
+    questions: IMetabaseQuestion[];
+    pagination: IPaginationInfo;
+    metabaseDatabaseId: number | null;
+}

package/dist/metabase.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ANALYSIS_PAGE_SIZE = exports.ANALYSIS_CATEGORY_DISPLAY_MAP = exports.NON_ANALYSIS_DISPLAY_TYPES = void 0;
+/** Tipos de display que representan datos crudos (excluidos de análisis) */
+exports.NON_ANALYSIS_DISPLAY_TYPES = ['table'];
+/** Mapeo de categoría de análisis → tipos de display de Metabase */
+exports.ANALYSIS_CATEGORY_DISPLAY_MAP = {
+    counts: ['scalar', 'row'],
+    charts: ['bar', 'combo', 'waterfall'],
+    distribution: ['pie', 'funnel'],
+    trends: ['line', 'area', 'scatter'],
+};
+/** Tamaño de página por defecto para visualizaciones de análisis (2×2 grid) */
+exports.DEFAULT_ANALYSIS_PAGE_SIZE = 4;

package/dist/pagination.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Interfaces para paginación de consultas de datos
+ */
+/** Máximo de documentos por página permitido */
+export declare const MAX_PAGE_SIZE = 100;
+/** Tamaño de página por defecto */
+export declare const DEFAULT_PAGE_SIZE = 20;
+export interface IPaginatedRequest {
+    page?: number;
+    limit?: number;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+    search?: string;
+}
+export interface IPaginationInfo {
+    page: number;
+    limit: number;
+    totalItems: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+}
+export interface IPaginatedResponse<T> {
+    data: T[];
+    pagination: IPaginationInfo;
+}
+/**
+ * Parámetros para solicitar datos paginados de una tabla.
+ * Usado tanto por el cliente (al enviar la request) como por el servidor (al recibirla).
+ */
+export interface ITableDataRequest extends IPaginatedRequest {
+    externalDbId: string;
+    tableName: string;
+    searchColumns?: string[];
+}

package/dist/pagination.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Interfaces para paginación de consultas de datos
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PAGE_SIZE = exports.MAX_PAGE_SIZE = void 0;
+/** Máximo de documentos por página permitido */
+exports.MAX_PAGE_SIZE = 100;
+/** Tamaño de página por defecto */
+exports.DEFAULT_PAGE_SIZE = 20;

package/dist/queryResult.d.ts

@@ -0,0 +1,7 @@
+import type { IExternalDb } from './externalDb.js';
+export interface IQueryResult {
+    data: Record<string, unknown>[];
+    db: IExternalDb;
+    sql: string;
+    nextPageToken: string | undefined;
+}

package/dist/queryResult.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@ikxvxn/databi-sharedtypes",
+  "version": "0.0.42",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "release": "npm install && npm run build && npm version patch && npm publish"
+  },
+  "devDependencies": {
+    "@types/mongoose": "^5.11.96",
+    "@types/node": "^24.10.2",
+    "mongoose": "^9.0.1",
+    "typescript": "^5.9.3"
+  }
+}