tychat-contracts 1.6.8 → 1.6.11

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=panel-permission-keys.spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panel-permission-keys.spec.d.ts","sourceRoot":"","sources":["../../src/panel-rbac/panel-permission-keys.spec.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const panel_permission_keys_1 = require("./panel-permission-keys");
+describe("panel-permission-keys", () => {
+    it("expõe chaves estáveis para cada recurso/ação", () => {
+        let expected = 0;
+        for (const [, actions] of Object.entries(panel_permission_keys_1.PANEL_RESOURCE_ACTIONS)) {
+            expected += actions.length;
+        }
+        expect(panel_permission_keys_1.PANEL_PERMISSION_KEYS.length).toBe(expected);
+    });
+    it("isPanelPermissionKey valida chaves canónicas", () => {
+        expect((0, panel_permission_keys_1.isPanelPermissionKey)("tenants.view")).toBe(true);
+        expect((0, panel_permission_keys_1.isPanelPermissionKey)("invalid.key")).toBe(false);
+    });
+});

package/dist/panel-rbac/replace-access-permissions.dto.d.ts

@@ -0,0 +1,5 @@
+import { AccessPermissionItemDto } from './access-permission-item.dto';
+export declare class ReplaceAccessPermissionsDto {
+    items: AccessPermissionItemDto[];
+}
+//# sourceMappingURL=replace-access-permissions.dto.d.ts.map

package/dist/panel-rbac/replace-access-permissions.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-access-permissions.dto.d.ts","sourceRoot":"","sources":["../../src/panel-rbac/replace-access-permissions.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,qBAAa,2BAA2B;IAMtC,KAAK,EAAE,uBAAuB,EAAE,CAAC;CAClC"}

package/dist/panel-rbac/replace-access-permissions.dto.js

@@ -0,0 +1,28 @@
+"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.ReplaceAccessPermissionsDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const access_permission_item_dto_1 = require("./access-permission-item.dto");
+class ReplaceAccessPermissionsDto {
+    items;
+}
+exports.ReplaceAccessPermissionsDto = ReplaceAccessPermissionsDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: [access_permission_item_dto_1.AccessPermissionItemDto] }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(0),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => access_permission_item_dto_1.AccessPermissionItemDto),
+    __metadata("design:type", Array)
+], ReplaceAccessPermissionsDto.prototype, "items", void 0);

package/dist/panel-rbac/update-access-level.dto.d.ts

@@ -0,0 +1,8 @@
+import { DashboardLayoutDto } from './dashboard-layout.dto';
+export declare class UpdateAccessLevelDto {
+    name?: string;
+    description?: string | null;
+    isActive?: boolean;
+    dashboardLayout?: DashboardLayoutDto | null;
+}
+//# sourceMappingURL=update-access-level.dto.d.ts.map

package/dist/panel-rbac/update-access-level.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-access-level.dto.d.ts","sourceRoot":"","sources":["../../src/panel-rbac/update-access-level.dto.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,qBAAa,oBAAoB;IAM/B,IAAI,CAAC,EAAE,MAAM,CAAC;IAMd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAK5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IASnB,eAAe,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC7C"}

package/dist/panel-rbac/update-access-level.dto.js

@@ -0,0 +1,54 @@
+"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.UpdateAccessLevelDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const dashboard_layout_dto_1 = require("./dashboard-layout.dto");
+class UpdateAccessLevelDto {
+    name;
+    description;
+    isActive;
+    dashboardLayout;
+}
+exports.UpdateAccessLevelDto = UpdateAccessLevelDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], UpdateAccessLevelDto.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", Object)
+], UpdateAccessLevelDto.prototype, "description", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateAccessLevelDto.prototype, "isActive", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Layout do dashboard para utilizadores deste nível (master).',
+        type: dashboard_layout_dto_1.DashboardLayoutDto,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => dashboard_layout_dto_1.DashboardLayoutDto),
+    __metadata("design:type", Object)
+], UpdateAccessLevelDto.prototype, "dashboardLayout", void 0);

package/package.json

