@freshpointcz/fresh-core 0.0.16 → 0.0.18

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 {
 }
 
@@ -433,6 +474,46 @@ declare function isNumberInRange(v: unknown, min: number, max: number, options?:
     includeMin?: boolean;
     includeMax?: boolean;
 }): v is number;
+/**
+ * Numeric boolean flag type — either 0 or 1
+ */
+type BinaryFlag = 0 | 1;
+/**
+ * Converts a number, boolean, null, or undefined to a BinaryFlag (0 or 1)
+ *
+ * @example
+ * TO_BINARY_FLAG(true)  // 1
+ * TO_BINARY_FLAG(1)     // 1
+ * TO_BINARY_FLAG(false) // 0
+ * TO_BINARY_FLAG(null)  // 0
+ */
+declare const TO_BINARY_FLAG: (v: number | boolean | null | undefined) => BinaryFlag;
+
+/**
+ * Runs async worker functions over items with a concurrency limit.
+ *
+ * @param items - Array of items to process
+ * @param concurrency - Maximum number of concurrent workers
+ * @param worker - Async function to run for each item
+ *
+ * @example
+ * await runWithConcurrency(productIds, 5, async (id) => {
+ *     await processProduct(id);
+ * });
+ */
+declare function runWithConcurrency<T>(items: T[], concurrency: number, worker: (item: T) => Promise<void>): Promise<void>;
+
+type TransformMap<TIn, TOut, K extends keyof TIn & keyof TOut> = Partial<{
+    [P in K]: (val: TIn[P]) => TOut[P];
+}>;
+/**
+ * Builds a partial patch object from an input DTO, only including keys that are defined.
+ * Optionally applies transform functions to specific keys.
+ *
+ * @example
+ * const patch = buildPatch(data, ["name", "active"], { active: (v) => v ? 1 : 0 });
+ */
+declare function buildPatch<TOut extends Record<string, any>, TIn extends Record<string, any>, K extends keyof TIn & keyof TOut = keyof TIn & keyof TOut>(data: Partial<TIn>, keys: readonly K[], transforms?: TransformMap<TIn, TOut, K>): Partial<Pick<TOut, K>>;
 
 type Maybe<T> = T | null;
 /**
@@ -564,6 +645,18 @@ declare class ApiError extends Error {
     constructor(statusCode: number, status: Status, detail?: string);
 }
 
+/**
+ * Represents a non-fatal business rule violation that should be
+ * communicated to the caller without being treated as a system error.
+ *
+ * @example
+ * throw new BusinessWarning("ORDER_ALREADY_SENT", "Tato objednávka již byla odeslána.");
+ */
+declare class BusinessWarning extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+
 declare const FRESH_ESLINT_CONFIG: {
     files: string[];
     ignores: string[];
@@ -641,4 +734,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 BinaryFlag, BusinessWarning, 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, TO_BINARY_FLAG, TimestampColumn, TransactionType, buildPatch, createDeferred, FRESH_ESLINT_CONFIG as freshEslintConfig, hasOwn, isEnumValue, isFlag01, isMaybe, isNumber, isNumberInRange, isObject, isString, isValidCron, runWithConcurrency };

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 {
 }
 
@@ -433,6 +474,46 @@ declare function isNumberInRange(v: unknown, min: number, max: number, options?:
     includeMin?: boolean;
     includeMax?: boolean;
 }): v is number;
