@hed-hog/finance 0.0.295 → 0.0.297

package/dist/finance-data.controller.d.ts

@@ -123,13 +123,13 @@ export declare class FinanceDataController {
             codigo: string;
             nome: string;
             natureza: string;
-            status: import(".prisma/client").$Enums.finance_category_status_enum;
+            status: import("@prisma/client").$Enums.finance_category_status_1c70701ad1_enum;
         }[];
         centrosCusto: {
             id: string;
             codigo: string;
             nome: string;
-            status: import(".prisma/client").$Enums.cost_center_status_enum;
+            status: import("@prisma/client").$Enums.cost_center_status_9f38769d0c_enum;
         }[];
         aprovacoesPendentes: {
             id: string;

package/dist/finance.integration-example.subscriber.d.ts

@@ -0,0 +1,11 @@
+import { IntegrationDeveloperApiService } from '@hed-hog/core';
+import { OnModuleInit } from '@nestjs/common';
+import { FinanceService } from './finance.service';
+export declare class FinanceIntegrationExampleSubscriber implements OnModuleInit {
+    private readonly integrationApi;
+    private readonly financeService;
+    private readonly logger;
+    constructor(integrationApi: IntegrationDeveloperApiService, financeService: FinanceService);
+    onModuleInit(): void;
+}
+//# sourceMappingURL=finance.integration-example.subscriber.d.ts.map

package/dist/finance.integration-example.subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finance.integration-example.subscriber.d.ts","sourceRoot":"","sources":["../src/finance.integration-example.subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,8BAA8B,EAEjC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmBnD,qBACa,mCAAoC,YAAW,YAAY;IAIpE,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAJjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwD;gBAG5D,cAAc,EAAE,8BAA8B,EAC9C,cAAc,EAAE,cAAc;IAGjD,YAAY,IAAI,IAAI;CAwFrB"}

package/dist/finance.integration-example.subscriber.js

@@ -0,0 +1,100 @@
+"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);
+};
+var FinanceIntegrationExampleSubscriber_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FinanceIntegrationExampleSubscriber = void 0;
+const core_1 = require("@hed-hog/core");
+const common_1 = require("@nestjs/common");
+const finance_service_1 = require("./finance.service");
+let FinanceIntegrationExampleSubscriber = FinanceIntegrationExampleSubscriber_1 = class FinanceIntegrationExampleSubscriber {
+    constructor(integrationApi, financeService) {
+        this.integrationApi = integrationApi;
+        this.financeService = financeService;
+        this.logger = new common_1.Logger(FinanceIntegrationExampleSubscriber_1.name);
+    }
+    onModuleInit() {
+        this.integrationApi.subscribe({
+            eventName: 'operations.accounts_payable.requested',
+            consumerName: 'finance.accounts-payable-reference',
+            priority: 0,
+            handler: async (event) => {
+                var _a, _b, _c, _d;
+                const payload = (event.payload || {});
+                const sourceEntityType = String(payload.sourceEntityType || event.aggregateType || '').trim() ||
+                    'operations_payable_request';
+                const sourceEntityId = String(payload.sourceEntityId || event.aggregateId || '').trim() ||
+                    event.aggregateId;
+                const existingLinks = await this.integrationApi.findLinksBySource({
+                    module: event.sourceModule,
+                    entityType: sourceEntityType,
+                    entityId: sourceEntityId,
+                });
+                const alreadyLinked = existingLinks.some((link) => link.targetModule === 'finance' &&
+                    link.targetEntityType === 'financial_title');
+                if (alreadyLinked) {
+                    this.logger.debug(`Skipping duplicate payable integration for ${sourceEntityType}:${sourceEntityId}`);
+                    return;
+                }
+                const payable = payload.payable || {};
+                const personId = Number(payable.personId);
+                const totalAmount = Number(payable.totalAmount);
+                const dueDate = String(payable.dueDate || '').trim();
+                const documentNumber = String(payable.documentNumber || '').trim();
+                const locale = String(payload.locale || '').trim() || 'en';
+                if (!Number.isInteger(personId) || personId <= 0) {
+                    throw new Error('Invalid payable.personId for integration event.');
+                }
+                if (!Number.isFinite(totalAmount) || totalAmount <= 0) {
+                    throw new Error('Invalid payable.totalAmount for integration event.');
+                }
+                if (!dueDate || Number.isNaN(new Date(dueDate).getTime())) {
+                    throw new Error('Invalid payable.dueDate for integration event.');
+                }
+                if (!documentNumber) {
+                    throw new Error('payable.documentNumber is required for integration event.');
+                }
+                const createdTitle = await this.financeService.createAccountsPayableTitle({
+                    person_id: personId,
+                    due_date: dueDate,
+                    total_amount: totalAmount,
+                    document_number: documentNumber,
+                    description: (_a = payable.description) !== null && _a !== void 0 ? _a : undefined,
+                    payment_channel: (_b = payable.paymentChannel) !== null && _b !== void 0 ? _b : undefined,
+                    finance_category_id: (_c = payable.financeCategoryId) !== null && _c !== void 0 ? _c : undefined,
+                    cost_center_id: (_d = payable.costCenterId) !== null && _d !== void 0 ? _d : undefined,
+                }, locale, Number(payload.requestedByUserId) || undefined);
+                const targetEntityId = String((createdTitle === null || createdTitle === void 0 ? void 0 : createdTitle.id) || '').trim();
+                if (!targetEntityId) {
+                    throw new Error('Could not resolve target financial title id.');
+                }
+                await this.integrationApi.createLink({
+                    sourceModule: event.sourceModule,
+                    sourceEntityType,
+                    sourceEntityId,
+                    targetModule: 'finance',
+                    targetEntityType: 'financial_title',
+                    targetEntityId,
+                    linkType: core_1.LinkType.REFERENCE,
+                    metadata: {
+                        eventName: event.eventName,
+                    },
+                });
+            },
+        });
+    }
+};
+exports.FinanceIntegrationExampleSubscriber = FinanceIntegrationExampleSubscriber;
+exports.FinanceIntegrationExampleSubscriber = FinanceIntegrationExampleSubscriber = FinanceIntegrationExampleSubscriber_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.IntegrationDeveloperApiService,
+        finance_service_1.FinanceService])
+], FinanceIntegrationExampleSubscriber);
+//# sourceMappingURL=finance.integration-example.subscriber.js.map

