tychat-contracts 1.6.28 → 1.6.30

package/dist/billing/billing-line-item.dto.d.ts

@@ -0,0 +1,8 @@
+export declare class BillingLineItemDto {
+    code: string;
+    label: string;
+    amount: number;
+    quantity?: number;
+    unitAmount?: number;
+}
+//# sourceMappingURL=billing-line-item.dto.d.ts.map

package/dist/billing/billing-line-item.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-line-item.dto.d.ts","sourceRoot":"","sources":["../../src/billing/billing-line-item.dto.ts"],"names":[],"mappings":"AAUA,qBAAa,kBAAkB;IAO7B,IAAI,EAAE,MAAM,CAAC;IAQb,KAAK,EAAE,MAAM,CAAC;IAUd,MAAM,EAAE,MAAM,CAAC;IAUf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAUlB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/billing/billing-line-item.dto.js

@@ -0,0 +1,74 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingLineItemDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+class BillingLineItemDto {
+    code;
+    label;
+    amount;
+    quantity;
+    unitAmount;
+}
+exports.BillingLineItemDto = BillingLineItemDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Código estável da linha (ex.: PLAN_BASE, EXTRA_PATIENTS)',
+        example: 'PLAN_BASE',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], BillingLineItemDto.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Rótulo exibido (snapshot em PT-BR na emissão)',
+        example: 'Plano',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(256),
+    __metadata("design:type", String)
+], BillingLineItemDto.prototype, "label", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Valor da linha (moeda do tenant / BRL)',
+        example: 99.9,
+        minimum: 0,
+    }),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Number)
+], BillingLineItemDto.prototype, "amount", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Quantidade (ex.: pacientes adicionais)',
+        example: 5,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Number)
+], BillingLineItemDto.prototype, "quantity", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Valor unitário',
+        example: 10,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Number)
+], BillingLineItemDto.prototype, "unitAmount", void 0);

package/dist/billing/billing-response.dto.d.ts

@@ -1,8 +1,12 @@
-import { BillingStatusDto } from './create-billing.dto';
+import { BillingLineItemDto } from './billing-line-item.dto';
+import { BillingKindDto, BillingStatusDto } from './create-billing.dto';
 export declare class BillingResponseDto {
     id: string;
     tenantId: string;
+    kind: BillingKindDto;
+    referenceId?: string | null;
     value: number;
+    lineItems?: BillingLineItemDto[] | null;
     status: BillingStatusDto;
     paymentId?: string | null;
     dueDate: string;

package/dist/billing/billing-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing-response.dto.d.ts","sourceRoot":"","sources":["../../src/billing/billing-response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,kBAAkB;IAK7B,EAAE,EAAE,MAAM,CAAC;IAMX,QAAQ,EAAE,MAAM,CAAC;IAMjB,KAAK,EAAE,MAAM,CAAC;IAOd,MAAM,EAAE,gBAAgB,CAAC;IAMzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM1B,OAAO,EAAE,MAAM,CAAC;IAMhB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMxB,SAAS,EAAE,MAAM,CAAC;IAMlB,SAAS,EAAE,MAAM,CAAC;IAMlB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}
+{"version":3,"file":"billing-response.dto.d.ts","sourceRoot":"","sources":["../../src/billing/billing-response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAGL,cAAc,EACd,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,kBAAkB;IAK7B,EAAE,EAAE,MAAM,CAAC;IAMX,QAAQ,EAAE,MAAM,CAAC;IAOjB,IAAI,EAAE,cAAc,CAAC;IAOrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM5B,KAAK,EAAE,MAAM,CAAC;IAOd,SAAS,CAAC,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAOxC,MAAM,EAAE,gBAAgB,CAAC;IAMzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM1B,OAAO,EAAE,MAAM,CAAC;IAMhB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMxB,SAAS,EAAE,MAAM,CAAC;IAMlB,SAAS,EAAE,MAAM,CAAC;IAMlB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/billing/billing-response.dto.js

@@ -11,11 +11,15 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BillingResponseDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
+const billing_line_item_dto_1 = require("./billing-line-item.dto");
 const create_billing_dto_1 = require("./create-billing.dto");
 class BillingResponseDto {
     id;
     tenantId;
+    kind;
+    referenceId;
     value;
+    lineItems;
     status;
     paymentId;
     dueDate;
@@ -39,6 +43,22 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], BillingResponseDto.prototype, "tenantId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Tipo de fatura',
+        enum: create_billing_dto_1.BILLING_KINDS,
+        example: 'SUBSCRIPTION',
+    }),
+    __metadata("design:type", String)
+], BillingResponseDto.prototype, "kind", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ID de referência (ex.: campanha)',
+        example: null,
+        nullable: true,
+    }),
+    __metadata("design:type", Object)
+], BillingResponseDto.prototype, "referenceId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Billing value',
@@ -46,6 +66,14 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], BillingResponseDto.prototype, "value", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Linhas da fatura (snapshot na emissão)',
+        type: [billing_line_item_dto_1.BillingLineItemDto],
+        nullable: true,
+    }),
+    __metadata("design:type", Object)
+], BillingResponseDto.prototype, "lineItems", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Billing status',

