@freshpointcz/fresh-core 0.0.16 → 0.0.17

package/dist/index.d.mts

@@ -1,6 +1,5 @@
 import dayjs, { Dayjs } from 'dayjs';
-import { Logger } from 'winston';
-import { BaseEntity, ColumnOptions, Repository, EntityTarget, EntityManager, DataSourceOptions } from 'typeorm';
+import { BaseEntity, ColumnOptions, Repository, EntityTarget, EntityManager, ObjectLiteral, EntitySubscriberInterface, InsertEvent, UpdateEvent, SoftRemoveEvent, TransactionCommitEvent, DataSourceOptions } from 'typeorm';
 import { Job } from 'node-schedule';
 import * as _eslint_core from '@eslint/core';
 import * as typescript_eslint_dist_compatibility_types from 'typescript-eslint/dist/compatibility-types';
@@ -54,8 +53,6 @@ declare class SinglePromiseWaiter<T = any> {
     get hasPromise(): boolean;
 }
 
-declare const logger: Logger;
-
 declare function isValidCron(expr: string): boolean;
 
 /**
@@ -348,6 +345,50 @@ declare abstract class FreshDao<T extends BaseEntity> {
     protected getRepo(manager?: EntityManager, entity?: EntityTarget<T>): Repository<T>;
 }
 
+/**
+ * Change event types for entity lifecycle tracking.
+ */
+type EntityChangeEvent = "created" | "updated" | "deleted";
+/**
+ * Abstract base class for TypeORM EntitySubscribers that need to:
+ * 1. Track entity changes (insert/update/soft-remove)
+ * 2. Batch pending notifications within a transaction
+ * 3. Send notifications only after transaction commit
+ *
+ * Subclasses must implement:
+ * - `listenTo()` — target entity class
+ * - `pendingKey` — unique key for storing pending events in `queryRunner.data`
+ * - `subscriberName` — name used in log messages
+ * - `handleNotification(id, changeEvent, manager)` — actual notification logic
+ */
+declare abstract class BaseEntityChangeSubscriber<Entity extends ObjectLiteral, IdType = number> implements EntitySubscriberInterface<Entity> {
+    /**
+     * Unique key used to store pending change events in `queryRunner.data`.
+     * Must be unique per subscriber to avoid collisions when multiple subscribers
+     * share the same queryRunner.
+     */
+    protected abstract readonly PENDING_KEY: string;
+    /**
+     * Human-readable name for log/error messages.
+     */
+    protected abstract readonly SUBSCRIBER_NAME: string;
+    /**
+     * Return the entity class this subscriber listens to.
+     */
+    abstract listenTo(): Function;
+    /**
+     * Implement the actual notification/side-effect logic.
+     * Called after transaction commit (or immediately if no transaction is active).
+     */
+    protected abstract handleNotification(id: IdType, changeEvent: EntityChangeEvent, manager: EntityManager): Promise<void>;
+    afterInsert(event: InsertEvent<Entity>): void;
+    afterUpdate(event: UpdateEvent<Entity>): void;
+    afterSoftRemove(event: SoftRemoveEvent<Entity>): void;
+    afterTransactionCommit(event: TransactionCommitEvent): Promise<void>;
+    private addPending;
+    private sendNotification;
+}
+
 declare class Category extends FreshEntity {
 }
 
@@ -641,4 +682,4 @@ interface HealthCheckResult {
     };
 }
 
