tychat-contracts 1.6.12 → 1.6.14

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

@@ -8,6 +8,13 @@ export type DashboardChartType = (typeof DASHBOARD_CHART_TYPES)[number];
 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.invoice_counts", "billing.revenue_by_status", "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", "limits.per_client", "limits.session_policy", "limits.extra_storage", "plans.stats", "plans.list", "ia.tokens_per_tenant", "ia.agents_per_tenant", "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 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. */
+export declare class DashboardCanvasRectDto {
+    leftPct: number;
+    topPct: number;
+    widthPct: number;
+    heightPct: number;
+}
 export declare class DashboardWidgetDto {
     id: string;
     dataModule: DashboardDataModuleKey;
@@ -16,9 +23,16 @@ export declare class DashboardWidgetDto {
     x: number;
     /** Largura em colunas (1–12). */
     w: number;
+    /**
+     * Altura em linhas da grelha CSS (`grid-row: span h`), alinhada a `gridAutoRows` do painel.
+     * Omitir = 1 (compatível com layouts antigos).
+     */
+    h?: number;
     /** Ordem de leitura (menor = primeiro). */
     order: number;
     title?: string;
+    /** Modo canvas: posicionamento livre (percentagens). Opcional; quando presente, o cliente deve preferir isto à grelha. */
+    canvas?: DashboardCanvasRectDto;
 }
 export declare class DashboardLayoutDto {
     version: number;

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":"AAgBA,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,i4BAoC7B,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,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,2CAA2C;IAI3C,KAAK,EAAE,MAAM,CAAC;IAMd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;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,i4BAoC7B,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

@@ -9,7 +9,7 @@ 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.DashboardLayoutDto = exports.DashboardWidgetDto = exports.DASHBOARD_DATA_MODULE_KEYS = exports.DASHBOARD_CHART_TYPES = void 0;
+exports.DashboardLayoutDto = exports.DashboardWidgetDto = exports.DashboardCanvasRectDto = exports.DASHBOARD_DATA_MODULE_KEYS = exports.DASHBOARD_CHART_TYPES = void 0;
 exports.isDashboardDataModuleKey = isDashboardDataModuleKey;
 const swagger_1 = require("@nestjs/swagger");
 const class_transformer_1 = require("class-transformer");
@@ -69,6 +69,46 @@ exports.DASHBOARD_DATA_MODULE_KEYS = [
 function isDashboardDataModuleKey(v) {
     return exports.DASHBOARD_DATA_MODULE_KEYS.includes(v);
 }
+/** Posição e tamanho no painel em percentagem (0–100) relativamente ao contentor do canvas. */
+class DashboardCanvasRectDto {
+    leftPct;
+    topPct;
+    widthPct;
+    heightPct;
+}
+exports.DashboardCanvasRectDto = DashboardCanvasRectDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ minimum: 0, maximum: 100 }),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], DashboardCanvasRectDto.prototype, "leftPct", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ minimum: 0, maximum: 100 }),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], DashboardCanvasRectDto.prototype, "topPct", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ minimum: 0, maximum: 100 }),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], DashboardCanvasRectDto.prototype, "widthPct", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ minimum: 0, maximum: 100 }),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], DashboardCanvasRectDto.prototype, "heightPct", void 0);
 class DashboardWidgetDto {
     id;
     dataModule;
@@ -77,9 +117,16 @@ class DashboardWidgetDto {
     x;
     /** Largura em colunas (1–12). */
     w;
+    /**
+     * Altura em linhas da grelha CSS (`grid-row: span h`), alinhada a `gridAutoRows` do painel.
+     * Omitir = 1 (compatível com layouts antigos).
+     */
+    h;
     /** Ordem de leitura (menor = primeiro). */
     order;
     title;
+    /** Modo canvas: posicionamento livre (percentagens). Opcional; quando presente, o cliente deve preferir isto à grelha. */
+    canvas;
 }
 exports.DashboardWidgetDto = DashboardWidgetDto;
 __decorate([
@@ -113,6 +160,15 @@ __decorate([
     (0, class_validator_1.Max)(12),
     __metadata("design:type", Number)
 ], DashboardWidgetDto.prototype, "w", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ minimum: 1, maximum: 12, default: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(12),
+    __metadata("design:type", Number)
+], DashboardWidgetDto.prototype, "h", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)(),
     (0, class_validator_1.IsInt)(),
@@ -126,16 +182,23 @@ __decorate([
     (0, class_validator_1.MaxLength)(120),
     __metadata("design:type", String)
 ], DashboardWidgetDto.prototype, "title", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ type: DashboardCanvasRectDto }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => DashboardCanvasRectDto),
+    __metadata("design:type", DashboardCanvasRectDto)
+], DashboardWidgetDto.prototype, "canvas", void 0);
 class DashboardLayoutDto {
     version;
     widgets;
 }
 exports.DashboardLayoutDto = DashboardLayoutDto;
 __decorate([
-    (0, swagger_1.ApiProperty)({ default: 1 }),
+    (0, swagger_1.ApiProperty)({ default: 1, description: '1 = só grelha; 2 = canvas com campo canvas por widget' }),
     (0, class_validator_1.IsInt)(),
     (0, class_validator_1.Min)(1),
-    (0, class_validator_1.Max)(1),
+    (0, class_validator_1.Max)(2),
     __metadata("design:type", Number)
 ], DashboardLayoutDto.prototype, "version", void 0);
 __decorate([

package/package.json

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

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

@@ -5,6 +5,7 @@ import {
   IsArray,
   IsIn,
   IsInt,
+  IsNumber,
   IsOptional,
   IsString,
   IsUUID,
@@ -76,6 +77,37 @@ export function isDashboardDataModuleKey(v: string): v is DashboardDataModuleKey
   return (DASHBOARD_DATA_MODULE_KEYS as readonly string[]).includes(v);
 }
 
+/** Posição e tamanho no painel em percentagem (0–100) relativamente ao contentor do canvas. */
+export class DashboardCanvasRectDto {
+  @ApiProperty({ minimum: 0, maximum: 100 })
+  @Type(() => Number)
+  @IsNumber()
+  @Min(0)
+  @Max(100)
+  leftPct: number;
+
+  @ApiProperty({ minimum: 0, maximum: 100 })
+  @Type(() => Number)
+  @IsNumber()
+  @Min(0)
+  @Max(100)
+  topPct: number;
+
+  @ApiProperty({ minimum: 0, maximum: 100 })
+  @Type(() => Number)
+  @IsNumber()
+  @Min(0)
+  @Max(100)
+  widthPct: number;
+
+  @ApiProperty({ minimum: 0, maximum: 100 })
+  @Type(() => Number)
+  @IsNumber()
+  @Min(0)
+  @Max(100)
+  heightPct: number;
+}
+
 export class DashboardWidgetDto {
   @ApiProperty({ format: 'uuid' })
   @IsUUID('4')
@@ -105,6 +137,18 @@ export class DashboardWidgetDto {
   @Max(12)
   w: number;
 
+  /**
+   * Altura em linhas da grelha CSS (`grid-row: span h`), alinhada a `gridAutoRows` do painel.
+   * Omitir = 1 (compatível com layouts antigos).
+   */
+  @ApiPropertyOptional({ minimum: 1, maximum: 12, default: 1 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  @Max(12)
+  h?: number;
+
   /** Ordem de leitura (menor = primeiro). */
   @ApiProperty()
   @IsInt()
@@ -116,13 +160,20 @@ export class DashboardWidgetDto {
   @IsString()
   @MaxLength(120)
   title?: string;
+
+  /** Modo canvas: posicionamento livre (percentagens). Opcional; quando presente, o cliente deve preferir isto à grelha. */
+  @ApiPropertyOptional({ type: DashboardCanvasRectDto })
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => DashboardCanvasRectDto)
+  canvas?: DashboardCanvasRectDto;
 }
 
 export class DashboardLayoutDto {
-  @ApiProperty({ default: 1 })
+  @ApiProperty({ default: 1, description: '1 = só grelha; 2 = canvas com campo canvas por widget' })
   @IsInt()
   @Min(1)
-  @Max(1)
+  @Max(2)
   version: number;
 
   @ApiProperty({ type: [DashboardWidgetDto] })