package/dist/billing/create-billing.dto.d.ts

@@ -1,5 +1,8 @@
+import { BillingLineItemDto } from './billing-line-item.dto';
 export declare const BILLING_STATUSES: readonly ["PENDING", "PAYED", "REFUNDED", "CANCELED", "OVERDUE"];
 export type BillingStatusDto = (typeof BILLING_STATUSES)[number];
+export declare const BILLING_KINDS: readonly ["SUBSCRIPTION", "CAMPAIGN", "OTHER"];
+export type BillingKindDto = (typeof BILLING_KINDS)[number];
 export declare class CreateBillingDto {
     tenantId: string;
     value: number;
@@ -7,5 +10,8 @@ export declare class CreateBillingDto {
     paymentId?: string;
     dueDate: string;
     payedAt?: string;
+    kind?: BillingKindDto;
+    referenceId?: string;
+    lineItems?: BillingLineItemDto[];
 }
 //# sourceMappingURL=create-billing.dto.d.ts.map

package/dist/billing/create-billing.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-billing.dto.d.ts","sourceRoot":"","sources":["../../src/billing/create-billing.dto.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,kEAMnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,qBAAa,gBAAgB;IAO3B,QAAQ,EAAE,MAAM,CAAC;IASjB,KAAK,EAAE,MAAM,CAAC;IASd,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAQ1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAOnB,OAAO,EAAE,MAAM,CAAC;IAQhB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"create-billing.dto.d.ts","sourceRoot":"","sources":["../../src/billing/create-billing.dto.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,eAAO,MAAM,gBAAgB,kEAMnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,eAAO,MAAM,aAAa,gDAAiD,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,qBAAa,gBAAgB;IAO3B,QAAQ,EAAE,MAAM,CAAC;IASjB,KAAK,EAAE,MAAM,CAAC;IASd,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAQ1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAOnB,OAAO,EAAE,MAAM,CAAC;IAQhB,OAAO,CAAC,EAAE,MAAM,CAAC;IASjB,IAAI,CAAC,EAAE,cAAc,CAAC;IAQtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAUrB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAClC"}

package/dist/billing/create-billing.dto.js

@@ -9,9 +9,11 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateBillingDto = exports.BILLING_STATUSES = void 0;
+exports.CreateBillingDto = exports.BILLING_KINDS = exports.BILLING_STATUSES = void 0;
 const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const billing_line_item_dto_1 = require("./billing-line-item.dto");
 exports.BILLING_STATUSES = [
     'PENDING',
     'PAYED',
@@ -19,6 +21,7 @@ exports.BILLING_STATUSES = [
     'CANCELED',
     'OVERDUE',
 ];
+exports.BILLING_KINDS = ['SUBSCRIPTION', 'CAMPAIGN', 'OTHER'];
 class CreateBillingDto {
     tenantId;
     value;
@@ -26,6 +29,9 @@ class CreateBillingDto {
     paymentId;
     dueDate;
     payedAt;
+    kind;
+    referenceId;
+    lineItems;
 }
 exports.CreateBillingDto = CreateBillingDto;
 __decorate([
@@ -83,3 +89,33 @@ __decorate([
     (0, class_validator_1.IsDateString)(),
     __metadata("design:type", String)
 ], CreateBillingDto.prototype, "payedAt", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Tipo de fatura',
+        enum: exports.BILLING_KINDS,
+        default: 'SUBSCRIPTION',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(exports.BILLING_KINDS),
+    __metadata("design:type", String)
+], CreateBillingDto.prototype, "kind", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ID de referência (ex.: campanha)',
+        example: '550e8400-e29b-41d4-a716-446655440099',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], CreateBillingDto.prototype, "referenceId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Linhas da fatura (snapshot); se omitido, o serviço deriva uma linha única',
+        type: [billing_line_item_dto_1.BillingLineItemDto],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => billing_line_item_dto_1.BillingLineItemDto),
+    __metadata("design:type", Array)
+], CreateBillingDto.prototype, "lineItems", void 0);

package/dist/billing/index.d.ts

@@ -1,3 +1,4 @@
+export * from './billing-line-item.dto';
 export * from './create-billing.dto';
 export * from './update-billing.dto';
 export * from './list-billings-query.dto';

package/dist/billing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC"}

package/dist/billing/index.js

@@ -14,6 +14,7 @@ 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("./billing-line-item.dto"), exports);
 __exportStar(require("./create-billing.dto"), exports);
 __exportStar(require("./update-billing.dto"), exports);
 __exportStar(require("./list-billings-query.dto"), exports);