+/**
+ * Numeric boolean flag type — either 0 or 1
+ */
+type BinaryFlag = 0 | 1;
+/**
+ * Converts a number, boolean, null, or undefined to a BinaryFlag (0 or 1)
+ *
+ * @example
+ * TO_BINARY_FLAG(true)  // 1
+ * TO_BINARY_FLAG(1)     // 1
+ * TO_BINARY_FLAG(false) // 0
+ * TO_BINARY_FLAG(null)  // 0
+ */
+declare const TO_BINARY_FLAG: (v: number | boolean | null | undefined) => BinaryFlag;
+
+/**
+ * Runs async worker functions over items with a concurrency limit.
+ *
+ * @param items - Array of items to process
+ * @param concurrency - Maximum number of concurrent workers
+ * @param worker - Async function to run for each item
+ *
+ * @example
+ * await runWithConcurrency(productIds, 5, async (id) => {
+ *     await processProduct(id);
+ * });
+ */
+declare function runWithConcurrency<T>(items: T[], concurrency: number, worker: (item: T) => Promise<void>): Promise<void>;
+
+type TransformMap<TIn, TOut, K extends keyof TIn & keyof TOut> = Partial<{
+    [P in K]: (val: TIn[P]) => TOut[P];
+}>;
+/**
+ * Builds a partial patch object from an input DTO, only including keys that are defined.
+ * Optionally applies transform functions to specific keys.
+ *
+ * @example
+ * const patch = buildPatch(data, ["name", "active"], { active: (v) => v ? 1 : 0 });
+ */
+declare function buildPatch<TOut extends Record<string, any>, TIn extends Record<string, any>, K extends keyof TIn & keyof TOut = keyof TIn & keyof TOut>(data: Partial<TIn>, keys: readonly K[], transforms?: TransformMap<TIn, TOut, K>): Partial<Pick<TOut, K>>;
 
 type Maybe<T> = T | null;
 /**
@@ -564,6 +645,18 @@ declare class ApiError extends Error {
     constructor(statusCode: number, status: Status, detail?: string);
 }
 
+/**
+ * Represents a non-fatal business rule violation that should be
+ * communicated to the caller without being treated as a system error.
+ *
+ * @example
+ * throw new BusinessWarning("ORDER_ALREADY_SENT", "Tato objednávka již byla odeslána.");
+ */
+declare class BusinessWarning extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+
 declare const FRESH_ESLINT_CONFIG: {
     files: string[];
     ignores: string[];
@@ -641,4 +734,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 BinaryFlag, BusinessWarning, 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, TO_BINARY_FLAG, TimestampColumn, TransactionType, buildPatch, createDeferred, FRESH_ESLINT_CONFIG as freshEslintConfig, hasOwn, isEnumValue, isFlag01, isMaybe, isNumber, isNumberInRange, isObject, isString, isValidCron, runWithConcurrency };

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 crypto3 = require("crypto");
+    var crypto = 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 = crypto3.createDecipheriv("aes-256-gcm", key, nonce);
+        const aesgcm = crypto.createDecipheriv("aes-256-gcm", key, nonce);
         aesgcm.setAuthTag(authTag);
         return `${aesgcm.update(ciphertext)}${aesgcm.final()}`;
       } catch (error) {
@@ -428,6 +428,8 @@ __export(index_exports, {
   AMOUNT_UNIT: () => AMOUNT_UNIT,
   ActionCommandCode: () => ActionCommandCode,
   ApiError: () => ApiError,
+  BaseEntityChangeSubscriber: () => BaseEntityChangeSubscriber,
+  BusinessWarning: () => BusinessWarning,
   Category: () => Category,
   DataHelper: () => DataHelper,
   DateUtils: () => DateUtils,
@@ -448,8 +450,10 @@ __export(index_exports, {
   Singleton: () => Singleton,
   StatusDto: () => StatusDto,
   Subcategory: () => Subcategory,
+  TO_BINARY_FLAG: () => TO_BINARY_FLAG,
   TimestampColumn: () => TimestampColumn,
   TransactionType: () => TransactionType,
+  buildPatch: () => buildPatch,
   createDeferred: () => createDeferred,
   freshEslintConfig: () => eslint_config_default,
   hasOwn: () => hasOwn,
@@ -461,7 +465,7 @@ __export(index_exports, {
   isObject: () => isObject,
   isString: () => isString,
   isValidCron: () => isValidCron,
-  logger: () => logger
+  runWithConcurrency: () => runWithConcurrency
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -691,56 +695,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,46 +819,53 @@ var import_typeorm5 = require("typeorm");
 // src/database/entities/fresh-entity.ts
 var import_typeorm = require("typeorm");
 
-// ../../node_modules/uuid/dist/esm-node/rng.js
-var import_crypto = __toESM(require("crypto"));
+// ../../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");
 var rnds8Pool = new Uint8Array(256);
 var poolPtr = rnds8Pool.length;
 function rng() {
   if (poolPtr > rnds8Pool.length - 16) {
-    import_crypto.default.randomFillSync(rnds8Pool);
+    (0, import_crypto.randomFillSync)(rnds8Pool);
     poolPtr = 0;
   }
   return rnds8Pool.slice(poolPtr, poolPtr += 16);
 }
 __name(rng, "rng");
 
-// ../../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"));
+// ../../node_modules/uuid/dist/esm/native.js
+var import_crypto2 = require("crypto");
 var native_default = {
-  randomUUID: import_crypto2.default.randomUUID
+  randomUUID: import_crypto2.randomUUID
 };
 
-// ../../node_modules/uuid/dist/esm-node/v4.js
+// ../../node_modules/uuid/dist/esm/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 = options.random || (options.rng || rng)();
+  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");
+  }
   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];
     }
@@ -1207,6 +1168,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;
@@ -1340,6 +1378,40 @@ function isNumberInRange(v, min, max, options) {
   return true;
 }
 __name(isNumberInRange, "isNumberInRange");
+var TO_BINARY_FLAG = /* @__PURE__ */ __name((v) => v === 1 || v === true ? 1 : 0, "TO_BINARY_FLAG");
+
+// src/common/utils/async.utils.ts
+async function runWithConcurrency(items, concurrency, worker) {
+  const queue = [
+    ...items
+  ];
+  const runNext = /* @__PURE__ */ __name(async () => {
+    const item = queue.shift();
+    if (!item) {
+      return;
+    }
+    await worker(item);
+    await runNext();
+  }, "runNext");
+  await Promise.all(Array.from({
+    length: Math.min(concurrency, items.length)
+  }, runNext));
+}
+__name(runWithConcurrency, "runWithConcurrency");
+
+// src/common/utils/patch.utils.ts
+function buildPatch(data, keys, transforms) {
+  const patch = {};
+  for (const k of keys) {
+    const value = data[k];
+    if (value === void 0) {
+      continue;
+    }
+    patch[k] = (transforms == null ? void 0 : transforms[k]) ? transforms[k](value) : value;
+  }
+  return patch;
+}
+__name(buildPatch, "buildPatch");
 
 // src/core/data-helper.ts
 var _DataHelper = class _DataHelper {
@@ -1514,6 +1586,18 @@ var _ApiError = class _ApiError extends Error {
 __name(_ApiError, "ApiError");
 var ApiError = _ApiError;
 
+// src/core/errors/business-warning.ts
+var _BusinessWarning = class _BusinessWarning extends Error {
+  constructor(code, message) {
+    super(message);
+    __publicField(this, "code");
+    this.code = code;
+    this.name = "BusinessWarning";
+  }
+};
+__name(_BusinessWarning, "BusinessWarning");
+var BusinessWarning = _BusinessWarning;
+
 // src/types/maybe-type.ts
 function isMaybe(v, inner) {
   return v === null || inner(v);
@@ -1707,6 +1791,8 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   AMOUNT_UNIT,
   ActionCommandCode,
   ApiError,
+  BaseEntityChangeSubscriber,
+  BusinessWarning,
   Category,
   DataHelper,
   DateUtils,
@@ -1727,8 +1813,10 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   Singleton,
   StatusDto,
   Subcategory,
+  TO_BINARY_FLAG,
   TimestampColumn,
   TransactionType,
+  buildPatch,
   createDeferred,
   freshEslintConfig,
   hasOwn,
@@ -1740,6 +1828,6 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   isObject,
   isString,
   isValidCron,
-  logger
+  runWithConcurrency
 });
 //# sourceMappingURL=index.js.map