@@ -1,29 +1,29 @@
-{
-  "name": "tychat-contracts",
-  "version": "1.6.8",
-  "description": "DTOs compartilhados com class-validator (API e microserviços)",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "private": false,
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.1",
-    "ioredis": "^5.10.0",
-    "jest": "^30.3.0",
-    "reflect-metadata": "*"
-  },
-  "devDependencies": {
-    "@nestjs/swagger": "^11.2.6",
-    "@types/jest": "^30.0.0",
-    "ts-jest": "^29.4.9",
-    "typescript": "^5.7.3"
-  },
-  "peerDependencies": {
-    "@nestjs/swagger": "^11.2.6",
-    "reflect-metadata": "*"
-  }
-}
+{
+  "name": "tychat-contracts",
+  "version": "1.6.11",
+  "description": "DTOs compartilhados com class-validator (API e microserviços)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "private": false,
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.1",
+    "ioredis": "^5.10.0",
+    "jest": "^30.3.0",
+    "reflect-metadata": "*"
+  },
+  "devDependencies": {
+    "@nestjs/swagger": "^11.2.6",
+    "@types/jest": "^30.0.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.7.3"
+  },
+  "peerDependencies": {
+    "@nestjs/swagger": "^11.2.6",
+    "reflect-metadata": "*"
+  }
+}

package/src/analytics/analytics-kafka-topics.ts

@@ -1,24 +1,24 @@
-/**
- * Kafka topic names used by the analytics service.
- */
-
-/** Topic for ingesting analytic events from all microservices. */
-export const TOPIC_ANALYTICS_EVENT = 'analytics.event';
-
-/** Topic for requesting a report grouped by event type and period. */
-export const TOPIC_ANALYTICS_REPORT = 'analytics.report';
-
-/** Topic for requesting a dashboard summary (counts per domain). */
-export const TOPIC_ANALYTICS_DASHBOARD = 'analytics.dashboard';
-
-/** Topic for requesting a time-series breakdown of events. */
-export const TOPIC_ANALYTICS_TIMESERIES = 'analytics.timeseries';
-
-/** Topic for requesting event details with pagination. */
-export const TOPIC_ANALYTICS_EVENTS_LIST = 'analytics.events.list';
-
-/** Topic for ingesting tenant user-action audit rows (dedicated table). */
-export const TOPIC_ANALYTICS_TENANT_AUDIT_INGEST = 'analytics.tenant_audit.ingest';
-
-/** Topic for paginated tenant audit log listing. */
-export const TOPIC_ANALYTICS_TENANT_AUDIT_LIST = 'analytics.tenant_audit.list';
+/**
+ * Kafka topic names used by the analytics service.
+ */
+
+/** Topic for ingesting analytic events from all microservices. */
+export const TOPIC_ANALYTICS_EVENT = 'analytics.event';
+
+/** Topic for requesting a report grouped by event type and period. */
+export const TOPIC_ANALYTICS_REPORT = 'analytics.report';
+
+/** Topic for requesting a dashboard summary (counts per domain). */
+export const TOPIC_ANALYTICS_DASHBOARD = 'analytics.dashboard';
+
+/** Topic for requesting a time-series breakdown of events. */
+export const TOPIC_ANALYTICS_TIMESERIES = 'analytics.timeseries';
+
+/** Topic for requesting event details with pagination. */
+export const TOPIC_ANALYTICS_EVENTS_LIST = 'analytics.events.list';
+
+/** Topic for ingesting tenant user-action audit rows (dedicated table). */
+export const TOPIC_ANALYTICS_TENANT_AUDIT_INGEST = 'analytics.tenant_audit.ingest';
+
+/** Topic for paginated tenant audit log listing. */
+export const TOPIC_ANALYTICS_TENANT_AUDIT_LIST = 'analytics.tenant_audit.list';

package/src/analytics/create-tenant-audit-log.dto.ts