package/dist/panel-rbac/dashboard-layout.dto.d.ts

@@ -5,7 +5,7 @@ export type DashboardChartType = (typeof DASHBOARD_CHART_TYPES)[number];
  * Módulos de dados agregados do dashboard (cada um mapeia a permissões e a fatia do summary).
  * Manter alinhado ao `Frontend/.../lib/dashboard-data-modules.ts`.
  */
-export declare const DASHBOARD_DATA_MODULE_KEYS: readonly ["overview.clients_total", "overview.clients_active_inactive", "overview.units_total", "overview.revenue_totals", "overview.revenue_growth", "overview.estimated_mrr", "overview.clients_per_plan", "overview.recent_signups", "overview.invoice_counts", "billing.revenue_by_status", "billing.invoice_status_breakdown", "billing.invoice_counts", "billing.recent_invoices", "billing.payment_links", "tenants.client_list", "tenants.plan_per_client", "tenants.legal_term_policy", "tenants.whatsapp_provider", "tenants.scheduled_deletion", "tenants.hostnames", "tenants.storage_usage", "infra.storage_overview", "infra.storage_by_tenant", "limits.per_client", "limits.session_policy", "limits.extra_storage", "plans.stats", "plans.list", "plans.active_inactive", "ia.tokens_per_tenant", "ia.agents_per_tenant", "ia.agents_summary", "ia.tool_policies", "ia.models_availability", "evolution.configs_summary", "evolution.instances_totals", "evolution.connection_state", "global.platform_config", "team.panel_admins", "audit.recent_events", "audit.outcome_counts", "security.device_sessions", "security.totp_status"];
+export declare const DASHBOARD_DATA_MODULE_KEYS: readonly ["overview.clients_total", "overview.clients_active_inactive", "overview.units_total", "overview.revenue_totals", "overview.revenue_growth", "overview.estimated_mrr", "overview.clients_per_plan", "overview.recent_signups", "overview.invoice_counts", "billing.revenue_by_status", "billing.invoice_status_breakdown", "billing.invoice_counts", "billing.recent_invoices", "billing.payment_links", "tenants.client_list", "tenants.plan_per_client", "tenants.legal_term_policy", "tenants.whatsapp_provider", "tenants.scheduled_deletion", "tenants.hostnames", "tenants.storage_usage", "infra.storage_overview", "infra.storage_by_tenant", "limits.per_client", "limits.session_policy", "limits.extra_storage", "plans.stats", "plans.list", "plans.active_inactive", "ia.tokens_per_tenant", "ia.agents_per_tenant", "ia.agents_summary", "ia.tool_policies", "ia.models_availability", "evolution.configs_summary", "evolution.instances_totals", "evolution.connection_state", "global.platform_config", "team.panel_admins", "audit.recent_events", "audit.outcome_counts", "security.device_sessions", "security.totp_status", "refunds.volume_by_month", "refunds.by_status", "refunds.top_tenants"];
 export type DashboardDataModuleKey = (typeof DASHBOARD_DATA_MODULE_KEYS)[number];
 export declare function isDashboardDataModuleKey(v: string): v is DashboardDataModuleKey;
 /** Posição e tamanho no painel em percentagem (0–100) relativamente ao contentor do canvas. */