-export { AMOUNT_UNIT, ActionCommandCode, ApiError, type CardNumber, Category, DataHelper, DateUtils, type Deferred, DepotPoolStatus, Device, FreshDao, FreshEntity, FreshHyperEntity, FreshJob, FreshTranslationBase, type HealthCheckResult, HttpStatus, LanguageCode, Manufacturer, type Maybe, PaymentMethod, PG_DATA_SOURCE_OPTIONS as PgDataSourceOptions, Product, SinglePromiseWaiter, Singleton, type Status, StatusDto, Subcategory, TimestampColumn, TransactionType, createDeferred, FRESH_ESLINT_CONFIG as freshEslintConfig, hasOwn, isEnumValue, isFlag01, isMaybe, isNumber, isNumberInRange, isObject, isString, isValidCron, logger };
+export { AMOUNT_UNIT, ActionCommandCode, ApiError, BaseEntityChangeSubscriber, type CardNumber, Category, DataHelper, DateUtils, type Deferred, DepotPoolStatus, Device, type EntityChangeEvent, FreshDao, FreshEntity, FreshHyperEntity, FreshJob, FreshTranslationBase, type HealthCheckResult, HttpStatus, LanguageCode, Manufacturer, type Maybe, PaymentMethod, PG_DATA_SOURCE_OPTIONS as PgDataSourceOptions, Product, SinglePromiseWaiter, Singleton, type Status, StatusDto, Subcategory, TimestampColumn, TransactionType, createDeferred, FRESH_ESLINT_CONFIG as freshEslintConfig, hasOwn, isEnumValue, isFlag01, isMaybe, isNumber, isNumberInRange, isObject, isString, isValidCron };

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import dayjs, { Dayjs } from 'dayjs';
-import { Logger } from 'winston';
-import { BaseEntity, ColumnOptions, Repository, EntityTarget, EntityManager, DataSourceOptions } from 'typeorm';
+import { BaseEntity, ColumnOptions, Repository, EntityTarget, EntityManager, ObjectLiteral, EntitySubscriberInterface, InsertEvent, UpdateEvent, SoftRemoveEvent, TransactionCommitEvent, DataSourceOptions } from 'typeorm';
 import { Job } from 'node-schedule';
 import * as _eslint_core from '@eslint/core';
 import * as typescript_eslint_dist_compatibility_types from 'typescript-eslint/dist/compatibility-types';
@@ -54,8 +53,6 @@ declare class SinglePromiseWaiter<T = any> {
     get hasPromise(): boolean;
 }
 
-declare const logger: Logger;
-
 declare function isValidCron(expr: string): boolean;
 
 /**
@@ -348,6 +345,50 @@ declare abstract class FreshDao<T extends BaseEntity> {
     protected getRepo(manager?: EntityManager, entity?: EntityTarget<T>): Repository<T>;
 }
 
+/**
+ * Change event types for entity lifecycle tracking.
+ */
+type EntityChangeEvent = "created" | "updated" | "deleted";
+/**
+ * Abstract base class for TypeORM EntitySubscribers that need to:
+ * 1. Track entity changes (insert/update/soft-remove)
+ * 2. Batch pending notifications within a transaction
+ * 3. Send notifications only after transaction commit
+ *
+ * Subclasses must implement:
+ * - `listenTo()` — target entity class
+ * - `pendingKey` — unique key for storing pending events in `queryRunner.data`
+ * - `subscriberName` — name used in log messages
+ * - `handleNotification(id, changeEvent, manager)` — actual notification logic
+ */
+declare abstract class BaseEntityChangeSubscriber<Entity extends ObjectLiteral, IdType = number> implements EntitySubscriberInterface<Entity> {
+    /**
+     * Unique key used to store pending change events in `queryRunner.data`.
+     * Must be unique per subscriber to avoid collisions when multiple subscribers
+     * share the same queryRunner.
+     */
+    protected abstract readonly PENDING_KEY: string;
+    /**
+     * Human-readable name for log/error messages.
+     */
+    protected abstract readonly SUBSCRIBER_NAME: string;
+    /**
+     * Return the entity class this subscriber listens to.
+     */
+    abstract listenTo(): Function;
+    /**
+     * Implement the actual notification/side-effect logic.
+     * Called after transaction commit (or immediately if no transaction is active).
+     */
+    protected abstract handleNotification(id: IdType, changeEvent: EntityChangeEvent, manager: EntityManager): Promise<void>;
+    afterInsert(event: InsertEvent<Entity>): void;
+    afterUpdate(event: UpdateEvent<Entity>): void;
+    afterSoftRemove(event: SoftRemoveEvent<Entity>): void;
+    afterTransactionCommit(event: TransactionCommitEvent): Promise<void>;
+    private addPending;
+    private sendNotification;
+}
+
 declare class Category extends FreshEntity {
 }
 
@@ -641,4 +682,4 @@ interface HealthCheckResult {
     };
 }
 
