mintly-lib 2.14.0-preview → 2.16.0-preview

package/build/clients/dashboard-client.d.ts

@@ -0,0 +1,13 @@
+import { ResponseDto } from '../core';
+import type { Headers } from '../core/data/request/headers';
+import type { OverviewQuery, OverviewReport } from '../core/data/reports/overview-response';
+/**
+ * Visão Geral (fatia 8) — rota própria em /dashboard. Só GET; compõe o
+ * HttpBaseClient pela conexão, como o ReportClient.
+ */
+export declare class DashboardClient {
+    private readonly http;
+    /** Cards, score de saúde, "O que fazer primeiro", Receita × Despesa e cascata do lucro. */
+    overview(query: OverviewQuery, headers: Headers): Promise<ResponseDto<OverviewReport>>;
+}
+//# sourceMappingURL=dashboard-client.d.ts.map

package/build/clients/dashboard-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-client.d.ts","sourceRoot":"","sources":["../../src/clients/dashboard-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,SAAS,CAAA;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAE3F;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkD;IAEvE,2FAA2F;IACrF,QAAQ,CAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CAI9F"}

package/build/clients/dashboard-client.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardClient = void 0;
+const core_1 = require("../core");
+const http_base_client_1 = require("../core/client/http-base-client");
+/**
+ * Visão Geral (fatia 8) — rota própria em /dashboard. Só GET; compõe o
+ * HttpBaseClient pela conexão, como o ReportClient.
+ */
+class DashboardClient {
+    constructor() {
+        this.http = new http_base_client_1.HttpBaseClient('dashboard');
+    }
+    /** Cards, score de saúde, "O que fazer primeiro", Receita × Despesa e cascata do lucro. */
+    async overview(query, headers) {
+        const response = await this.http.connection.get('/overview', (0, core_1.withHeaders)(headers, { params: query }));
+        return response.data;
+    }
+}
+exports.DashboardClient = DashboardClient;
+//# sourceMappingURL=dashboard-client.js.map

package/build/clients/dashboard-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-client.js","sourceRoot":"","sources":["../../src/clients/dashboard-client.ts"],"names":[],"mappings":";;;AAAA,kCAAkD;AAClD,sEAAgE;AAIhE;;;GAGG;AACH,MAAa,eAAe;IAA5B;QACmB,SAAI,GAAG,IAAI,iCAAc,CAAiB,WAAW,CAAC,CAAA;IAOzE,CAAC;IALC,2FAA2F;IAC3F,KAAK,CAAC,QAAQ,CAAE,KAAoB,EAAE,OAAgB;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAA8B,WAAW,EAAE,IAAA,kBAAW,EAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QAClI,OAAO,QAAQ,CAAC,IAAI,CAAA;IACtB,CAAC;CACF;AARD,0CAQC"}

package/build/clients/index.d.ts

@@ -5,4 +5,5 @@ export { FinancialAccountClient } from './financial-account-client';
 export { FinancialCategoryClient } from './financial-category-client';
 export { FinancialMovementClient } from './financial-movement-client';
 export { ReportClient } from './report-client';
+export { DashboardClient } from './dashboard-client';
 //# sourceMappingURL=index.d.ts.map

package/build/clients/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}

package/build/clients/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReportClient = exports.FinancialMovementClient = exports.FinancialCategoryClient = exports.FinancialAccountClient = exports.RestaurantClient = exports.PersonClient = exports.AuthClient = void 0;
+exports.DashboardClient = exports.ReportClient = exports.FinancialMovementClient = exports.FinancialCategoryClient = exports.FinancialAccountClient = exports.RestaurantClient = exports.PersonClient = exports.AuthClient = void 0;
 var auth_client_1 = require("./auth-client");
 Object.defineProperty(exports, "AuthClient", { enumerable: true, get: function () { return auth_client_1.AuthClient; } });
 var person_client_1 = require("./person-client");
@@ -15,4 +15,6 @@ var financial_movement_client_1 = require("./financial-movement-client");
 Object.defineProperty(exports, "FinancialMovementClient", { enumerable: true, get: function () { return financial_movement_client_1.FinancialMovementClient; } });
 var report_client_1 = require("./report-client");
 Object.defineProperty(exports, "ReportClient", { enumerable: true, get: function () { return report_client_1.ReportClient; } });
