tychat-contracts 1.6.7 → 1.6.9

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[];
+}