-export { AMOUNT_UNIT, ActionCommandCode, ApiError, type CardNumber, Category, DataHelper, DateUtils, type Deferred, DepotPoolStatus, Device, FreshDao, FreshEntity, FreshHyperEntity, FreshJob, FreshTranslationBase, type HealthCheckResult, HttpStatus, LanguageCode, Manufacturer, type Maybe, PaymentMethod, PG_DATA_SOURCE_OPTIONS as PgDataSourceOptions, Product, SinglePromiseWaiter, Singleton, type Status, StatusDto, Subcategory, TimestampColumn, TransactionType, createDeferred, FRESH_ESLINT_CONFIG as freshEslintConfig, hasOwn, isEnumValue, isFlag01, isMaybe, isNumber, isNumberInRange, isObject, isString, isValidCron, logger };
+export { AMOUNT_UNIT, ActionCommandCode, ApiError, BaseEntityChangeSubscriber, type CardNumber, Category, DataHelper, DateUtils, type Deferred, DepotPoolStatus, Device, type EntityChangeEvent, FreshDao, FreshEntity, FreshHyperEntity, FreshJob, FreshTranslationBase, type HealthCheckResult, HttpStatus, LanguageCode, Manufacturer, type Maybe, PaymentMethod, PG_DATA_SOURCE_OPTIONS as PgDataSourceOptions, Product, SinglePromiseWaiter, Singleton, type Status, StatusDto, Subcategory, TimestampColumn, TransactionType, createDeferred, FRESH_ESLINT_CONFIG as freshEslintConfig, hasOwn, isEnumValue, isFlag01, isMaybe, isNumber, isNumberInRange, isObject, isString, isValidCron };

package/dist/index.js