package/dist/panel-rbac/dashboard-layout.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-layout.dto.d.ts","sourceRoot":"","sources":["../../src/panel-rbac/dashboard-layout.dto.ts"],"names":[],"mappings":"AAiBA,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,4EASxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,0lCA4C7B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,sBAAsB,CAE/E;AAED,+FAA+F;AAC/F,qBAAa,sBAAsB;IAMjC,OAAO,EAAE,MAAM,CAAC;IAOhB,MAAM,EAAE,MAAM,CAAC;IAOf,QAAQ,EAAE,MAAM,CAAC;IAOjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAG7B,EAAE,EAAE,MAAM,CAAC;IAKX,UAAU,EAAE,sBAAsB,CAAC;IAKnC,SAAS,EAAE,kBAAkB,CAAC;IAE9B,0CAA0C;IAK1C,CAAC,EAAE,MAAM,CAAC;IAEV,iCAAiC;IAKjC,CAAC,EAAE,MAAM,CAAC;IAEV;;;OAGG;IAOH,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAI3C,KAAK,EAAE,MAAM,CAAC;IAMd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0HAA0H;IAK1H,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC;AAED,qBAAa,kBAAkB;IAK7B,OAAO,EAAE,MAAM,CAAC;IAOhB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B"}
+{"version":3,"file":"dashboard-layout.dto.d.ts","sourceRoot":"","sources":["../../src/panel-rbac/dashboard-layout.dto.ts"],"names":[],"mappings":"AAiBA,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,4EASxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,iqCA+C7B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,sBAAsB,CAE/E;AAED,+FAA+F;AAC/F,qBAAa,sBAAsB;IAMjC,OAAO,EAAE,MAAM,CAAC;IAOhB,MAAM,EAAE,MAAM,CAAC;IAOf,QAAQ,EAAE,MAAM,CAAC;IAOjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAG7B,EAAE,EAAE,MAAM,CAAC;IAKX,UAAU,EAAE,sBAAsB,CAAC;IAKnC,SAAS,EAAE,kBAAkB,CAAC;IAE9B,0CAA0C;IAK1C,CAAC,EAAE,MAAM,CAAC;IAEV,iCAAiC;IAKjC,CAAC,EAAE,MAAM,CAAC;IAEV;;;OAGG;IAOH,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAI3C,KAAK,EAAE,MAAM,CAAC;IAMd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0HAA0H;IAK1H,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC;AAED,qBAAa,kBAAkB;IAK7B,OAAO,EAAE,MAAM,CAAC;IAOhB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B"}

package/dist/panel-rbac/dashboard-layout.dto.js