@@ -1,105 +1,105 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import {
-  IsIn,
-  IsInt,
-  IsISO8601,
-  IsNotEmpty,
-  IsObject,
-  IsOptional,
-  IsString,
-  IsUUID,
-  Max,
-  MaxLength,
-  Min,
-  MinLength,
-} from 'class-validator';
-
-/** Outcome of the audited HTTP mutation. */
-export const TENANT_AUDIT_OUTCOMES = ['success', 'failure'] as const;
-export type TenantAuditOutcome = (typeof TENANT_AUDIT_OUTCOMES)[number];
-
-/**
- * Payload for persisting a tenant-scoped user action audit row (HTTP mutation).
- */
-export class CreateTenantAuditLogDto {
-  @ApiProperty({ description: 'Unique id for idempotent insert', format: 'uuid' })
-  @IsUUID()
-  eventId: string;
-
-  @ApiProperty({ description: 'Tenant slug' })
-  @IsString()
-  @IsNotEmpty()
-  @MinLength(1)
-  @MaxLength(255)
-  tenant: string;
-
-  @ApiProperty({ example: 'user', description: 'Actor category' })
-  @IsString()
-  @IsNotEmpty()
-  @MaxLength(64)
-  actorType: string;
-
-  @ApiProperty({ description: 'Authenticated user id (sub)' })
-  @IsString()
-  @IsNotEmpty()
-  @MaxLength(255)
-  actorId: string;
-
-  @ApiProperty({
-    example: 'http.mutation',
-    description: 'Deterministic action key (e.g. http.mutation)',
-  })
-  @IsString()
-  @IsNotEmpty()
-  @MaxLength(128)
-  action: string;
-
-  @ApiPropertyOptional({ example: 'http' })
-  @IsOptional()
-  @IsString()
-  @MaxLength(64)
-  targetType?: string | null;
-
-  @ApiPropertyOptional({ description: 'Route param id when present' })
-  @IsOptional()
-  @IsString()
-  @MaxLength(255)
-  targetId?: string | null;
-
-  @ApiProperty({ enum: TENANT_AUDIT_OUTCOMES })
-  @IsIn([...TENANT_AUDIT_OUTCOMES])
-  outcome: TenantAuditOutcome;
-
-  @ApiProperty({ example: 'POST' })
-  @IsString()
-  @IsNotEmpty()
-  @MaxLength(16)
-  httpMethod: string;
-
-  @ApiProperty({ example: '/patients/123' })
-  @IsString()
-  @IsNotEmpty()
-  @MaxLength(2048)
-  httpPath: string;
-
-  @ApiProperty({ example: 201 })
-  @IsInt()
-  @Min(100)
-  @Max(599)
-  httpStatus: number;
-
-  @ApiPropertyOptional({ description: 'On failure, stable error code if available' })
-  @IsOptional()
-  @IsString()
-  @MaxLength(128)
-  errorCode?: string | null;
-
-  @ApiPropertyOptional({ description: 'Minimal non-PII context' })
-  @IsOptional()
-  @IsObject()
-  metadata?: Record<string, unknown> | null;
-
-  @ApiProperty({ description: 'When the action completed (UTC ISO-8601)' })
-  @IsISO8601()
-  occurredAt: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsIn,
+  IsInt,
+  IsISO8601,
+  IsNotEmpty,
+  IsObject,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Max,
+  MaxLength,
+  Min,
+  MinLength,
+} from 'class-validator';
+
+/** Outcome of the audited HTTP mutation. */
+export const TENANT_AUDIT_OUTCOMES = ['success', 'failure'] as const;
+export type TenantAuditOutcome = (typeof TENANT_AUDIT_OUTCOMES)[number];
+
+/**
+ * Payload for persisting a tenant-scoped user action audit row (HTTP mutation).
+ */
+export class CreateTenantAuditLogDto {
+  @ApiProperty({ description: 'Unique id for idempotent insert', format: 'uuid' })
+  @IsUUID()
+  eventId: string;
+
+  @ApiProperty({ description: 'Tenant slug' })
+  @IsString()
+  @IsNotEmpty()
+  @MinLength(1)
+  @MaxLength(255)
+  tenant: string;
+
+  @ApiProperty({ example: 'user', description: 'Actor category' })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(64)
+  actorType: string;
+
+  @ApiProperty({ description: 'Authenticated user id (sub)' })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  actorId: string;
+
+  @ApiProperty({
+    example: 'http.mutation',
+    description: 'Deterministic action key (e.g. http.mutation)',
+  })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(128)
+  action: string;
+
+  @ApiPropertyOptional({ example: 'http' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(64)
+  targetType?: string | null;
+
+  @ApiPropertyOptional({ description: 'Route param id when present' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(255)
+  targetId?: string | null;
+
+  @ApiProperty({ enum: TENANT_AUDIT_OUTCOMES })
+  @IsIn([...TENANT_AUDIT_OUTCOMES])
+  outcome: TenantAuditOutcome;
+
+  @ApiProperty({ example: 'POST' })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(16)
+  httpMethod: string;
+
+  @ApiProperty({ example: '/patients/123' })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(2048)
+  httpPath: string;
+
+  @ApiProperty({ example: 201 })
+  @IsInt()
+  @Min(100)
+  @Max(599)
+  httpStatus: number;
+
+  @ApiPropertyOptional({ description: 'On failure, stable error code if available' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(128)
+  errorCode?: string | null;
+
+  @ApiPropertyOptional({ description: 'Minimal non-PII context' })
+  @IsOptional()
+  @IsObject()
+  metadata?: Record<string, unknown> | null;
+
+  @ApiProperty({ description: 'When the action completed (UTC ISO-8601)' })
+  @IsISO8601()
+  occurredAt: string;
+}

package/src/analytics/index.ts

@@ -1,8 +1,8 @@
-export * from './event-analytic.enum';
-export * from './followup-analytic-event-type.util';
-export * from './create-analytic-event.dto';
-export * from './create-tenant-audit-log.dto';
-export * from './list-tenant-audit-logs-query.dto';
-export * from './analytics-query.dto';
-export * from './analytics-kafka-topics';
-export * from './analytics-emitter.helper';
+export * from './event-analytic.enum';
+export * from './followup-analytic-event-type.util';
+export * from './create-analytic-event.dto';
+export * from './create-tenant-audit-log.dto';
+export * from './list-tenant-audit-logs-query.dto';
+export * from './analytics-query.dto';
+export * from './analytics-kafka-topics';
+export * from './analytics-emitter.helper';

package/src/analytics/list-tenant-audit-logs-query.dto.ts

@@ -1,45 +1,45 @@
-import { ApiPropertyOptional } from '@nestjs/swagger';
-import { Type } from 'class-transformer';
-import { IsInt, IsOptional, Max, Min } from 'class-validator';
-import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
-
-/**
- * Allowed tenant_audit_logs columns for filtering (camelCase API keys).
- */
-export const TENANT_AUDIT_LIST_FILTER_KEYS = [
-  'actorId',
-  'action',
-  'outcome',
-  'httpMethod',
-  'httpPath',
-  'httpStatus',
-  'occurredAt',
-] as const;
-export type TenantAuditListFilterKeyDto = (typeof TENANT_AUDIT_LIST_FILTER_KEYS)[number];
-
-export class ListTenantAuditLogsQueryDto {
-  @ApiPropertyOptional({ example: 1, minimum: 1, default: 1 })
-  @IsOptional()
-  @Type(() => Number)
-  @IsInt()
-  @Min(1)
-  page?: number;
-
-  @ApiPropertyOptional({ example: 20, minimum: 1, maximum: 100, default: 20 })
-  @IsOptional()
-  @Type(() => Number)
-  @IsInt()
-  @Min(1)
-  @Max(100)
-  limit?: number;
-
-  @ApiPropertyOptional({
-    description:
-      'JSON string with an array of filter objects `{ key, op, value }`. ' +
-      'Example: `[{"key":"outcome","op":"==","value":"success"}]`.',
-    type: String,
-    example: '[{"key":"outcome","op":"==","value":"success"}]',
-  })
-  @IsOptional()
-  filters?: ParsedFilterDto[];
-}
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import { IsInt, IsOptional, Max, Min } from 'class-validator';
+import type { ParsedFilterDto } from '../filters/parsed-filter.dto';
+
+/**
+ * Allowed tenant_audit_logs columns for filtering (camelCase API keys).
+ */
+export const TENANT_AUDIT_LIST_FILTER_KEYS = [
+  'actorId',
+  'action',
+  'outcome',
+  'httpMethod',
+  'httpPath',
+  'httpStatus',
+  'occurredAt',
+] as const;
+export type TenantAuditListFilterKeyDto = (typeof TENANT_AUDIT_LIST_FILTER_KEYS)[number];
+
+export class ListTenantAuditLogsQueryDto {
+  @ApiPropertyOptional({ example: 1, minimum: 1, default: 1 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  @ApiPropertyOptional({ example: 20, minimum: 1, maximum: 100, default: 20 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  @Max(100)
+  limit?: number;
+
+  @ApiPropertyOptional({
+    description:
+      'JSON string with an array of filter objects `{ key, op, value }`. ' +
+      'Example: `[{"key":"outcome","op":"==","value":"success"}]`.',
+    type: String,
+    example: '[{"key":"outcome","op":"==","value":"success"}]',
+  })
+  @IsOptional()
+  filters?: ParsedFilterDto[];
+}