+var dashboard_client_1 = require("./dashboard-client");
+Object.defineProperty(exports, "DashboardClient", { enumerable: true, get: function () { return dashboard_client_1.DashboardClient; } });
 //# sourceMappingURL=index.js.map

package/build/clients/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAAjC,yGAAA,UAAU,OAAA;AACnB,iDAA8C;AAArC,6GAAA,YAAY,OAAA;AACrB,yDAAsD;AAA7C,qHAAA,gBAAgB,OAAA;AACzB,uEAAmE;AAA1D,kIAAA,sBAAsB,OAAA;AAC/B,yEAAqE;AAA5D,oIAAA,uBAAuB,OAAA;AAChC,yEAAqE;AAA5D,oIAAA,uBAAuB,OAAA;AAChC,iDAA8C;AAArC,6GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAAjC,yGAAA,UAAU,OAAA;AACnB,iDAA8C;AAArC,6GAAA,YAAY,OAAA;AACrB,yDAAsD;AAA7C,qHAAA,gBAAgB,OAAA;AACzB,uEAAmE;AAA1D,kIAAA,sBAAsB,OAAA;AAC/B,yEAAqE;AAA5D,oIAAA,uBAAuB,OAAA;AAChC,yEAAqE;AAA5D,oIAAA,uBAAuB,OAAA;AAChC,iDAA8C;AAArC,6GAAA,YAAY,OAAA;AACrB,uDAAoD;AAA3C,mHAAA,eAAe,OAAA"}

package/build/core/client/master-client.d.ts

@@ -1,4 +1,4 @@
-import { AuthClient, PersonClient, RestaurantClient, FinancialAccountClient, FinancialCategoryClient, FinancialMovementClient, ReportClient } from '../../clients';
+import { AuthClient, PersonClient, RestaurantClient, FinancialAccountClient, FinancialCategoryClient, FinancialMovementClient, ReportClient, DashboardClient } from '../../clients';
 export declare class MasterClient {
     authClient: AuthClient;
     personClient: PersonClient;
@@ -7,6 +7,7 @@ export declare class MasterClient {
     financialCategoryClient: FinancialCategoryClient;
     financialMovementClient: FinancialMovementClient;
     reportClient: ReportClient;
+    dashboardClient: DashboardClient;
     constructor();
 }
 //# sourceMappingURL=master-client.d.ts.map

package/build/core/client/master-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"master-client.d.ts","sourceRoot":"","sources":["../../../src/core/client/master-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACb,MAAM,eAAe,CAAA;AAEtB,qBAAa,YAAY;IACvB,UAAU,EAAE,UAAU,CAAA;IACtB,YAAY,EAAE,YAAY,CAAA;IAC1B,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,sBAAsB,EAAE,sBAAsB,CAAA;IAC9C,uBAAuB,EAAE,uBAAuB,CAAA;IAChD,uBAAuB,EAAE,uBAAuB,CAAA;IAChD,YAAY,EAAE,YAAY,CAAA;;CAW3B"}
+{"version":3,"file":"master-client.d.ts","sourceRoot":"","sources":["../../../src/core/client/master-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,eAAe,EAChB,MAAM,eAAe,CAAA;AAEtB,qBAAa,YAAY;IACvB,UAAU,EAAE,UAAU,CAAA;IACtB,YAAY,EAAE,YAAY,CAAA;IAC1B,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,sBAAsB,EAAE,sBAAsB,CAAA;IAC9C,uBAAuB,EAAE,uBAAuB,CAAA;IAChD,uBAAuB,EAAE,uBAAuB,CAAA;IAChD,YAAY,EAAE,YAAY,CAAA;IAC1B,eAAe,EAAE,eAAe,CAAA;;CAYjC"}

package/build/core/client/master-client.js

@@ -11,6 +11,7 @@ class MasterClient {
         this.financialCategoryClient = new clients_1.FinancialCategoryClient();
         this.financialMovementClient = new clients_1.FinancialMovementClient();
         this.reportClient = new clients_1.ReportClient();
+        this.dashboardClient = new clients_1.DashboardClient();
     }
 }
 exports.MasterClient = MasterClient;

package/build/core/client/master-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"master-client.js","sourceRoot":"","sources":["../../../src/core/client/master-client.ts"],"names":[],"mappings":";;;AAAA,2CAQsB;AAEtB,MAAa,YAAY;IASvB;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,oBAAU,EAAE,CAAA;QAClC,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAY,EAAE,CAAA;QACtC,IAAI,CAAC,gBAAgB,GAAG,IAAI,0BAAgB,EAAE,CAAA;QAC9C,IAAI,CAAC,sBAAsB,GAAG,IAAI,gCAAsB,EAAE,CAAA;QAC1D,IAAI,CAAC,uBAAuB,GAAG,IAAI,iCAAuB,EAAE,CAAA;QAC5D,IAAI,CAAC,uBAAuB,GAAG,IAAI,iCAAuB,EAAE,CAAA;QAC5D,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAY,EAAE,CAAA;IACxC,CAAC;CACF;AAlBD,oCAkBC"}
+{"version":3,"file":"master-client.js","sourceRoot":"","sources":["../../../src/core/client/master-client.ts"],"names":[],"mappings":";;;AAAA,2CASsB;AAEtB,MAAa,YAAY;IAUvB;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,oBAAU,EAAE,CAAA;QAClC,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAY,EAAE,CAAA;QACtC,IAAI,CAAC,gBAAgB,GAAG,IAAI,0BAAgB,EAAE,CAAA;QAC9C,IAAI,CAAC,sBAAsB,GAAG,IAAI,gCAAsB,EAAE,CAAA;QAC1D,IAAI,CAAC,uBAAuB,GAAG,IAAI,iCAAuB,EAAE,CAAA;QAC5D,IAAI,CAAC,uBAAuB,GAAG,IAAI,iCAAuB,EAAE,CAAA;QAC5D,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAY,EAAE,CAAA;QACtC,IAAI,CAAC,eAAe,GAAG,IAAI,yBAAe,EAAE,CAAA;IAC9C,CAAC;CACF;AApBD,oCAoBC"}