package/dist/finance.integration-example.subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finance.integration-example.subscriber.js","sourceRoot":"","sources":["../src/finance.integration-example.subscriber.ts"],"names":[],"mappings":"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"}

package/dist/finance.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finance.module.d.ts","sourceRoot":"","sources":["../src/finance.module.ts"],"names":[],"mappings":"AAmBA,qBAyBa,aAAa;CAAG"}
+{"version":3,"file":"finance.module.d.ts","sourceRoot":"","sources":["../src/finance.module.ts"],"names":[],"mappings":"AAoBA,qBA0Ba,aAAa;CAAG"}

package/dist/finance.module.js

@@ -24,6 +24,7 @@ const finance_period_close_controller_1 = require("./finance-period-close.contro
 const finance_reports_controller_1 = require("./finance-reports.controller");
 const finance_statements_controller_1 = require("./finance-statements.controller");
 const finance_transfers_controller_1 = require("./finance-transfers.controller");
+const finance_integration_example_subscriber_1 = require("./finance.integration-example.subscriber");
 const finance_service_1 = require("./finance.service");
 let FinanceModule = class FinanceModule {
 };
@@ -37,6 +38,7 @@ exports.FinanceModule = FinanceModule = __decorate([
             (0, common_1.forwardRef)(() => api_locale_1.LocaleModule),
             (0, common_1.forwardRef)(() => core_1.AiModule),
             (0, common_1.forwardRef)(() => core_1.FileModule),
+            (0, common_1.forwardRef)(() => core_1.IntegrationModule),
         ],
         controllers: [
             finance_audit_logs_controller_1.FinanceAuditLogsController,
@@ -51,7 +53,7 @@ exports.FinanceModule = FinanceModule = __decorate([
             finance_statements_controller_1.FinanceStatementsController,
             finance_transfers_controller_1.FinanceTransfersController,
         ],
-        providers: [finance_service_1.FinanceService],
+        providers: [finance_service_1.FinanceService, finance_integration_example_subscriber_1.FinanceIntegrationExampleSubscriber],
         exports: [finance_service_1.FinanceService],
     })
 ], FinanceModule);

