tychat-contracts 1.3.0 → 1.3.2

package/dist/appointments/appointment-calendar.dto.d.ts

@@ -3,11 +3,18 @@ export declare class AppointmentCalendarItemDto {
     id: string;
     date: string;
 }
+/** Agendamentos agrupados por hora civil UTC. */
+export declare class AppointmentCalendarHourDto {
+    hour: string;
+    countAppointment: number;
+    appointments: AppointmentCalendarItemDto[];
+}
 /** Agendamentos agrupados por dia civil (UTC a partir do timestamp do agendamento). */
 export declare class AppointmentCalendarDayDto {
     date: string;
     countAppointment: number;
     appointments: AppointmentCalendarItemDto[];
+    hours?: AppointmentCalendarHourDto[];
 }
 export declare class AppointmentCalendarResponseDto {
     startDate: string;

package/dist/appointments/appointment-calendar.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appointment-calendar.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-calendar.dto.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,qBAAa,0BAA0B;IAErC,EAAE,EAAE,MAAM,CAAC;IAMX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uFAAuF;AACvF,qBAAa,yBAAyB;IAKpC,IAAI,EAAE,MAAM,CAAC;IAMb,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,0BAA0B,EAAE,CAAC;CAC5C;AAED,qBAAa,8BAA8B;IAEzC,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAOhB,IAAI,EAAE,yBAAyB,EAAE,CAAC;CACnC"}
+{"version":3,"file":"appointment-calendar.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-calendar.dto.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,qBAAa,0BAA0B;IAErC,EAAE,EAAE,MAAM,CAAC;IAMX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iDAAiD;AACjD,qBAAa,0BAA0B;IAKrC,IAAI,EAAE,MAAM,CAAC;IAKb,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,0BAA0B,EAAE,CAAC;CAC5C;AAED,uFAAuF;AACvF,qBAAa,yBAAyB;IAKpC,IAAI,EAAE,MAAM,CAAC;IAMb,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,0BAA0B,EAAE,CAAC;IAQ3C,KAAK,CAAC,EAAE,0BAA0B,EAAE,CAAC;CACtC;AAED,qBAAa,8BAA8B;IAEzC,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAOhB,IAAI,EAAE,yBAAyB,EAAE,CAAC;CACnC"}

package/dist/appointments/appointment-calendar.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.AppointmentCalendarResponseDto = exports.AppointmentCalendarDayDto = exports.AppointmentCalendarItemDto = void 0;
+exports.AppointmentCalendarResponseDto = exports.AppointmentCalendarDayDto = exports.AppointmentCalendarHourDto = exports.AppointmentCalendarItemDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 /** Um agendamento no calendário. */
 class AppointmentCalendarItemDto {
@@ -28,11 +28,36 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], AppointmentCalendarItemDto.prototype, "date", void 0);
+/** Agendamentos agrupados por hora civil UTC. */
+class AppointmentCalendarHourDto {
+    hour;
+    countAppointment;
+    appointments;
+}
+exports.AppointmentCalendarHourDto = AppointmentCalendarHourDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Hora UTC no formato ISO 8601 arredondada para início da hora',
+        example: '2026-04-10T14:00:00.000Z',
+    }),
+    __metadata("design:type", String)
+], AppointmentCalendarHourDto.prototype, "hour", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Quantidade de agendamentos nesta hora UTC dentro do intervalo solicitado.',
+    }),
+    __metadata("design:type", Number)
+], AppointmentCalendarHourDto.prototype, "countAppointment", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: [AppointmentCalendarItemDto] }),
+    __metadata("design:type", Array)
+], AppointmentCalendarHourDto.prototype, "appointments", void 0);
 /** Agendamentos agrupados por dia civil (UTC a partir do timestamp do agendamento). */
 class AppointmentCalendarDayDto {
     date;
     countAppointment;
     appointments;
+    hours;
 }
 exports.AppointmentCalendarDayDto = AppointmentCalendarDayDto;
 __decorate([
@@ -52,6 +77,14 @@ __decorate([
     (0, swagger_1.ApiProperty)({ type: [AppointmentCalendarItemDto] }),
     __metadata("design:type", Array)
 ], AppointmentCalendarDayDto.prototype, "appointments", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        required: false,
+        description: 'Quando o intervalo tiver exatamente 7 dias, agrega por hora UTC com `countAppointment` por hora e até 2 itens em `appointments` por hora.',
+        type: [AppointmentCalendarHourDto],
+    }),
+    __metadata("design:type", Array)
+], AppointmentCalendarDayDto.prototype, "hours", void 0);
 class AppointmentCalendarResponseDto {
     startDate;
     endDate;
@@ -68,7 +101,7 @@ __decorate([
 ], AppointmentCalendarResponseDto.prototype, "endDate", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Um elemento por dia civil no intervalo (UTC). Em intervalos multi-dia, `appointments` traz no máximo 2 itens por dia (primeiros por horário naquele dia UTC); `countAppointment` é sempre o total do dia.',
+        description: 'Um elemento por dia civil no intervalo (UTC). 1 dia: retorna todos os agendamentos em `appointments`. Exatamente 7 dias: `hours` traz até 2 agendamentos por hora e contagem por hora; `appointments` agrega esses previews do dia. Maior que 7 dias: `appointments` traz no máximo 2 itens por dia e `countAppointment` é o total diário.',
         type: [AppointmentCalendarDayDto],
     }),
     __metadata("design:type", Array)