@@ -428,6 +428,7 @@ __export(index_exports, {
   AMOUNT_UNIT: () => AMOUNT_UNIT,
   ActionCommandCode: () => ActionCommandCode,
   ApiError: () => ApiError,
+  BaseEntityChangeSubscriber: () => BaseEntityChangeSubscriber,
   Category: () => Category,
   DataHelper: () => DataHelper,
   DateUtils: () => DateUtils,
@@ -460,8 +461,7 @@ __export(index_exports, {
   isNumberInRange: () => isNumberInRange,
   isObject: () => isObject,
   isString: () => isString,
-  isValidCron: () => isValidCron,
-  logger: () => logger
+  isValidCron: () => isValidCron
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -691,56 +691,6 @@ __name(_SinglePromiseWaiter, "SinglePromiseWaiter");
 __publicField(_SinglePromiseWaiter, "_instance");
 var SinglePromiseWaiter = _SinglePromiseWaiter;
 
-// src/common/winston.ts
-var import_winston = __toESM(require("winston"));
-var SERVICE = process.env.SERVICE_NAME || "depot-ordering-service";
-var ENV = process.env.NODE_ENV || "localhost";
-var levelToSeverity = {
-  silly: "debug",
-  verbose: "debug",
-  debug: "debug",
-  http: "info",
-  info: "info",
-  warn: "warn",
-  error: "error"
-};
-var baseFormat = import_winston.default.format.combine(import_winston.default.format.timestamp({
-  format: /* @__PURE__ */ __name(() => (/* @__PURE__ */ new Date()).toISOString(), "format")
-}), import_winston.default.format.errors({
-  stack: true
-}), import_winston.default.format.printf((info) => {
-  const payload = {
-    ts: info.timestamp,
-    level: info.level,
-    severity: levelToSeverity[info.level] || info.level,
-    message: info.message,
-    service: SERVICE,
-    env: ENV,
-    process_name: process.title || process.argv[1] || "node",
-    pid: process.pid,
-    device: process.env.DEVICE_ID || void 0,
-    traceId: info.traceId,
-    spanId: info.spanId,
-    extra: info.extra || info.meta || void 0,
-    stack: info.stack
-  };
-  return JSON.stringify(payload);
-}));
-var transports = [
-  new import_winston.default.transports.Console({
-    level: process.env.LOG_LEVEL || "info"
-  })
-];
-var logger = import_winston.default.createLogger({
-  level: process.env.LOG_LEVEL || "info",
-  format: baseFormat,
-  transports,
-  exitOnError: false
-});
-logger.stream = {
-  write: /* @__PURE__ */ __name((message) => logger.info(message.trim()), "write")
-};
-
 // src/common/utils/is-cron-valid.ts
 function isValidCron(expr) {
   const parts = expr.trim().split(/\s+/);
@@ -1207,6 +1157,83 @@ var _FreshDao = class _FreshDao {
 __name(_FreshDao, "FreshDao");
 var FreshDao = _FreshDao;
 
+// src/database/subscribers/base-entity-change.subscriber.ts
+var _BaseEntityChangeSubscriber = class _BaseEntityChangeSubscriber {
+  // ─── TypeORM lifecycle hooks ────────────────────────────────────────
+  afterInsert(event) {
+    var _a;
+    const id = (_a = event.entity) == null ? void 0 : _a.id;
+    if (!id) {
+      return;
+    }
+    if (event.queryRunner.isTransactionActive) {
+      this.addPending(event, id, "created");
+    } else {
+      console.warn(`${this.SUBSCRIBER_NAME} - Notification sent outside transaction for id=${id}`);
+      this.sendNotification(id, "created", event.queryRunner.manager);
+    }
+  }
+  afterUpdate(event) {
+    var _a, _b, _c;
+    const id = (_c = (_a = event.entity) == null ? void 0 : _a.id) != null ? _c : (_b = event.databaseEntity) == null ? void 0 : _b.id;
+    if (!id) {
+      return;
+    }
+    if (event.queryRunner.isTransactionActive) {
+      this.addPending(event, id, "updated");
+    } else {
+      console.warn(`${this.SUBSCRIBER_NAME} - Notification sent outside transaction for id=${id}`);
+      this.sendNotification(id, "updated", event.queryRunner.manager);
+    }
+  }
+  afterSoftRemove(event) {
+    var _a, _b, _c;
+    const id = (_c = (_a = event.entity) == null ? void 0 : _a.id) != null ? _c : (_b = event.databaseEntity) == null ? void 0 : _b.id;
+    if (!id) {
+      return;
+    }
+    if (event.queryRunner.isTransactionActive) {
+      this.addPending(event, id, "deleted");
+    } else {
+      console.warn(`${this.SUBSCRIBER_NAME} - Notification sent outside transaction for id=${id}`);
+      this.sendNotification(id, "deleted", event.queryRunner.manager);
+    }
+  }
+  async afterTransactionCommit(event) {
+    var _a;
+    const pending = (_a = event.queryRunner.data) == null ? void 0 : _a[this.PENDING_KEY];
+    if (!pending || pending.size === 0) {
+      return;
+    }
+    event.queryRunner.data[this.PENDING_KEY] = /* @__PURE__ */ new Map();
+    for (const [id, changeEvent] of pending) {
+      await this.sendNotification(id, changeEvent, event.connection.manager);
+    }
+  }
+  // ─── Private helpers ───────────────────────────────────────────────
+  addPending(event, id, changeEvent) {
+    if (!event.queryRunner.data) {
+      event.queryRunner.data = {};
+    }
+    if (!event.queryRunner.data[this.PENDING_KEY]) {
+      event.queryRunner.data[this.PENDING_KEY] = /* @__PURE__ */ new Map();
+    }
+    const existing = event.queryRunner.data[this.PENDING_KEY].get(id);
+    if (!existing || changeEvent === "created" || changeEvent === "deleted") {
+      event.queryRunner.data[this.PENDING_KEY].set(id, changeEvent);
+    }
+  }
+  async sendNotification(id, changeEvent, manager) {
+    try {
+      await this.handleNotification(id, changeEvent, manager);
+    } catch (error) {
+      console.error(`${this.SUBSCRIBER_NAME} - Failed to send notification: ${error instanceof Error ? error.message : error}`);
+    }
+  }
+};
+__name(_BaseEntityChangeSubscriber, "BaseEntityChangeSubscriber");
+var BaseEntityChangeSubscriber = _BaseEntityChangeSubscriber;
+
 // src/common/schema/entities/category.entity.ts
 function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -1707,6 +1734,7 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   AMOUNT_UNIT,
   ActionCommandCode,
   ApiError,
+  BaseEntityChangeSubscriber,
   Category,
   DataHelper,
   DateUtils,
@@ -1739,7 +1767,6 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   isNumberInRange,
   isObject,
   isString,
-  isValidCron,
-  logger
+  isValidCron
 });
 //# sourceMappingURL=index.js.map