package/dist/finance.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"finance.module.js","sourceRoot":"","sources":["../src/finance.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,4DAA2D;AAC3D,oDAAmD;AACnD,wCAAqD;AACrD,2CAAoD;AACpD,2CAA8C;AAC9C,mFAA6E;AAC7E,yFAAmF;AACnF,mFAA8E;AAC9E,qFAAgF;AAChF,uFAAiF;AACjF,uEAAkE;AAClE,uFAAkF;AAClF,uFAAiF;AACjF,6EAAwE;AACxE,mFAA8E;AAC9E,iFAA4E;AAC5E,uDAAmD;AA2B5C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IAzBzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY,CAAC,OAAO,EAAE;YACtB,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iCAAgB,CAAC;YAClC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,eAAQ,CAAC;YAC1B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iBAAU,CAAC;SAC7B;QACD,WAAW,EAAE;YACX,0DAA0B;YAC1B,+CAAqB;YACrB,+DAA6B;YAC7B,qDAAwB;YACxB,gEAA6B;YAC7B,2DAA2B;YAC3B,6DAA4B;YAC5B,8DAA4B;YAC5B,8DAA4B;YAC5B,2DAA2B;YAC3B,yDAA0B;SAC3B;QACD,SAAS,EAAE,CAAC,gCAAc,CAAC;QAC3B,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}
+{"version":3,"file":"finance.module.js","sourceRoot":"","sources":["../src/finance.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,4DAA2D;AAC3D,oDAAmD;AACnD,wCAAwE;AACxE,2CAAoD;AACpD,2CAA8C;AAC9C,mFAA6E;AAC7E,yFAAmF;AACnF,mFAA8E;AAC9E,qFAAgF;AAChF,uFAAiF;AACjF,uEAAkE;AAClE,uFAAkF;AAClF,uFAAiF;AACjF,6EAAwE;AACxE,mFAA8E;AAC9E,iFAA4E;AAC5E,qGAA+F;AAC/F,uDAAmD;AA4B5C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IA1BzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,qBAAY,CAAC,OAAO,EAAE;YACtB,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iCAAgB,CAAC;YAClC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC;YAC9B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,eAAQ,CAAC;YAC1B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,iBAAU,CAAC;YAC5B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAiB,CAAC;SACpC;QACD,WAAW,EAAE;YACX,0DAA0B;YAC1B,+CAAqB;YACrB,+DAA6B;YAC7B,qDAAwB;YACxB,gEAA6B;YAC7B,2DAA2B;YAC3B,6DAA4B;YAC5B,8DAA4B;YAC5B,8DAA4B;YAC5B,2DAA2B;YAC3B,yDAA0B;SAC3B;QACD,SAAS,EAAE,CAAC,gCAAc,EAAE,4EAAmC,CAAC;QAChE,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}

package/dist/finance.service.d.ts

@@ -197,13 +197,13 @@ export declare class FinanceService {
             codigo: string;
             nome: string;
             natureza: string;
-            status: import(".prisma/client").$Enums.finance_category_status_enum;
+            status: import("@prisma/client").$Enums.finance_category_status_1c70701ad1_enum;
         }[];
         centrosCusto: {
             id: string;
             codigo: string;
             nome: string;
-            status: import(".prisma/client").$Enums.cost_center_status_enum;
+            status: import("@prisma/client").$Enums.cost_center_status_9f38769d0c_enum;
         }[];
         aprovacoesPendentes: {
             id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/finance",
-  "version": "0.0.295",
+  "version": "0.0.297",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
@@ -9,14 +9,14 @@
     "@nestjs/core": "^11",
     "@nestjs/jwt": "^11",
     "@nestjs/mapped-types": "*",
-    "@hed-hog/api": "0.0.4",
-    "@hed-hog/api-locale": "0.0.13",
-    "@hed-hog/contact": "0.0.295",
-    "@hed-hog/api-prisma": "0.0.5",
+    "@hed-hog/api": "0.0.6",
+    "@hed-hog/contact": "0.0.297",
+    "@hed-hog/tag": "0.0.297",
+    "@hed-hog/api-prisma": "0.0.6",
+    "@hed-hog/api-locale": "0.0.14",
+    "@hed-hog/core": "0.0.297",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/api-pagination": "0.0.6",
-    "@hed-hog/core": "0.0.295",
-    "@hed-hog/tag": "0.0.295"
+    "@hed-hog/api-pagination": "0.0.7"
   },
   "exports": {
     ".": {
@@ -32,7 +32,7 @@
   ],
   "scripts": {
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\"",
-    "prebuild": "pnpm exec ts-node ../../scripts/build-dependencies.ts libraries/finance",
+    "prebuild": "pnpm --dir ../.. exec ts-node ./scripts/build-dependencies.ts libraries/finance",
     "build": "tsc --project tsconfig.production.json",
     "patch": "pnpm exec ts-node ../../scripts/patch.ts libraries/finance",
     "prod": "pnpm run patch && pnpm run build && pnpm publish --access public --no-git-checks"

package/src/finance.integration-example.subscriber.ts

@@ -0,0 +1,122 @@
+import {
+    IntegrationDeveloperApiService,
+    LinkType,
+} from '@hed-hog/core';
+import { Injectable, Logger, OnModuleInit } from '@nestjs/common';
+import { FinanceService } from './finance.service';
+
+type AccountsPayableEventPayload = {
+  sourceEntityType?: string;
+  sourceEntityId?: string;
+  locale?: string;
+  requestedByUserId?: number;
+  payable?: {
+    personId?: number;
+    dueDate?: string;
+    totalAmount?: number;
+    documentNumber?: string;
+    description?: string | null;
+    paymentChannel?: string | null;
+    financeCategoryId?: number | null;
+    costCenterId?: number | null;
+  };
+};
+
+@Injectable()
+export class FinanceIntegrationExampleSubscriber implements OnModuleInit {
+  private readonly logger = new Logger(FinanceIntegrationExampleSubscriber.name);
+
+  constructor(
+    private readonly integrationApi: IntegrationDeveloperApiService,
+    private readonly financeService: FinanceService,
+  ) {}
+
+  onModuleInit(): void {
+    this.integrationApi.subscribe({
+      eventName: 'operations.accounts_payable.requested',
+      consumerName: 'finance.accounts-payable-reference',
+      priority: 0,
+      handler: async (event) => {
+        const payload = (event.payload || {}) as AccountsPayableEventPayload;
+        const sourceEntityType =
+          String(payload.sourceEntityType || event.aggregateType || '').trim() ||
+          'operations_payable_request';
+        const sourceEntityId =
+          String(payload.sourceEntityId || event.aggregateId || '').trim() ||
+          event.aggregateId;
+
+        const existingLinks = await this.integrationApi.findLinksBySource({
+          module: event.sourceModule,
+          entityType: sourceEntityType,
+          entityId: sourceEntityId,
+        });
+
+        const alreadyLinked = existingLinks.some(
+          (link) =>
+            link.targetModule === 'finance' &&
+            link.targetEntityType === 'financial_title',
+        );
+
+        if (alreadyLinked) {
+          this.logger.debug(
+            `Skipping duplicate payable integration for ${sourceEntityType}:${sourceEntityId}`,
+          );
+          return;
+        }
+
+        const payable = payload.payable || {};
+        const personId = Number(payable.personId);
+        const totalAmount = Number(payable.totalAmount);
+        const dueDate = String(payable.dueDate || '').trim();
+        const documentNumber = String(payable.documentNumber || '').trim();
+        const locale = String(payload.locale || '').trim() || 'en';
+
+        if (!Number.isInteger(personId) || personId <= 0) {
+          throw new Error('Invalid payable.personId for integration event.');
+        }
+        if (!Number.isFinite(totalAmount) || totalAmount <= 0) {
+          throw new Error('Invalid payable.totalAmount for integration event.');
+        }
+        if (!dueDate || Number.isNaN(new Date(dueDate).getTime())) {
+          throw new Error('Invalid payable.dueDate for integration event.');
+        }
+        if (!documentNumber) {
+          throw new Error('payable.documentNumber is required for integration event.');
+        }
+
+        const createdTitle = await this.financeService.createAccountsPayableTitle(
+          {
+            person_id: personId,
+            due_date: dueDate,
+            total_amount: totalAmount,
+            document_number: documentNumber,
+            description: payable.description ?? undefined,
+            payment_channel: payable.paymentChannel ?? undefined,
+            finance_category_id: payable.financeCategoryId ?? undefined,
+            cost_center_id: payable.costCenterId ?? undefined,
+          },
+          locale,
+          Number(payload.requestedByUserId) || undefined,
+        );
+
+        const targetEntityId = String(createdTitle?.id || '').trim();
+        if (!targetEntityId) {
+          throw new Error('Could not resolve target financial title id.');
+        }
+
+        await this.integrationApi.createLink({
+          sourceModule: event.sourceModule,
+          sourceEntityType,
+          sourceEntityId,
+          targetModule: 'finance',
+          targetEntityType: 'financial_title',
+          targetEntityId,
+          linkType: LinkType.REFERENCE,
+          metadata: {
+            eventName: event.eventName,
+          },
+        });
+      },
+    });
+  }
+}

package/src/finance.module.ts

@@ -1,7 +1,7 @@
 import { LocaleModule } from '@hed-hog/api-locale';
 import { PaginationModule } from '@hed-hog/api-pagination';
 import { PrismaModule } from '@hed-hog/api-prisma';
-import { AiModule, FileModule } from '@hed-hog/core';
+import { AiModule, FileModule, IntegrationModule } from '@hed-hog/core';
 import { forwardRef, Module } from '@nestjs/common';
 import { ConfigModule } from '@nestjs/config';
 import { FinanceAuditLogsController } from './finance-audit-logs.controller';
@@ -15,6 +15,7 @@ import { FinancePeriodCloseController } from './finance-period-close.controller'
 import { FinanceReportsController } from './finance-reports.controller';
 import { FinanceStatementsController } from './finance-statements.controller';
 import { FinanceTransfersController } from './finance-transfers.controller';
+import { FinanceIntegrationExampleSubscriber } from './finance.integration-example.subscriber';
 import { FinanceService } from './finance.service';
 
 @Module({
@@ -25,6 +26,7 @@ import { FinanceService } from './finance.service';
     forwardRef(() => LocaleModule),
     forwardRef(() => AiModule),
     forwardRef(() => FileModule),
+    forwardRef(() => IntegrationModule),
   ],
   controllers: [
     FinanceAuditLogsController,
@@ -39,7 +41,7 @@ import { FinanceService } from './finance.service';
     FinanceStatementsController,
     FinanceTransfersController,
   ],
-  providers: [FinanceService],
+  providers: [FinanceService, FinanceIntegrationExampleSubscriber],
   exports: [FinanceService],
 })
 export class FinanceModule {}