package/package.json

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

package/src/appointments/appointment-calendar.dto.ts

@@ -12,6 +12,23 @@ export class AppointmentCalendarItemDto {
   date: string;
 }
 
+/** Agendamentos agrupados por hora civil UTC. */
+export class AppointmentCalendarHourDto {
+  @ApiProperty({
+    description: 'Hora UTC no formato ISO 8601 arredondada para início da hora',
+    example: '2026-04-10T14:00:00.000Z',
+  })
+  hour: string;
+
+  @ApiProperty({
+    description: 'Quantidade de agendamentos nesta hora UTC dentro do intervalo solicitado.',
+  })
+  countAppointment: number;
+
+  @ApiProperty({ type: [AppointmentCalendarItemDto] })
+  appointments: AppointmentCalendarItemDto[];
+}
+
 /** Agendamentos agrupados por dia civil (UTC a partir do timestamp do agendamento). */
 export class AppointmentCalendarDayDto {
   @ApiProperty({
@@ -28,6 +45,14 @@ export class AppointmentCalendarDayDto {
 
   @ApiProperty({ type: [AppointmentCalendarItemDto] })
   appointments: AppointmentCalendarItemDto[];
+
+  @ApiProperty({
+    required: false,
+    description:
+      'Quando o intervalo tiver exatamente 7 dias, agrega por hora UTC com `countAppointment` por hora e até 2 itens em `appointments` por hora.',
+    type: [AppointmentCalendarHourDto],
+  })
+  hours?: AppointmentCalendarHourDto[];
 }
 
 export class AppointmentCalendarResponseDto {
@@ -39,7 +64,7 @@ export class AppointmentCalendarResponseDto {
 
   @ApiProperty({
     description:
-      'Um elemento por dia civil no intervalo (UTC). Em intervalos multi-dia, `appointments` traz no máximo 2 itens por dia (primeiros por horário naquele dia UTC); `countAppointment` é sempre o total do dia.',
+      'Um elemento por dia civil no intervalo (UTC). 1 dia: retorna todos os agendamentos em `appointments`. Exatamente 7 dias: `hours` traz até 2 agendamentos por hora e contagem por hora; `appointments` agrega esses previews do dia. Maior que 7 dias: `appointments` traz no máximo 2 itens por dia e `countAppointment` é o total diário.',
     type: [AppointmentCalendarDayDto],
   })
   days: AppointmentCalendarDayDto[];