package/build/core/data/reports/expenses-response.d.ts

@@ -11,6 +11,19 @@ export interface ExpensesQuery {
     channel?: MovementChannel.DineIn | MovementChannel.Delivery;
 }
 export type ExpenseItemKind = 'category' | 'platformFee';
+/** Subitem de uma categoria (fatia 7): uma subcategoria, ou "Sem subitem" (`key: 'none'`). */
+export interface ExpenseSubitem {
+    key: string;
+    subcategoryId: string | null;
+    /** Nome atual da subcategoria (mesmo inativa); "Sem subitem". */
+    name: string;
+    amount: number;
+    previous: number;
+    average3: number | null;
+    deltaPrevious: number | null;
+    deltaAverage3: number | null;
+    anomaly: boolean;
+}
 /** Linha de "Para onde está indo seu dinheiro": categoria ou taxa de uma conta de plataforma. */
 export interface ExpenseItem {
     /** categoryId, ou `platformFee:<accountId>`. */
@@ -27,6 +40,17 @@ export interface ExpenseItem {
     deltaPrevious: number | null;
     deltaAverage3: number | null;
     pctOfRevenue: number | null;
+    /** [] quando a categoria não tem lançamento com subcategoria na janela; taxa → []. */
+    subitems: ExpenseSubitem[];
+    /** Selo "alerta": a categoria inteira ou algum subitem dela é atípico no mês. */
+    hasAnomaly: boolean;
+    /** 6 meses, do mais antigo ao mês de referência (gráfico "Por categoria"). */
+    history: {
+        month: string;
+        amount: number;
+    }[];
+    /** Projeção do mês atual; null em mês fechado. */
+    projected: number | null;
 }
 export interface ExpensesTotal {
     current: number;
@@ -41,8 +65,38 @@ export interface ExpensesPlatformFee {
     deltaPrevious: number | null;
     /** Σ receita bruta de canal efetivo delivery no mês. */
     deliveryRevenue: number;
+    /** Taxa / Σ receita bruta das contas de plataforma (a taxa e a venda que a gerou no mesmo denominador). */
     pctOfDelivery: number | null;
 }
+/** Gasto atípico do mês ("Fique de olho"). Regra em `ExpensesReport.anomalyRule`. */
+export interface ExpenseAnomaly {
+    /** `ExpenseItem.key` da categoria. */
+    itemKey: string;
+    categoryId: string | null;
+    categoryName: string;
+    subcategoryId: string | null;
+    /** `ExpenseSubitem.key`; null = a categoria inteira foi avaliada (sem subitens). */
+    subitemKey: string | null;
+    name: string;
+    amount: number;
+    average3: number;
+    excess: number;
+    pctAbove: number;
+}
+/** Projeção linear do mês atual: total até hoje × daysInMonth / elapsedDays. */
+export interface ExpensesProjection {
+    total: number;
+    /** Receita bruta projetada pela mesma regra (fatia 8 — Visão Geral). */
+    revenue: number;
+    elapsedDays: number;
+    daysInMonth: number;
+}
+/** Critério de anomalia (N4 — palpite, ainda não validado pelo negócio). */
+export interface ExpensesAnomalyRule {
+    minPctAbove: number;
+    minExcess: number;
+    minHistoryMonths: number;
+}
 export interface ExpensesReport {
     referenceMonth: string;
     previousMonth: string;
@@ -82,5 +136,10 @@ export interface ExpensesReport {
         month: string;
         total: number;
     }[];
+    /** Maior excedente primeiro. Só o mês de referência. */
+    anomalies: ExpenseAnomaly[];
+    /** Só quando o mês de referência é o mês atual. */
+    projection: ExpensesProjection | null;
+    anomalyRule: ExpensesAnomalyRule;
 }
 //# sourceMappingURL=expenses-response.d.ts.map

package/build/core/data/reports/expenses-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expenses-response.d.ts","sourceRoot":"","sources":["../../../../src/core/data/reports/expenses-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAA;AACxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAE7E;;;;GAIG;AAEH,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,eAAe,CAAC,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAA;CAC5D;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,aAAa,CAAA;AAExD,iGAAiG;AACjG,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,eAAe,CAAA;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IAC/B,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,KAAK,EAAE,aAAa,CAAA;IACpB,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;IAC1F,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACzG,WAAW,EAAE,mBAAmB,CAAA;IAChC,8CAA8C;IAC9C,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,gFAAgF;IAChF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,oDAAoD;IACpD,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC5C"}
+{"version":3,"file":"expenses-response.d.ts","sourceRoot":"","sources":["../../../../src/core/data/reports/expenses-response.ts"],"names":[],"mappings":"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"}

package/build/core/data/reports/index.d.ts

@@ -1,4 +1,5 @@
 export * from './cash-flow-response';
 export * from './result-response';
 export * from './expenses-response';
+export * from './overview-response';
 //# sourceMappingURL=index.d.ts.map

package/build/core/data/reports/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/data/reports/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/data/reports/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA"}

package/build/core/data/reports/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./cash-flow-response"), exports);
 __exportStar(require("./result-response"), exports);
 __exportStar(require("./expenses-response"), exports);
+__exportStar(require("./overview-response"), exports);
 //# sourceMappingURL=index.js.map

package/build/core/data/reports/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/data/reports/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAoC;AACpC,oDAAiC;AACjC,sDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/data/reports/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAoC;AACpC,oDAAiC;AACjC,sDAAmC;AACnC,sDAAmC"}

package/build/core/data/reports/overview-response.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Contrato de GET /dashboard/overview (fatia 8). Composição dos relatórios do
+ * mês (DRE, Custos) e de hoje (Fluxo de Caixa). Frações como no resto
+ * (0.36 = 36%); `deltaPoints` em pontos percentuais (2.8 = +2,8 p.p.). Spec:
+ * MintlyApi/specs/modulos-novos/20261013/visao-geral.md.
+ */
+/** `month` em AAAA-MM (padrão: mês corrente). Os blocos de caixa são sempre de hoje. */
+export interface OverviewQuery {
+    month?: string;
+}
+export interface OverviewCards {
+    netProfit: {
+        amount: number;
+        delta: number | null;
+        history: {
+            month: string;
+            amount: number;
+        }[];
+    };
+    revenue: {
+        amount: number;
+        delta: number | null;
+        history: {
+            month: string;
+            amount: number;
+        }[];
+    };
+    cashToday: {
+        amount: number;
+        realized: {
+            date: string;
+            balance: number;
+        }[];
+    };
+    /** `runwayDays`: fôlego — caixa de hoje ÷ despesa média diária (dias inteiros). */
+    projection: {
+        horizon: number;
+        balance: number;
+        lowest: {
+            date: string;
+            balance: number;
+        };
+        runwayDays: number | null;
+    };
+    cmv: {
+        pct: number | null;
+        previousPct: number | null;
+        deltaPoints: number | null;
+        target: {
+            min: number;
+            max: number;
+        };
+    };
+    primeCost: {
+        pct: number | null;
+        previousPct: number | null;
+        deltaPoints: number | null;
+        targetMax: number;
+    };
+}
+export type HealthLabel = 'risk' | 'attention' | 'healthy' | 'noData';
+export type HealthPillarKey = 'netMargin' | 'runway' | 'primeCost' | 'revenueTrend';
+/** Pilar do score (N5 — palpite). `score` null = sem dado (fora da média). */
+export interface HealthPillar {
+    key: HealthPillarKey;
+    weight: number;
+    score: number | null;
+    value: number | null;
+}
+export interface OverviewHealth {
+    score: number | null;
+    label: HealthLabel;
+    /**
+     * Mês dos pilares do mês. Mês atual: o último mês fechado (+ fôlego de hoje).
+     * Mês passado: o próprio mês, sem o fôlego (pilar `runway` sem dado).
+     */
+    basisMonth: string;
+    pillars: HealthPillar[];
+    bands: {
+        risk: number;
+        attention: number;
+    };
+}
+export type OverviewInsight = {
+    kind: 'cashTight';
+    severity: 'warning';
+    date: string;
+    balance: number;
+} | {
+    kind: 'cmvAboveTarget';
+    severity: 'warning';
+    pct: number;
+    targetMax: number;
+    impact: number;
+} | {
+    kind: 'primeCostAboveTarget';
+    severity: 'warning';
+    pct: number;
+    targetMax: number;
+} | {
+    kind: 'expenseAnomaly';
+    severity: 'warning';
+    name: string;
+    categoryName: string;
+    excess: number;
+    pctAbove: number;
+} | {
+    kind: 'breakEvenReached';
+    severity: 'positive';
+    day: number;
+} | {
+    kind: 'taxRegimeNotConfigured';
+    severity: 'info';
+};
+export interface RevenueVsExpensePoint {
+    month: string;
+    revenue: number;
+    expense: number;
+    /** true = projeção linear do mês atual (o ponto real do mesmo mês vem antes). */
+    projected: boolean;
+}
+export interface ProfitWaterfall {
+    grossRevenue: number;
+    taxes: number;
+    cmv: number;
+    operatingExpenses: number;
+    netProfit: number;
+}
+export interface OverviewReport {
+    referenceMonth: string;
+    /** AAAA-MM-DD em SP — referência dos blocos de caixa. */
+    today: string;
+    cards: OverviewCards;
+    health: OverviewHealth;
+    /** No máximo 4: warning → positive → info. */
+    insights: OverviewInsight[];
+    revenueVsExpense: RevenueVsExpensePoint[];
+    profitWaterfall: ProfitWaterfall;
+}
+//# sourceMappingURL=overview-response.d.ts.map

package/build/core/data/reports/overview-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview-response.d.ts","sourceRoot":"","sources":["../../../../src/core/data/reports/overview-response.ts"],"names":[],"mappings":"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"}

package/build/core/data/reports/overview-response.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Contrato de GET /dashboard/overview (fatia 8). Composição dos relatórios do
+ * mês (DRE, Custos) e de hoje (Fluxo de Caixa). Frações como no resto
+ * (0.36 = 36%); `deltaPoints` em pontos percentuais (2.8 = +2,8 p.p.). Spec:
+ * MintlyApi/specs/modulos-novos/20261013/visao-geral.md.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=overview-response.js.map

package/build/core/data/reports/overview-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview-response.js","sourceRoot":"","sources":["../../../../src/core/data/reports/overview-response.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mintly-lib",
-  "version": "2.14.0-preview",
+  "version": "2.16.0-preview",
   "description": "Mintly Library",
   "main": "build/index.js",
   "types": "build/index.d.ts",