@freshpointcz/fresh-core 0.0.15 → 0.0.17

package/dist/index.d.mts

@@ -1,8 +1,7 @@
 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 from 'eslint';
+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 {
 }
 
@@ -574,7 +615,7 @@ declare const FRESH_ESLINT_CONFIG: {
     };
     plugins: {
         "@typescript-eslint": typescript_eslint_dist_compatibility_types.CompatiblePlugin;
-        prettier: eslint.ESLint.Plugin;
+        prettier: _eslint_core.Plugin;
     };
     rules: {
         "prefer-const": string;
@@ -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,8 +1,7 @@
 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 from 'eslint';
+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 {
 }
 
@@ -574,7 +615,7 @@ declare const FRESH_ESLINT_CONFIG: {
     };
     plugins: {
         "@typescript-eslint": typescript_eslint_dist_compatibility_types.CompatiblePlugin;
-        prettier: eslint.ESLint.Plugin;
+        prettier: _eslint_core.Plugin;
     };
     rules: {
         "prefer-const": string;
@@ -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

@@ -108,7 +108,7 @@ var require_main = __commonJS({
     var fs = require("fs");
     var path2 = require("path");
     var os = require("os");
-    var crypto = require("crypto");
+    var crypto3 = require("crypto");
     var packageJson = require_package();
     var version = packageJson.version;
     var LINE = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg;
@@ -355,7 +355,7 @@ var require_main = __commonJS({
       const authTag = ciphertext.subarray(-16);
       ciphertext = ciphertext.subarray(12, -16);
       try {
-        const aesgcm = crypto.createDecipheriv("aes-256-gcm", key, nonce);
+        const aesgcm = crypto3.createDecipheriv("aes-256-gcm", key, nonce);
         aesgcm.setAuthTag(authTag);
         return `${aesgcm.update(ciphertext)}${aesgcm.final()}`;
       } catch (error) {
@@ -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+/);
@@ -865,53 +815,46 @@ var import_typeorm5 = require("typeorm");
 // src/database/entities/fresh-entity.ts
 var import_typeorm = require("typeorm");
 
-// ../../node_modules/uuid/dist/esm/stringify.js
-var byteToHex = [];
-for (let i = 0; i < 256; ++i) {
-  byteToHex.push((i + 256).toString(16).slice(1));
-}
-function unsafeStringify(arr, offset = 0) {
-  return (byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]]).toLowerCase();
-}
-__name(unsafeStringify, "unsafeStringify");
-
-// ../../node_modules/uuid/dist/esm/rng.js
-var import_crypto = require("crypto");
+// ../../node_modules/uuid/dist/esm-node/rng.js
+var import_crypto = __toESM(require("crypto"));
 var rnds8Pool = new Uint8Array(256);
 var poolPtr = rnds8Pool.length;
 function rng() {
   if (poolPtr > rnds8Pool.length - 16) {
-    (0, import_crypto.randomFillSync)(rnds8Pool);
+    import_crypto.default.randomFillSync(rnds8Pool);
     poolPtr = 0;
   }
   return rnds8Pool.slice(poolPtr, poolPtr += 16);
 }
 __name(rng, "rng");
 
-// ../../node_modules/uuid/dist/esm/native.js
-var import_crypto2 = require("crypto");
+// ../../node_modules/uuid/dist/esm-node/stringify.js
+var byteToHex = [];
+for (let i = 0; i < 256; ++i) {
+  byteToHex.push((i + 256).toString(16).slice(1));
+}
+function unsafeStringify(arr, offset = 0) {
+  return byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]];
+}
+__name(unsafeStringify, "unsafeStringify");
+
+// ../../node_modules/uuid/dist/esm-node/native.js
+var import_crypto2 = __toESM(require("crypto"));
 var native_default = {
-  randomUUID: import_crypto2.randomUUID
+  randomUUID: import_crypto2.default.randomUUID
 };
 
-// ../../node_modules/uuid/dist/esm/v4.js
+// ../../node_modules/uuid/dist/esm-node/v4.js
 function v4(options, buf, offset) {
-  var _a, _b, _c;
   if (native_default.randomUUID && !buf && !options) {
     return native_default.randomUUID();
   }
   options = options || {};
-  const rnds = (_c = (_b = options.random) != null ? _b : (_a = options.rng) == null ? void 0 : _a.call(options)) != null ? _c : rng();
-  if (rnds.length < 16) {
-    throw new Error("Random bytes length must be >= 16");
-  }
+  const rnds = options.random || (options.rng || rng)();
   rnds[6] = rnds[6] & 15 | 64;
   rnds[8] = rnds[8] & 63 | 128;
   if (buf) {
     offset = offset || 0;
-    if (offset < 0 || offset + 16 > buf.length) {
-      throw new RangeError(`UUID byte range ${offset}:${offset + 15} is out of buffer bounds`);
-    }
     for (let i = 0; i < 16; ++i) {
       buf[offset + i] = rnds[i];
     }
@@ -964,7 +907,7 @@ _ts_decorate([
   }),
   (0, import_typeorm.Column)({
     type: "uuid",
-    default: /* @__PURE__ */ __name(() => "timescale.uuid_generate_v4()", "default")
+    default: /* @__PURE__ */ __name(() => "gen_random_uuid()", "default")
   }),
   _ts_metadata("design:type", String)
 ], FreshEntity.prototype, "uuid", void 0);
@@ -1214,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;
@@ -1714,6 +1734,7 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   AMOUNT_UNIT,
   ActionCommandCode,
   ApiError,
+  BaseEntityChangeSubscriber,
   Category,
   DataHelper,
   DateUtils,
@@ -1746,7 +1767,6 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   isNumberInRange,
   isObject,
   isString,
-  isValidCron,
-  logger
+  isValidCron
 });
 //# sourceMappingURL=index.js.map