@hed-hog/finance 0.0.349 → 0.0.351

package/src/dto/create-financial-title.dto.ts

@@ -3,15 +3,33 @@ import { Type } from 'class-transformer';
 import {
     IsArray,
     IsDateString,
+    IsIn,
     IsInt,
     IsNotEmpty,
     IsNumber,
     IsOptional,
     IsString,
+    Max,
     Min,
     ValidateNested,
 } from 'class-validator';
 
+export class CreateRecurrenceRuleDto {
+  @IsString()
+  @IsIn(['weekly', 'biweekly', 'monthly', 'bimonthly', 'quarterly', 'semiannual', 'annual'])
+  frequency: string;
+
+  @IsOptional()
+  @IsDateString()
+  end_date?: string;
+
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  @Max(600)
+  max_occurrences?: number;
+}
+
 export class CreateFinancialInstallmentDto {
   @IsOptional()
   @IsInt({
@@ -151,4 +169,9 @@ export class CreateFinancialTitleDto {
       getLocaleText('validation.attachmentFileIdMustBeNumber', args.value),
   })
   attachment_file_ids?: number[];
+
+  @IsOptional()
+  @ValidateNested()
+  @Type(() => CreateRecurrenceRuleDto)
+  recurrence_rule?: CreateRecurrenceRuleDto;
 }

package/src/finance-realtime.controller.ts

@@ -0,0 +1,12 @@
+import { Controller, Get } from '@nestjs/common';
+import { FinanceRealtimeCursor, FinanceRealtimeService } from './finance-realtime.service';
+
+@Controller('finance/realtime')
+export class FinanceRealtimeController {
+  constructor(private readonly financeRealtime: FinanceRealtimeService) {}
+
+  @Get('cursor')
+  getCursor(): FinanceRealtimeCursor {
+    return this.financeRealtime.getCursor();
+  }
+}

package/src/finance-realtime.service.ts

@@ -0,0 +1,106 @@
+import { Injectable } from '@nestjs/common';
+
+export type FinanceRealtimeDomain =
+  | 'installment'
+  | 'settlement'
+  | 'bank_account'
+  | 'bank_statement'
+  | 'bank_reconciliation'
+  | 'category'
+  | 'cost_center'
+  | 'currency'
+  | 'transfer'
+  | 'period_close'
+  | 'collection'
+  | 'tag';
+
+export type FinanceRealtimeEventType =
+  | 'created'
+  | 'updated'
+  | 'deleted'
+  | 'approved'
+  | 'rejected'
+  | 'canceled'
+  | 'settled'
+  | 'reversed'
+  | 'imported'
+  | 'moved';
+
+export type FinanceRealtimeEvent = {
+  version: 'finance-realtime-v1';
+  eventId: string;
+  cursor: number;
+  occurredAt: string;
+  domain: FinanceRealtimeDomain;
+  type: FinanceRealtimeEventType;
+  entityId?: number | null;
+  actorId?: number | null;
+  payload?: Record<string, unknown>;
+};
+
+export type FinanceRealtimeEventPayload = {
+  domain: FinanceRealtimeDomain;
+  type: FinanceRealtimeEventType;
+  entityId?: number | null;
+  actorId?: number | null;
+  payload?: Record<string, unknown>;
+};
+
+export type FinanceRealtimeCursor = {
+  cursor: number;
+  updatedAt: string | null;
+};
+
+type FinanceRealtimeListener = {
+  onEvent: (event: FinanceRealtimeEvent) => void;
+};
+
+@Injectable()
+export class FinanceRealtimeService {
+  private static readonly EVENT_RETENTION_LIMIT = 500;
+
+  private sequence = 0;
+  private updatedAt: string | null = null;
+  private readonly eventLog: FinanceRealtimeEvent[] = [];
+  private readonly listeners = new Map<number, FinanceRealtimeListener>();
+  private listenerSequence = 0;
+
+  publish(event: FinanceRealtimeEventPayload): FinanceRealtimeCursor {
+    const nextCursor = ++this.sequence;
+    const occurredAt = new Date().toISOString();
+    this.updatedAt = occurredAt;
+
+    const realtimeEvent: FinanceRealtimeEvent = {
+      version: 'finance-realtime-v1',
+      eventId: String(nextCursor),
+      cursor: nextCursor,
+      occurredAt,
+      domain: event.domain,
+      type: event.type,
+      entityId: event.entityId ?? null,
+      actorId: event.actorId ?? null,
+      payload: event.payload,
+    };
+
+    this.eventLog.push(realtimeEvent);
+    if (this.eventLog.length > FinanceRealtimeService.EVENT_RETENTION_LIMIT) {
+      this.eventLog.splice(0, this.eventLog.length - FinanceRealtimeService.EVENT_RETENTION_LIMIT);
+    }
+
+    for (const listener of this.listeners.values()) {
+      listener.onEvent(realtimeEvent);
+    }
+
+    return { cursor: nextCursor, updatedAt: this.updatedAt };
+  }
+
+  getCursor(): FinanceRealtimeCursor {
+    return { cursor: this.sequence, updatedAt: this.updatedAt };
+  }
+
+  subscribe(onEvent: (event: FinanceRealtimeEvent) => void): () => void {
+    const id = ++this.listenerSequence;
+    this.listeners.set(id, { onEvent });
+    return () => this.listeners.delete(id);
+  }
+}

package/src/finance.module.ts

@@ -18,7 +18,21 @@ import { FinanceStatementsController } from './finance-statements.controller';
 import { FinanceTransfersController } from './finance-transfers.controller';
 import { FinanceContractActivatedSubscriber } from './finance.contract-activated.subscriber';
 import { FinanceIntegrationExampleSubscriber } from './finance.integration-example.subscriber';
+import { FinanceRealtimeController } from './finance-realtime.controller';
+import { FinanceRealtimeService } from './finance-realtime.service';
 import { FinanceService } from './finance.service';
+import { FinanceAuditLogsMcpTools } from './mcp-tools/finance-audit-logs.mcp-tools';
+import { FinanceBankAccountsMcpTools } from './mcp-tools/finance-bank-accounts.mcp-tools';
+import { FinanceCategoriesMcpTools } from './mcp-tools/finance-categories.mcp-tools';
+import { FinanceCollectionsMcpTools } from './mcp-tools/finance-collections.mcp-tools';
+import { FinanceCostCentersMcpTools } from './mcp-tools/finance-cost-centers.mcp-tools';
+import { FinanceCurrenciesMcpTools } from './mcp-tools/finance-currencies.mcp-tools';
+import { FinanceDataMcpTools } from './mcp-tools/finance-data.mcp-tools';
+import { FinanceInstallmentsMcpTools } from './mcp-tools/finance-installments.mcp-tools';
+import { FinancePeriodCloseMcpTools } from './mcp-tools/finance-period-close.mcp-tools';
+import { FinanceReportsMcpTools } from './mcp-tools/finance-reports.mcp-tools';
+import { FinanceStatementsMcpTools } from './mcp-tools/finance-statements.mcp-tools';
+import { FinanceTransfersMcpTools } from './mcp-tools/finance-transfers.mcp-tools';
 
 @Module({
   imports: [
@@ -31,6 +45,7 @@ import { FinanceService } from './finance.service';
     forwardRef(() => IntegrationModule),
   ],
   controllers: [
+    FinanceRealtimeController,
     FinanceAuditLogsController,
     FinanceDataController,
     FinanceInstallmentsController,
@@ -45,9 +60,22 @@ import { FinanceService } from './finance.service';
     FinanceTransfersController,
   ],
   providers: [
+    FinanceRealtimeService,
     FinanceService,
     FinanceIntegrationExampleSubscriber,
     FinanceContractActivatedSubscriber,
+    FinanceAuditLogsMcpTools,
+    FinanceBankAccountsMcpTools,
+    FinanceCategoriesMcpTools,
+    FinanceCollectionsMcpTools,
+    FinanceCostCentersMcpTools,
+    FinanceCurrenciesMcpTools,
+    FinanceDataMcpTools,
+    FinanceInstallmentsMcpTools,
+    FinancePeriodCloseMcpTools,
+    FinanceReportsMcpTools,
+    FinanceStatementsMcpTools,
+    FinanceTransfersMcpTools,
   ],
   exports: [FinanceService],
 })