tychat-contracts 1.6.21 → 1.6.24

package/README.md

@@ -1,33 +1,33 @@
-# tychat-contracts-dtos
-
-DTOs compartilhados com **class-validator** usados pela **tychat-api** e pelos microserviços (ex.: **tychat-tenant-service**).
-
-## Estrutura
-
-- **auth**: `LoginDto`, `RefreshTokenDto`, `RequestPasswordResetDto`, `ConfirmPasswordResetDto`, `AuthLoginResponseDto`, payloads Kafka (`LoginPayload`, `RequestPasswordResetPayload`, etc.)
-- **users**: `CreateUserDto` (sem password para criação por admin), `UserListItemDto`, `UpdateSelfUserDto` (apenas **name**), `UpdateUserByAdminDto` (name/email/role; regras de e-mail na API/auth-service), `UpdatedUserDto`, `ChangeForcePasswordDto`
-- **professionals**: `ProfessionalProfileDto`, `UpdateProfessionalProfileDto`, `CreateProfessionalWithProfileDto`
-- **notifications**: payloads Kafka para notificações de e-mail (`NotificationUserCreatedEventPayload`, `NotificationPasswordResetRequestedEventPayload`)
-
-## Uso
-
-```bash
-# Build (gera dist/)
-npm run build
-```
-
-Nos projetos que consomem (tychat-api, tychat-tenant-service, etc.):
-
-```json
-"dependencies": {
-  "tychat-contracts": "^1.0.58"
-}
-```
-
-```ts
-import { LoginDto } from 'tychat-contracts';
-```
-
-## Desenvolvimento
-
-Após alterar os DTOs, rode `npm run build`, publique no registry e atualize os consumidores para a mesma versão.
+# tychat-contracts-dtos
+
+DTOs compartilhados com **class-validator** usados pela **tychat-api** e pelos microserviços (ex.: **tychat-tenant-service**).
+
+## Estrutura
+
+- **auth**: `LoginDto`, `RefreshTokenDto`, `RequestPasswordResetDto`, `ConfirmPasswordResetDto`, `AuthLoginResponseDto`, payloads Kafka (`LoginPayload`, `RequestPasswordResetPayload`, etc.)
+- **users**: `CreateUserDto` (sem password para criação por admin), `UserListItemDto`, `UpdateSelfUserDto` (apenas **name**), `UpdateUserByAdminDto` (name/email/role; regras de e-mail na API/auth-service), `UpdatedUserDto`, `ChangeForcePasswordDto`
+- **professionals**: `ProfessionalProfileDto`, `UpdateProfessionalProfileDto`, `CreateProfessionalWithProfileDto`
+- **notifications**: payloads Kafka para notificações de e-mail (`NotificationUserCreatedEventPayload`, `NotificationPasswordResetRequestedEventPayload`)
+
+## Uso
+
+```bash
+# Build (gera dist/)
+npm run build
+```
+
+Nos projetos que consomem (tychat-api, tychat-tenant-service, etc.):
+
+```json
+"dependencies": {
+  "tychat-contracts": "^1.0.58"
+}
+```
+
+```ts
+import { LoginDto } from 'tychat-contracts';
+```
+
+## Desenvolvimento
+
+Após alterar os DTOs, rode `npm run build`, publique no registry e atualize os consumidores para a mesma versão.

package/dist/storage/delete-object-rpc.dto.d.ts

@@ -0,0 +1,9 @@
+/** RMQ: serviço interno pede remoção de objeto validando escopo por tenant. */
+export declare class DeleteObjectRpcDto {
+    tenantSlug: string;
+    objectKey: string;
+}
+export declare class DeleteObjectRpcResultDto {
+    ok: true;
+}
+//# sourceMappingURL=delete-object-rpc.dto.d.ts.map

package/dist/storage/delete-object-rpc.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-object-rpc.dto.d.ts","sourceRoot":"","sources":["../../src/storage/delete-object-rpc.dto.ts"],"names":[],"mappings":"AAGA,+EAA+E;AAC/E,qBAAa,kBAAkB;IAQ7B,UAAU,EAAE,MAAM,CAAC;IASnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,wBAAwB;IAEnC,EAAE,EAAE,IAAI,CAAC;CACV"}

package/dist/storage/delete-object-rpc.dto.js

