mintly-lib 2.11.0-preview → 2.12.0-preview

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

@@ -1,6 +1,7 @@
 import { ResponseDto } from '../core';
 import type { Headers } from '../core/data/request/headers';
 import type { CashFlowQuery, CashFlowReport } from '../core/data/reports/cash-flow-response';
+import type { ResultQuery, ResultReport } from '../core/data/reports/result-response';
 /**
  * Relatórios de leitura (módulos novos). Só GETs próprios — compõe o
  * HttpBaseClient pela conexão, como o FinancialMovementClient. As próximas
@@ -10,5 +11,7 @@ export declare class ReportClient {
     private readonly http;
     /** Fluxo de Caixa: caixa hoje, projeção no horizonte, vencimentos e dia crítico. */
     cashFlow(query: CashFlowQuery, headers: Headers): Promise<ResponseDto<CashFlowReport>>;
+    /** Resultado (DRE) do mês: linhas, composição, ponto de equilíbrio, histórico e insights. */
+    result(query: ResultQuery, headers: Headers): Promise<ResponseDto<ResultReport>>;
 }
 //# sourceMappingURL=report-client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"report-client.d.ts","sourceRoot":"","sources":["../../src/clients/report-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,yCAAyC,CAAA;AAE5F;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgD;IAErE,oFAAoF;IAC9E,QAAQ,CAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;CAI9F"}
+{"version":3,"file":"report-client.d.ts","sourceRoot":"","sources":["../../src/clients/report-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,yCAAyC,CAAA;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAErF;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgD;IAErE,oFAAoF;IAC9E,QAAQ,CAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAK7F,6FAA6F;IACvF,MAAM,CAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;CAIxF"}

package/build/clients/report-client.js

@@ -17,6 +17,11 @@ class ReportClient {
         const response = await this.http.connection.get('/cash-flow', (0, core_1.withHeaders)(headers, { params: query }));
         return response.data;
     }
+    /** Resultado (DRE) do mês: linhas, composição, ponto de equilíbrio, histórico e insights. */
+    async result(query, headers) {
+        const response = await this.http.connection.get('/result', (0, core_1.withHeaders)(headers, { params: query }));
+        return response.data;
+    }
 }
 exports.ReportClient = ReportClient;
 //# sourceMappingURL=report-client.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"report-client.js","sourceRoot":"","sources":["../../src/clients/report-client.ts"],"names":[],"mappings":";;;AAAA,kCAAkD;AAClD,sEAAgE;AAIhE;;;;GAIG;AACH,MAAa,YAAY;IAAzB;QACmB,SAAI,GAAG,IAAI,iCAAc,CAAiB,SAAS,CAAC,CAAA;IAOvE,CAAC;IALC,oFAAoF;IACpF,KAAK,CAAC,QAAQ,CAAE,KAAoB,EAAE,OAAgB;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAA8B,YAAY,EAAE,IAAA,kBAAW,EAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QACnI,OAAO,QAAQ,CAAC,IAAI,CAAA;IACtB,CAAC;CACF;AARD,oCAQC"}
+{"version":3,"file":"report-client.js","sourceRoot":"","sources":["../../src/clients/report-client.ts"],"names":[],"mappings":";;;AAAA,kCAAkD;AAClD,sEAAgE;AAKhE;;;;GAIG;AACH,MAAa,YAAY;IAAzB;QACmB,SAAI,GAAG,IAAI,iCAAc,CAAiB,SAAS,CAAC,CAAA;IAavE,CAAC;IAXC,oFAAoF;IACpF,KAAK,CAAC,QAAQ,CAAE,KAAoB,EAAE,OAAgB;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAA8B,YAAY,EAAE,IAAA,kBAAW,EAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QACnI,OAAO,QAAQ,CAAC,IAAI,CAAA;IACtB,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,MAAM,CAAE,KAAkB,EAAE,OAAgB;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAA4B,SAAS,EAAE,IAAA,kBAAW,EAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QAC9H,OAAO,QAAQ,CAAC,IAAI,CAAA;IACtB,CAAC;CACF;AAdD,oCAcC"}

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

@@ -1,2 +1,3 @@
 export * from './cash-flow-response';
+export * from './result-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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/data/reports/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA"}

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

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./cash-flow-response"), exports);
+__exportStar(require("./result-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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/data/reports/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAoC;AACpC,oDAAiC"}

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

@@ -0,0 +1,83 @@
+import type { CategoryBehavior } from '../financial/financial-category-schema';
+import type { TaxRegime } from '../restaurant/restaurant-schema';
+/**
+ * Contrato de GET /reports/result (fatia 4). DRE simplificado por competência.
+ * Número cru; taxas e margens como fração (0.109 = 10,9%). Spec:
+ * MintlyApi/specs/modulos-novos/20261012/resultado-dre.md.
+ */
+/** `month` em AAAA-MM; padrão o mês corrente no servidor. */
+export interface ResultQuery {
+    month?: string;
+}
+export interface ResultLines {
+    grossRevenue: number;
+    taxes: number;
+    netRevenue: number;
+    cmv: number;
+    grossMargin: number;
+    operatingExpenses: number;
+    netProfit: number;
+    netMargin: number | null;
+}
+export type ResultLineKey = Exclude<keyof ResultLines, 'netMargin'>;
+/** Item da composição das despesas operacionais (categoria ou a taxa de plataforma). */
+export interface OpexItem {
+    categoryId: string | null;
+    name: string;
+    kind: 'labor' | 'opex' | 'platformFee';
+    behavior: CategoryBehavior;
+    amount: number;
+    previousAmount: number;
+    delta: number | null;
+    revenuePct: number | null;
+}
+export type ResultInsight = {
+    kind: 'profitChanged';
+    severity: 'positive' | 'warning';
+    difference: number;
+    previousProfit: number;
+    currentProfit: number;
+    previousMargin: number | null;
+    currentMargin: number | null;
+} | {
+    kind: 'largestOpexItem';
+    severity: 'warning';
+    name: string;
+    amount: number;
+    revenuePct: number | null;
+} | {
+    kind: 'taxRegimeNotConfigured';
+    severity: 'info';
+};
+export interface ResultBreakEven {
+    fixedCosts: number;
+    variableCosts: number;
+    /** Sobre a receita líquida: (líquida − variáveis) / líquida. */
+    contributionMarginPct: number | null;
+    /** Receita BRUTA do mês que paga os custos fixos — o que o dono compara com o que vende. */
+    breakEvenRevenue: number | null;
+    reachedOnDay: number | null;
+}
+export interface ResultHistoryPoint {
+    month: string;
+    grossRevenue: number;
+    netProfit: number;
+    netMargin: number | null;
+}
+export interface ResultReport {
+    referenceMonth: string;
+    previousMonth: string;
+    current: ResultLines;
+    previous: ResultLines;
+    deltas: Record<ResultLineKey, number | null>;
+    tax: {
+        regime: TaxRegime | null;
+        effectiveRate: number | null;
+        meiMonthlyDas: number | null;
+    };
+    operatingExpenseItems: OpexItem[];
+    breakEven: ResultBreakEven;
+    history: ResultHistoryPoint[];
+    insights: ResultInsight[];
+}
+//# sourceMappingURL=result-response.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=result-response.js.map

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

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

package/package.json

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