@@ -73,6 +73,9 @@ exports.DASHBOARD_DATA_MODULE_KEYS = [
     'audit.outcome_counts',
     'security.device_sessions',
     'security.totp_status',
+    'refunds.volume_by_month',
+    'refunds.by_status',
+    'refunds.top_tenants',
 ];
 function isDashboardDataModuleKey(v) {
     return exports.DASHBOARD_DATA_MODULE_KEYS.includes(v);

package/dist/panel-rbac/panel-permission-keys.d.ts

@@ -19,6 +19,7 @@ export declare const PANEL_RESOURCE_ACTIONS: {
     readonly admin_users: readonly ["view", "create", "update", "delete"];
     readonly access_levels: readonly ["view", "create", "update", "delete"];
     readonly conversation: readonly ["execute"];
+    readonly campaign_refunds: readonly ["view", "process", "cancel"];
 };
 export type PanelResource = keyof typeof PANEL_RESOURCE_ACTIONS;
 export type PanelAction<R extends PanelResource> = (typeof PANEL_RESOURCE_ACTIONS)[R][number];

package/dist/panel-rbac/panel-permission-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel-permission-keys.d.ts","sourceRoot":"","sources":["../../src/panel-rbac/panel-permission-keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;CA0BzB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAEhE,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,aAAa,IAC7C,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAS7C,eAAO,MAAM,qBAAqB,EAAW,SAAS,MAAM,EAAE,CAAC;AAE/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,GACjC,kBAAkB,CAEpB"}
+{"version":3,"file":"panel-permission-keys.d.ts","sourceRoot":"","sources":["../../src/panel-rbac/panel-permission-keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;CA2BzB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAEhE,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,aAAa,IAC7C,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAS7C,eAAO,MAAM,qBAAqB,EAAW,SAAS,MAAM,EAAE,CAAC;AAE/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAE/E;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,GACjC,kBAAkB,CAEpB"}

package/dist/panel-rbac/panel-permission-keys.js

@@ -32,6 +32,7 @@ exports.PANEL_RESOURCE_ACTIONS = {
     admin_users: ['view', 'create', 'update', 'delete'],
     access_levels: ['view', 'create', 'update', 'delete'],
     conversation: ['execute'],
+    campaign_refunds: ['view', 'process', 'cancel'],
 };
 const keys = [];
 for (const [resource, actions] of Object.entries(exports.PANEL_RESOURCE_ACTIONS)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.6.28",
+  "version": "1.6.30",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/billing/billing-line-item.dto.ts

@@ -0,0 +1,57 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsNumber,
+  IsOptional,
+  IsString,
+  MaxLength,
+  Min,
+} from 'class-validator';
+
+export class BillingLineItemDto {
+  @ApiProperty({
+    description: 'Código estável da linha (ex.: PLAN_BASE, EXTRA_PATIENTS)',
+    example: 'PLAN_BASE',
+  })
+  @IsString()
+  @MaxLength(64)
+  code: string;
+
+  @ApiProperty({
+    description: 'Rótulo exibido (snapshot em PT-BR na emissão)',
+    example: 'Plano',
+  })
+  @IsString()
+  @MaxLength(256)
+  label: string;
+
+  @ApiProperty({
+    description: 'Valor da linha (moeda do tenant / BRL)',
+    example: 99.9,
+    minimum: 0,
+  })
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  amount: number;
+
+  @ApiPropertyOptional({
+    description: 'Quantidade (ex.: pacientes adicionais)',
+    example: 5,
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  quantity?: number;
+
+  @ApiPropertyOptional({
+    description: 'Valor unitário',
+    example: 10,
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  unitAmount?: number;
+}

package/src/billing/billing-response.dto.ts

@@ -1,6 +1,9 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { BillingLineItemDto } from './billing-line-item.dto';
 import {
+  BILLING_KINDS,
   BILLING_STATUSES,
+  BillingKindDto,
   BillingStatusDto,
 } from './create-billing.dto';
 
@@ -17,12 +20,33 @@ export class BillingResponseDto {
   })
   tenantId: string;
 
+  @ApiProperty({
+    description: 'Tipo de fatura',
+    enum: BILLING_KINDS,
+    example: 'SUBSCRIPTION',
+  })
+  kind: BillingKindDto;
+
+  @ApiPropertyOptional({
+    description: 'ID de referência (ex.: campanha)',
+    example: null,
+    nullable: true,
+  })
+  referenceId?: string | null;
+
   @ApiProperty({
     description: 'Billing value',
     example: 99.9,
   })
   value: number;
 
+  @ApiPropertyOptional({
+    description: 'Linhas da fatura (snapshot na emissão)',
+    type: [BillingLineItemDto],
+    nullable: true,
+  })
+  lineItems?: BillingLineItemDto[] | null;
+
   @ApiProperty({
     description: 'Billing status',
     enum: BILLING_STATUSES,

package/src/billing/create-billing.dto.ts

@@ -1,5 +1,7 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
 import {
+  IsArray,
   IsDateString,
   IsEnum,
   IsNotEmpty,
@@ -7,7 +9,9 @@ import {
   IsOptional,
   IsUUID,
   Min,
+  ValidateNested,
 } from 'class-validator';
+import { BillingLineItemDto } from './billing-line-item.dto';
 
 export const BILLING_STATUSES = [
   'PENDING',
@@ -18,6 +22,9 @@ export const BILLING_STATUSES = [
 ] as const;
 export type BillingStatusDto = (typeof BILLING_STATUSES)[number];
 
+export const BILLING_KINDS = ['SUBSCRIPTION', 'CAMPAIGN', 'OTHER'] as const;
+export type BillingKindDto = (typeof BILLING_KINDS)[number];
+
 export class CreateBillingDto {
   @ApiProperty({
     description: 'Tenant ID (UUID)',
@@ -67,4 +74,31 @@ export class CreateBillingDto {
   @IsOptional()
   @IsDateString()
   payedAt?: string;
+
+  @ApiPropertyOptional({
+    description: 'Tipo de fatura',
+    enum: BILLING_KINDS,
+    default: 'SUBSCRIPTION',
+  })
+  @IsOptional()
+  @IsEnum(BILLING_KINDS)
+  kind?: BillingKindDto;
+
+  @ApiPropertyOptional({
+    description: 'ID de referência (ex.: campanha)',
+    example: '550e8400-e29b-41d4-a716-446655440099',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  referenceId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Linhas da fatura (snapshot); se omitido, o serviço deriva uma linha única',
+    type: [BillingLineItemDto],
+  })
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => BillingLineItemDto)
+  lineItems?: BillingLineItemDto[];
 }

package/src/billing/index.ts

@@ -1,3 +1,4 @@
+export * from './billing-line-item.dto';
 export * from './create-billing.dto';
 export * from './update-billing.dto';
 export * from './list-billings-query.dto';

package/src/panel-rbac/dashboard-layout.dto.ts

@@ -77,6 +77,9 @@ export const DASHBOARD_DATA_MODULE_KEYS = [
   'audit.outcome_counts',
   'security.device_sessions',
   'security.totp_status',
+  'refunds.volume_by_month',
+  'refunds.by_status',
+  'refunds.top_tenants',
 ] as const;
 
 export type DashboardDataModuleKey = (typeof DASHBOARD_DATA_MODULE_KEYS)[number];

package/src/panel-rbac/panel-permission-keys.ts

@@ -27,6 +27,7 @@ export const PANEL_RESOURCE_ACTIONS = {
   admin_users: ['view', 'create', 'update', 'delete'] as const,
   access_levels: ['view', 'create', 'update', 'delete'] as const,
   conversation: ['execute'] as const,
+  campaign_refunds: ['view', 'process', 'cancel'] as const,
 } as const;
 
 export type PanelResource = keyof typeof PANEL_RESOURCE_ACTIONS;