@@ -0,0 +1,48 @@
+"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.DeleteObjectRpcResultDto = exports.DeleteObjectRpcDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/** RMQ: serviço interno pede remoção de objeto validando escopo por tenant. */
+class DeleteObjectRpcDto {
+    tenantSlug;
+    objectKey;
+}
+exports.DeleteObjectRpcDto = DeleteObjectRpcDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Tenant slug (deve corresponder ao prefixo do objectKey)',
+        example: 'clinica_sampaio',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], DeleteObjectRpcDto.prototype, "tenantSlug", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Chave S3 do objeto',
+        example: 'tenants/clinica_sampaio/patients/.../doc.pdf',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(2048),
+    __metadata("design:type", String)
+], DeleteObjectRpcDto.prototype, "objectKey", void 0);
+class DeleteObjectRpcResultDto {
+    ok;
+}
+exports.DeleteObjectRpcResultDto = DeleteObjectRpcResultDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Confirmação da remoção' }),
+    __metadata("design:type", Boolean)
+], DeleteObjectRpcResultDto.prototype, "ok", void 0);

package/dist/storage/index.d.ts

@@ -5,5 +5,6 @@ export * from './presigned-url-response.dto';
 export * from './exists-query.dto';
 export * from './issue-upload-token.dto';
 export * from './presign-download-rpc.dto';
+export * from './delete-object-rpc.dto';
 export * from './storage-rmq-patterns';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/storage/index.js

@@ -21,4 +21,5 @@ __exportStar(require("./presigned-url-response.dto"), exports);
 __exportStar(require("./exists-query.dto"), exports);
 __exportStar(require("./issue-upload-token.dto"), exports);
 __exportStar(require("./presign-download-rpc.dto"), exports);
+__exportStar(require("./delete-object-rpc.dto"), exports);
 __exportStar(require("./storage-rmq-patterns"), exports);

package/dist/storage/storage-rmq-patterns.d.ts

@@ -2,4 +2,6 @@
 export declare const STORAGE_ISSUE_UPLOAD_TOKEN = "storage.issueUploadToken";
 /** URL presigned GET (chamada interna; sem JWT HTTP para o storage) */
 export declare const STORAGE_PRESIGN_DOWNLOAD = "storage.presignDownload";
+/** Delete object via RMQ (chamada interna; sem JWT HTTP para o storage) */
+export declare const STORAGE_DELETE_OBJECT = "storage.deleteObject";
 //# sourceMappingURL=storage-rmq-patterns.d.ts.map

package/dist/storage/storage-rmq-patterns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-rmq-patterns.d.ts","sourceRoot":"","sources":["../../src/storage/storage-rmq-patterns.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,4BAA4B,CAAC"}
+{"version":3,"file":"storage-rmq-patterns.d.ts","sourceRoot":"","sources":["../../src/storage/storage-rmq-patterns.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,4BAA4B,CAAC;AAElE,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,yBAAyB,CAAC"}

package/dist/storage/storage-rmq-patterns.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STORAGE_PRESIGN_DOWNLOAD = exports.STORAGE_ISSUE_UPLOAD_TOKEN = void 0;
+exports.STORAGE_DELETE_OBJECT = exports.STORAGE_PRESIGN_DOWNLOAD = exports.STORAGE_ISSUE_UPLOAD_TOKEN = void 0;
 /** Pedido de token OTT para HTTP POST /storage/presign-upload */
 exports.STORAGE_ISSUE_UPLOAD_TOKEN = 'storage.issueUploadToken';
 /** URL presigned GET (chamada interna; sem JWT HTTP para o storage) */
 exports.STORAGE_PRESIGN_DOWNLOAD = 'storage.presignDownload';
+/** Delete object via RMQ (chamada interna; sem JWT HTTP para o storage) */
+exports.STORAGE_DELETE_OBJECT = 'storage.deleteObject';

package/jest.config.ts

@@ -1,5 +1,5 @@
-export default {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  roots: ['<rootDir>/src'],
-};
+export default {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "tychat-contracts",
-  "version": "1.6.21",
+  "version": "1.6.24",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "private": false,
   "scripts": {
     "build": "tsc",
+    "release": "npm version patch && npm publish",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {

package/src/ai/ai-usage-response.dto.ts

@@ -1,47 +1,47 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
-import { AiIntegrationDto } from './integration-provider.dto';
-
-/**
- * Represents a persisted AI token-usage record returned by the API.
- */
-export class AiUsageResponseDto {
-  @ApiProperty({ description: 'AI usage record UUID', example: 'a1b2c3d4-...' })
-  @IsString()
-  @IsNotEmpty()
-  id: string;
-
-  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
-  @IsString()
-  @IsNotEmpty()
-  tenant: string;
-
-  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
-  @IsOptional()
-  unitId?: number;
-
-  @ApiProperty({ description: 'AI integration used', example: 'OPENAI' })
-  integration: AiIntegrationDto;
-
-  @ApiProperty({ description: 'Model name', example: 'gpt-4.1-mini' })
-  @IsString()
-  @IsNotEmpty()
-  model: string;
-
-  @ApiProperty({ description: 'Number of prompt tokens consumed', example: 120 })
-  promptTokens: number;
-
-  @ApiProperty({ description: 'Number of completion tokens generated', example: 60 })
-  completionTokens: number;
-
-  @ApiProperty({ description: 'Total tokens (prompt + completion)', example: 180 })
-  totalTokens: number;
-
-  @ApiProperty({
-    description: 'Creation timestamp (ISO 8601)',
-    example: '2024-01-01T00:00:00.000Z',
-  })
-  @IsString()
-  @IsNotEmpty()
-  createdAt: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { AiIntegrationDto } from './integration-provider.dto';
+
+/**
+ * Represents a persisted AI token-usage record returned by the API.
+ */
+export class AiUsageResponseDto {
+  @ApiProperty({ description: 'AI usage record UUID', example: 'a1b2c3d4-...' })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  unitId?: number;
+
+  @ApiProperty({ description: 'AI integration used', example: 'OPENAI' })
+  integration: AiIntegrationDto;
+
+  @ApiProperty({ description: 'Model name', example: 'gpt-4.1-mini' })
+  @IsString()
+  @IsNotEmpty()
+  model: string;
+
+  @ApiProperty({ description: 'Number of prompt tokens consumed', example: 120 })
+  promptTokens: number;
+
+  @ApiProperty({ description: 'Number of completion tokens generated', example: 60 })
+  completionTokens: number;
+
+  @ApiProperty({ description: 'Total tokens (prompt + completion)', example: 180 })
+  totalTokens: number;
+
+  @ApiProperty({
+    description: 'Creation timestamp (ISO 8601)',
+    example: '2024-01-01T00:00:00.000Z',
+  })
+  @IsString()
+  @IsNotEmpty()
+  createdAt: string;
+}

package/src/ai/create-ai-usage.dto.ts

@@ -1,43 +1,43 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
-import { AI_INTEGRATIONS, AiIntegrationDto } from './integration-provider.dto';
-
-/**
- * Payload used to persist an AI token-usage record after a generation call.
- */
-export class CreateAiUsageDto {
-  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
-  @IsString()
-  @IsNotEmpty()
-  tenant: string;
-
-  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
-  @IsOptional()
-  @IsInt()
-  @Min(1)
-  unitId?: number;
-
-  @ApiProperty({ description: 'AI integration used', enum: AI_INTEGRATIONS })
-  @IsEnum(AI_INTEGRATIONS)
-  integration: AiIntegrationDto;
-
-  @ApiProperty({ description: 'Model name used for generation', example: 'gpt-4.1-mini' })
-  @IsString()
-  @IsNotEmpty()
-  model: string;
-
-  @ApiProperty({ description: 'Number of prompt tokens consumed', example: 120 })
-  @IsInt()
-  @Min(0)
-  promptTokens: number;
-
-  @ApiProperty({ description: 'Number of completion tokens generated', example: 60 })
-  @IsInt()
-  @Min(0)
-  completionTokens: number;
-
-  @ApiProperty({ description: 'Total tokens (prompt + completion)', example: 180 })
-  @IsInt()
-  @Min(0)
-  totalTokens: number;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+import { AI_INTEGRATIONS, AiIntegrationDto } from './integration-provider.dto';
+
+/**
+ * Payload used to persist an AI token-usage record after a generation call.
+ */
+export class CreateAiUsageDto {
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+
+  @ApiProperty({ description: 'AI integration used', enum: AI_INTEGRATIONS })
+  @IsEnum(AI_INTEGRATIONS)
+  integration: AiIntegrationDto;
+
+  @ApiProperty({ description: 'Model name used for generation', example: 'gpt-4.1-mini' })
+  @IsString()
+  @IsNotEmpty()
+  model: string;
+
+  @ApiProperty({ description: 'Number of prompt tokens consumed', example: 120 })
+  @IsInt()
+  @Min(0)
+  promptTokens: number;
+
+  @ApiProperty({ description: 'Number of completion tokens generated', example: 60 })
+  @IsInt()
+  @Min(0)
+  completionTokens: number;
+
+  @ApiProperty({ description: 'Total tokens (prompt + completion)', example: 180 })
+  @IsInt()
+  @Min(0)
+  totalTokens: number;
+}

package/src/analytics/analytics-emitter.helper.ts

@@ -1,54 +1,54 @@
-import { randomUUID } from 'crypto';
-import { EventAnalyticType } from './event-analytic.enum';
-import { CreateAnalyticEventDto } from './create-analytic-event.dto';
-import { TOPIC_ANALYTICS_EVENT } from './analytics-kafka-topics';
-
-/**
- * Options for building an analytic event payload.
- */
-export interface EmitAnalyticEventOptions {
-  tenant: string;
-  eventType: EventAnalyticType;
-  entityId?: string;
-  userId?: string;
-  metadata?: Record<string, unknown>;
-}
-
-/**
- * Builds the Kafka payload to be sent to the analytics service.
- *
- * Usage (fire-and-forget via ClientProxy.emit):
- * ```ts
- * this.analyticsClient.emit(
- *   TOPIC_ANALYTICS_EVENT,
- *   buildAnalyticEventPayload({
- *     tenant,
- *     eventType: 'patient.created',
- *     entityId: patient.id,
- *     source: 'tychat-patient-service',
- *   }),
- * );
- * ```
- */
-export function buildAnalyticEventPayload(
-  options: EmitAnalyticEventOptions & { source: string },
-): { tenant: string; payload: CreateAnalyticEventDto } {
-  return {
-    tenant: options.tenant,
-    payload: {
-      eventId: randomUUID(),
-      tenant: options.tenant,
-      eventType: options.eventType,
-      entityId: options.entityId,
-      source: options.source,
-      userId: options.userId,
-      metadata: options.metadata,
-      occurredAt: new Date().toISOString(),
-    },
-  };
-}
-
-/**
- * Re-export for convenience so services only need one import.
- */
-export { TOPIC_ANALYTICS_EVENT };
+import { randomUUID } from 'crypto';
+import { EventAnalyticType } from './event-analytic.enum';
+import { CreateAnalyticEventDto } from './create-analytic-event.dto';
+import { TOPIC_ANALYTICS_EVENT } from './analytics-kafka-topics';
+
+/**
+ * Options for building an analytic event payload.
+ */
+export interface EmitAnalyticEventOptions {
+  tenant: string;
+  eventType: EventAnalyticType;
+  entityId?: string;
+  userId?: string;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Builds the Kafka payload to be sent to the analytics service.
+ *
+ * Usage (fire-and-forget via ClientProxy.emit):
+ * ```ts
+ * this.analyticsClient.emit(
+ *   TOPIC_ANALYTICS_EVENT,
+ *   buildAnalyticEventPayload({
+ *     tenant,
+ *     eventType: 'patient.created',
+ *     entityId: patient.id,
+ *     source: 'tychat-patient-service',
+ *   }),
+ * );
+ * ```
+ */
+export function buildAnalyticEventPayload(
+  options: EmitAnalyticEventOptions & { source: string },
+): { tenant: string; payload: CreateAnalyticEventDto } {
+  return {
+    tenant: options.tenant,
+    payload: {
+      eventId: randomUUID(),
+      tenant: options.tenant,
+      eventType: options.eventType,
+      entityId: options.entityId,
+      source: options.source,
+      userId: options.userId,
+      metadata: options.metadata,
+      occurredAt: new Date().toISOString(),
+    },
+  };
+}
+
+/**
+ * Re-export for convenience so services only need one import.
+ */
+export { TOPIC_ANALYTICS_EVENT };