@freshpointcz/fresh-core 0.0.20 → 0.0.21

package/dist/index.js

@@ -495,6 +495,9 @@ __export(index_exports, {
   UpgradeRequiredError: () => UpgradeRequiredError,
   UriTooLongError: () => UriTooLongError,
   VariantAlsoNegotiatesError: () => VariantAlsoNegotiatesError,
+  buildDateRange: () => buildDateRange,
+  buildOrder: () => buildOrder,
+  buildPagination: () => buildPagination,
   buildPatch: () => buildPatch,
   constructTypeormPagination: () => constructTypeormPagination,
   createDeferred: () => createDeferred,
@@ -755,70 +758,37 @@ var _StatusDto = class _StatusDto {
 __name(_StatusDto, "StatusDto");
 var StatusDto = _StatusDto;
 
-// src/common/pagination/constructors.ts
-function constructTypeormPagination(params) {
-  return {
-    take: params.limit,
-    skip: params.skip
-  };
-}
-__name(constructTypeormPagination, "constructTypeormPagination");
-function parsePaginationFromURL(searchParams) {
-  var _a, _b;
-  const page = Math.max(1, parseInt((_a = searchParams.get("page")) != null ? _a : "1", 10));
-  const limit = Math.min(100, Math.max(1, parseInt((_b = searchParams.get("limit")) != null ? _b : "20", 10)));
-  return {
-    page,
-    limit,
-    skip: (page - 1) * limit
-  };
-}
-__name(parsePaginationFromURL, "parsePaginationFromURL");
-
-// src/common/pagination/pagination-meta.ts
-function getPaginationMeta(total, page, limit) {
-  return {
-    total,
-    page,
-    limit,
-    totalPages: Math.ceil(total / limit)
-  };
+// src/common/pagination/find-options/date-range.ts
+var import_typeorm = require("typeorm");
+function buildDateRange(from, to) {
+  const f = from ? new Date(from) : void 0;
+  const t = to ? new Date(to) : void 0;
+  if (f && t) {
+    return (0, import_typeorm.Between)(f, t);
+  }
+  if (f) {
+    return (0, import_typeorm.MoreThanOrEqual)(f);
+  }
+  if (t) {
+    return (0, import_typeorm.LessThanOrEqual)(t);
+  }
+  return void 0;
 }
-__name(getPaginationMeta, "getPaginationMeta");
+__name(buildDateRange, "buildDateRange");
 
-// src/common/pagination/pagination-params.ts
-function getPaginationParams(params) {
+// src/common/pagination/find-options/order.ts
+function buildOrder(sortBy, sortOrder) {
+  if (!sortBy) {
+    return void 0;
+  }
   return {
-    ...DEFAULT_PAGINATION_PARAMS,
-    ...params
+    [sortBy]: sortOrder != null ? sortOrder : "ASC"
   };
 }
-__name(getPaginationParams, "getPaginationParams");
-var DEFAULT_PAGINATION_PARAMS = {
-  page: 1,
-  limit: 1e3,
-  skip: 0
-};
+__name(buildOrder, "buildOrder");
 
-// src/common/pagination/scrapper.ts
-async function listAll(fetchPage, batchSize = 1e3) {
-  const results = [];
-  let page = 1;
-  while (true) {
-    const { data, meta } = await fetchPage({
-      page,
-      limit: batchSize,
-      skip: (page - 1) * batchSize
-    });
-    results.push(...data);
-    if (page >= meta.totalPages) {
-      break;
-    }
-    page++;
-  }
-  return results;
-}
-__name(listAll, "listAll");
+// src/core/class/fresh-job.ts
+var import_node_schedule = require("node-schedule");
 
 // src/common/patterns/singleton.ts
 var _Singleton = class _Singleton {
@@ -871,236 +841,173 @@ __name(_Singleton, "Singleton");
 __publicField(_Singleton, "instances", /* @__PURE__ */ new Map());
 var Singleton = _Singleton;
 
-// src/common/promise-magic/deferred.ts
-function createDeferred() {
-  let resolve;
-  let reject;
-  const promise = new Promise((res, rej) => {
-    resolve = res;
-    reject = rej;
-  });
-  return {
-    promise,
-    resolve,
-    reject
-  };
-}
-__name(createDeferred, "createDeferred");
-
-// src/common/promise-magic/single-promise-waiter.ts
-var _SinglePromiseWaiter = class _SinglePromiseWaiter {
-  constructor() {
-    __publicField(this, "_promise", null);
+// src/core/class/fresh-job.ts
+var _FreshJob = class _FreshJob extends Singleton {
+  /**
+   * Creates and optionally schedules a singleton cron job.
+   *
+   * @param jobName - Logical name of the job (used in logs and errors).
+   * @param cronExpression - Cron expression consisting of numeric fields only.
+   * Example: `0 5 * * 4`
+   * The timezone `"Europe/Prague"` is applied automatically.
+   *
+   * @param jobEnabled - Whether the job should be scheduled immediately.
+   * If `false`, the instance exists but no cron trigger is registered.
+   *
+   * @throws Error If the cron expression is invalid.
+   * @throws Error If the job cannot be scheduled.
+   */
+  constructor(jobName, cronExpression, jobEnabled) {
+    super(false);
+    /** Human-readable job identifier (used for logs and errors). */
+    __publicField(this, "_jobName");
+    /**
+     * Cron expression defining when the job runs.
+     *
+     * Must contain numeric cron fields only.
+     * Example: `0 5 * * 4`
+     *
+     * Timezone is always forced to `"Europe/Prague"`.
+     * If you need another timezone, this class is not your friend.
+     */
+    __publicField(this, "_cronExpression");
+    /** Scheduled job instance, or `null` if the job is disabled. */
+    __publicField(this, "_job", null);
+    this._jobName = jobName;
+    if (!isValidCron(cronExpression)) {
+      throw new Error(`Job ${this.jobName} cannot be constructed with invalid cron: "${cronExpression}"`);
+    }
+    this._cronExpression = cronExpression;
+    if (jobEnabled) {
+      this._job = (0, import_node_schedule.scheduleJob)({
+        rule: this._cronExpression,
+        tz: "Europe/Prague"
+      }, async () => {
+        await this.invoke();
+      });
+      if (!this._job) {
+        throw new Error(`Job ${this._jobName} could not be scheduled`);
+      }
+    }
+    this.onInit();
   }
-  static getInstance() {
-    if (!_SinglePromiseWaiter._instance) {
-      _SinglePromiseWaiter._instance = new _SinglePromiseWaiter();
+  /**
+   * Initialization hook.
+   *
+   * Called once during construction and used primarily for logging.
+   * Can also be reused by subclasses if manual rescheduling is implemented.
+   *
+   * @param rescheduled - Indicates whether the job was reconfigured
+   * after initial creation.
+   */
+  onInit(rescheduled) {
+    console.log(`Job ${this.jobName} ${rescheduled ? "rescheduled" : "initialized"} with cron rule: "${this.cronExpression}"`);
+  }
+  /** @returns The logical name of the job. */
+  get jobName() {
+    return this._jobName;
+  }
+  /** Allows subclasses to rename the job if absolutely necessary. */
+  set jobName(value) {
+    this._jobName = value;
+  }
+  /** @returns The cron expression used to schedule the job. */
+  get cronExpression() {
+    return this._cronExpression;
+  }
+  /**
+   * Allows subclasses to update the cron expression internally.
+   * Does reschedule of job if exists
+   */
+  set cronExpression(value) {
+    if (!isValidCron(value)) {
+      throw new Error(`Job ${this._jobName} cannot be re-scheduled with invalid cron: "${value}"`);
     }
-    return _SinglePromiseWaiter._instance;
+    this._cronExpression = value;
   }
-  get promise() {
-    return this._promise;
+  /** @returns The underlying scheduled job instance, or `null` if disabled. */
+  get job() {
+    return this._job;
   }
-  set promise(promise) {
-    if (promise !== null) {
-      this._promise = promise;
-      this._promise.finally(() => {
-        this._promise = null;
+  /** Allows subclasses to manage the scheduled job instance. */
+  set job(value) {
+    this._job = value;
+  }
+  reschedule(newCronExpression) {
+    let result = false;
+    if (!isValidCron(newCronExpression)) {
+      throw new Error(`Job ${this._jobName} cannot be re-scheduled with invalid cron: "${newCronExpression}"`);
+    }
+    this._cronExpression = newCronExpression;
+    if (this._job) {
+      const rescheduleSuccess = this._job.reschedule({
+        rule: this._cronExpression,
+        tz: "Europe/Prague"
       });
+      if (!rescheduleSuccess) {
+        throw new Error(`Job ${this._jobName} could not be re-scheduled`);
+      } else {
+        this.onInit(true);
+      }
+      result = rescheduleSuccess;
     }
-  }
-  get hasPromise() {
-    return this._promise !== null;
+    return result;
   }
 };
-__name(_SinglePromiseWaiter, "SinglePromiseWaiter");
-__publicField(_SinglePromiseWaiter, "_instance");
-var SinglePromiseWaiter = _SinglePromiseWaiter;
-
-// src/common/schema/entities/category.entity.ts
-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");
+__name(_FreshJob, "FreshJob");
+var FreshJob = _FreshJob;
 
-// ../../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) {
-    (0, import_crypto.randomFillSync)(rnds8Pool);
-    poolPtr = 0;
+// src/core/errors/api-error.ts
+var _ApiError = class _ApiError extends Error {
+  constructor(statusCode, status, detail) {
+    super();
+    __publicField(this, "_statusCode");
+    __publicField(this, "_statusDto");
+    this._statusCode = statusCode;
+    this._statusDto = new StatusDto(status, detail);
+  }
+  get statusCode() {
+    return this._statusCode;
+  }
+  get statusDto() {
+    return this._statusDto;
   }
-  return rnds8Pool.slice(poolPtr, poolPtr += 16);
-}
-__name(rng, "rng");
-
-// ../../node_modules/uuid/dist/esm/native.js
-var import_crypto2 = require("crypto");
-var native_default = {
-  randomUUID: import_crypto2.randomUUID
 };
+__name(_ApiError, "ApiError");
+var ApiError = _ApiError;
 
-// ../../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 = (_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];
-    }
-    return buf;
-  }
-  return unsafeStringify(rnds);
-}
-__name(v4, "v4");
-var v4_default = v4;
-
-// src/database/entities/fresh-entity.ts
-function _ts_decorate(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;
-}
-__name(_ts_decorate, "_ts_decorate");
-function _ts_metadata(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-__name(_ts_metadata, "_ts_metadata");
-var _FreshEntity = class _FreshEntity extends import_typeorm.BaseEntity {
-  /** After manual construction `id` is irrelevant. Refer to `uuid` only, because that will be inserted into DB */
-  constructor() {
-    super();
-    __publicField(this, "id");
-    __publicField(this, "uuid");
-    __publicField(this, "created_at");
-    __publicField(this, "updated_at");
-    // for soft delete methods by typeorm
-    __publicField(this, "deleted_at");
-    this.id = 0;
-    this.uuid = v4_default();
-    const newDate = /* @__PURE__ */ new Date();
-    this.created_at = newDate;
-    this.updated_at = newDate;
-    this.deleted_at = null;
+// 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(_FreshEntity, "FreshEntity");
-var FreshEntity = _FreshEntity;
-_ts_decorate([
-  (0, import_typeorm.PrimaryGeneratedColumn)("increment"),
-  _ts_metadata("design:type", Number)
-], FreshEntity.prototype, "id", void 0);
-_ts_decorate([
-  (0, import_typeorm.Index)({
-    unique: true
-  }),
-  (0, import_typeorm.Column)({
-    type: "uuid",
-    default: /* @__PURE__ */ __name(() => "gen_random_uuid()", "default")
-  }),
-  _ts_metadata("design:type", String)
-], FreshEntity.prototype, "uuid", void 0);
-_ts_decorate([
-  (0, import_typeorm.CreateDateColumn)({
-    type: "timestamptz"
-  }),
-  _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
-], FreshEntity.prototype, "created_at", void 0);
-_ts_decorate([
-  (0, import_typeorm.UpdateDateColumn)({
-    type: "timestamptz"
-  }),
-  _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
-], FreshEntity.prototype, "updated_at", void 0);
-_ts_decorate([
-  (0, import_typeorm.DeleteDateColumn)({
-    type: "timestamptz",
-    nullable: true
-  }),
-  _ts_metadata("design:type", Object)
-], FreshEntity.prototype, "deleted_at", void 0);
-
-// src/database/entities/fresh-hyper-entity.ts
-var import_typeorm3 = require("typeorm");
-
-// src/database/decorators/timestamp-column.ts
-var import_typeorm2 = require("typeorm");
-function TimestampColumn(options = {}) {
-  const defaultOptions = {
-    type: "timestamptz",
-    nullable: false,
-    default: /* @__PURE__ */ __name(() => "CURRENT_TIMESTAMP", "default"),
-    ...options
-  };
-  return (0, import_typeorm2.Column)(defaultOptions);
-}
-__name(TimestampColumn, "TimestampColumn");
+__name(_BusinessWarning, "BusinessWarning");
+var BusinessWarning = _BusinessWarning;
 
-// src/database/entities/fresh-hyper-entity.ts
-function _ts_decorate2(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;
-}
-__name(_ts_decorate2, "_ts_decorate");
-function _ts_metadata2(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-__name(_ts_metadata2, "_ts_metadata");
-var _FreshHyperEntity = class _FreshHyperEntity extends import_typeorm3.BaseEntity {
-  /** After manual construction `id` is irrelevant */
-  constructor(timestamp) {
-    super();
-    // input timestamp as PK
-    __publicField(this, "timestamp");
-    // just info column about time of insert
-    __publicField(this, "created_at");
-    this.timestamp = timestamp != null ? timestamp : /* @__PURE__ */ new Date();
-    this.created_at = /* @__PURE__ */ new Date();
+// src/core/errors/fresh-error.ts
+var _FreshError = class _FreshError extends Error {
+  constructor(statusCode, status, detail, options) {
+    super(detail != null ? detail : status);
+    /** HTTP status code sent in the response. */
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    __publicField(this, "statusCode");
+    /** Structured response body describing the error. */
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    __publicField(this, "statusDto");
+    this.name = this.constructor.name;
+    if ((options == null ? void 0 : options.cause) !== void 0) {
+      this.cause = options.cause;
+    }
+    this.statusCode = statusCode;
+    this.statusDto = new StatusDto(status, detail);
   }
 };
-__name(_FreshHyperEntity, "FreshHyperEntity");
-var FreshHyperEntity = _FreshHyperEntity;
-_ts_decorate2([
-  (0, import_typeorm3.PrimaryColumn)({
-    type: "timestamptz"
-  }),
-  _ts_metadata2("design:type", typeof Date === "undefined" ? Object : Date)
-], FreshHyperEntity.prototype, "timestamp", void 0);
-_ts_decorate2([
-  TimestampColumn(),
-  _ts_metadata2("design:type", typeof Date === "undefined" ? Object : Date)
-], FreshHyperEntity.prototype, "created_at", void 0);
-
-// src/database/entities/fresh-translation-entity.ts
-var import_typeorm4 = require("typeorm");
+__name(_FreshError, "FreshError");
+var FreshError = _FreshError;
 
 // src/enums/action-command-code.ts
 var ActionCommandCode = /* @__PURE__ */ (function(ActionCommandCode2) {
@@ -1225,853 +1132,996 @@ var TransactionType = /* @__PURE__ */ (function(TransactionType2) {
   return TransactionType2;
 })({});
 
-// src/database/entities/fresh-translation-entity.ts
-function _ts_decorate3(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;
-}
-__name(_ts_decorate3, "_ts_decorate");
-function _ts_metadata3(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-__name(_ts_metadata3, "_ts_metadata");
-var languageValues = Object.values(LanguageCode).map((v) => `'${v}'`).join(",");
-var _FreshTranslationBase = class _FreshTranslationBase extends import_typeorm4.BaseEntity {
-  constructor() {
-    super();
-    __publicField(this, "id");
-    __publicField(this, "languageCode");
-    this.id = 0;
-    this.languageCode = LanguageCode.CS;
+// src/core/errors/errors.ts
+var _BadRequestError = class _BadRequestError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.BAD_REQUEST, "validation-error", detail, options);
   }
 };
-__name(_FreshTranslationBase, "FreshTranslationBase");
-var FreshTranslationBase = _FreshTranslationBase;
-_ts_decorate3([
-  (0, import_typeorm4.PrimaryGeneratedColumn)(),
-  _ts_metadata3("design:type", Number)
-], FreshTranslationBase.prototype, "id", void 0);
-_ts_decorate3([
-  (0, import_typeorm4.Column)({
-    type: "varchar",
-    length: 3,
-    nullable: false
-  }),
-  (0, import_typeorm4.Check)(`"languageCode" IN (${languageValues})`),
-  _ts_metadata3("design:type", typeof LanguageCode === "undefined" ? Object : LanguageCode)
-], FreshTranslationBase.prototype, "languageCode", void 0);
-
-// src/database/dao/fresh-dao.ts
-var _FreshDao = class _FreshDao {
-  getRepo(manager, entity = this.entity) {
-    return manager ? manager.getRepository(entity) : this.repo;
+__name(_BadRequestError, "BadRequestError");
+var BadRequestError = _BadRequestError;
+var _UnauthorizedError = class _UnauthorizedError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.UNAUTHORIZED, "not-authenticated", detail, options);
   }
 };
-__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);
-    }
+__name(_UnauthorizedError, "UnauthorizedError");
+var UnauthorizedError = _UnauthorizedError;
+var _PaymentRequiredError = class _PaymentRequiredError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.PAYMENT_REQUIRED, "error", detail, options);
   }
-  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);
-    }
+};
+__name(_PaymentRequiredError, "PaymentRequiredError");
+var PaymentRequiredError = _PaymentRequiredError;
+var _ForbiddenError = class _ForbiddenError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.FORBIDDEN, "not-authorized", detail, options);
   }
-  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);
-    }
+};
+__name(_ForbiddenError, "ForbiddenError");
+var ForbiddenError = _ForbiddenError;
+var _NotFoundError = class _NotFoundError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.NOT_FOUND, "error", detail, options);
   }
-  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);
-    }
+};
+__name(_NotFoundError, "NotFoundError");
+var NotFoundError = _NotFoundError;
+var _MethodNotAllowedError = class _MethodNotAllowedError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.METHOD_NOT_ALLOWED, "error", detail, options);
   }
-  // ─── 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);
-    }
+};
+__name(_MethodNotAllowedError, "MethodNotAllowedError");
+var MethodNotAllowedError = _MethodNotAllowedError;
+var _NotAcceptableError = class _NotAcceptableError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.NOT_ACCEPTABLE, "error", detail, options);
   }
-  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(_NotAcceptableError, "NotAcceptableError");
+var NotAcceptableError = _NotAcceptableError;
+var _ProxyAuthenticationRequiredError = class _ProxyAuthenticationRequiredError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.PROXY_AUTHENTICATION_REQUIRED, "not-authenticated", detail, options);
   }
 };
-__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;
-  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;
-}
-__name(_ts_decorate4, "_ts_decorate");
-var _Category = class _Category extends FreshEntity {
+__name(_ProxyAuthenticationRequiredError, "ProxyAuthenticationRequiredError");
+var ProxyAuthenticationRequiredError = _ProxyAuthenticationRequiredError;
+var _RequestTimeoutError = class _RequestTimeoutError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.REQUEST_TIMEOUT, "error", detail, options);
+  }
 };
-__name(_Category, "Category");
-var Category = _Category;
-Category = _ts_decorate4([
-  (0, import_typeorm5.Entity)()
-], Category);
-
-// src/common/schema/entities/device.entity.ts
-var import_typeorm6 = require("typeorm");
-function _ts_decorate5(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;
-}
-__name(_ts_decorate5, "_ts_decorate");
-var _Device = class _Device extends FreshEntity {
+__name(_RequestTimeoutError, "RequestTimeoutError");
+var RequestTimeoutError = _RequestTimeoutError;
+var _ConflictError = class _ConflictError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.CONFLICT, "error", detail, options);
+  }
 };
-__name(_Device, "Device");
-var Device = _Device;
-Device = _ts_decorate5([
-  (0, import_typeorm6.Entity)()
-], Device);
-
-// src/common/schema/entities/manufacturer.entity.ts
-var import_typeorm7 = require("typeorm");
-function _ts_decorate6(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;
-}
-__name(_ts_decorate6, "_ts_decorate");
-var _Manufacturer = class _Manufacturer extends FreshEntity {
+__name(_ConflictError, "ConflictError");
+var ConflictError = _ConflictError;
+var _GoneError = class _GoneError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.GONE, "error", detail, options);
+  }
 };
-__name(_Manufacturer, "Manufacturer");
-var Manufacturer = _Manufacturer;
-Manufacturer = _ts_decorate6([
-  (0, import_typeorm7.Entity)()
-], Manufacturer);
-
-// src/common/schema/entities/product.entity.ts
-var import_typeorm8 = require("typeorm");
-function _ts_decorate7(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;
-}
-__name(_ts_decorate7, "_ts_decorate");
-var _Product = class _Product extends FreshEntity {
+__name(_GoneError, "GoneError");
+var GoneError = _GoneError;
+var _LengthRequiredError = class _LengthRequiredError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.LENGTH_REQUIRED, "error", detail, options);
+  }
 };
-__name(_Product, "Product");
-var Product = _Product;
-Product = _ts_decorate7([
-  (0, import_typeorm8.Entity)()
-], Product);
-
-// src/common/schema/entities/subcategory.entity.ts
-var import_typeorm9 = require("typeorm");
-function _ts_decorate8(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;
-}
-__name(_ts_decorate8, "_ts_decorate");
-var _Subcategory = class _Subcategory extends FreshEntity {
+__name(_LengthRequiredError, "LengthRequiredError");
+var LengthRequiredError = _LengthRequiredError;
+var _PreconditionFailedError = class _PreconditionFailedError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.PRECONDITION_FAILED, "error", detail, options);
+  }
 };
-__name(_Subcategory, "Subcategory");
-var Subcategory = _Subcategory;
-Subcategory = _ts_decorate8([
-  (0, import_typeorm9.Entity)()
-], Subcategory);
-
-// src/common/typeguards/decimal.ts
-function toDecimal(num, precision = 9, scale = 2) {
-  const limit = Math.pow(10, precision - scale);
-  if (Math.abs(num) >= limit) {
-    throw new Error(`Value ${num} exceeds the allowed precision of ${precision} and scale of ${scale}.`);
+__name(_PreconditionFailedError, "PreconditionFailedError");
+var PreconditionFailedError = _PreconditionFailedError;
+var _PayloadTooLargeError = class _PayloadTooLargeError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.PAYLOAD_TOO_LARGE, "error", detail, options);
   }
-  return num.toFixed(scale);
-}
-__name(toDecimal, "toDecimal");
-function isDecimal(v, options) {
-  var _a, _b, _c;
-  const type = typeof v;
-  if ((options == null ? void 0 : options.allowedType) !== void 0 && type !== options.allowedType) {
-    return false;
+};
+__name(_PayloadTooLargeError, "PayloadTooLargeError");
+var PayloadTooLargeError = _PayloadTooLargeError;
+var _UriTooLongError = class _UriTooLongError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.URI_TOO_LONG, "error", detail, options);
   }
-  if (type !== "number" && type !== "string") {
-    return false;
+};
+__name(_UriTooLongError, "UriTooLongError");
+var UriTooLongError = _UriTooLongError;
+var _UnsupportedMediaTypeError = class _UnsupportedMediaTypeError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.UNSUPPORTED_MEDIA_TYPE, "error", detail, options);
   }
-  const sep = (_a = options == null ? void 0 : options.decimalPoint) != null ? _a : ".";
-  let intPart;
-  let fracPart;
-  if (type === "number") {
-    const n = v;
-    if (!Number.isFinite(n)) {
-      return false;
-    }
-    const str = n.toString();
-    if (str.includes("e") || str.includes("E")) {
-      return false;
-    }
-    const parts = str.replace("-", "").split(".");
-    intPart = parts[0];
-    fracPart = (_b = parts[1]) != null ? _b : "";
-  } else {
-    const s = v;
-    const escapedSep = sep === "." ? "\\." : ",";
-    const pattern = new RegExp(`^-?\\d+(?:${escapedSep}\\d+)?$`);
-    if (!pattern.test(s)) {
-      return false;
-    }
-    const parts = s.replace("-", "").split(sep);
-    intPart = parts[0];
-    fracPart = (_c = parts[1]) != null ? _c : "";
+};
+__name(_UnsupportedMediaTypeError, "UnsupportedMediaTypeError");
+var UnsupportedMediaTypeError = _UnsupportedMediaTypeError;
+var _RangeNotSatisfiableError = class _RangeNotSatisfiableError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.RANGE_NOT_SATISFIABLE, "error", detail, options);
   }
-  if ((options == null ? void 0 : options.scale) !== void 0 && fracPart.length > options.scale) {
-    return false;
+};
+__name(_RangeNotSatisfiableError, "RangeNotSatisfiableError");
+var RangeNotSatisfiableError = _RangeNotSatisfiableError;
+var _ExpectationFailedError = class _ExpectationFailedError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.EXPECTATION_FAILED, "error", detail, options);
   }
-  return (options == null ? void 0 : options.precision) === void 0 || intPart.length + fracPart.length <= options.precision;
-}
-__name(isDecimal, "isDecimal");
-
-// src/common/typeguards/enums.ts
-function isEnumValue(enumObj, v) {
-  if (!enumObj) {
-    return typeof v === "string" || typeof v === "number";
+};
+__name(_ExpectationFailedError, "ExpectationFailedError");
+var ExpectationFailedError = _ExpectationFailedError;
+var _ImATeapotError = class _ImATeapotError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.IM_A_TEAPOT, "error", detail, options);
   }
-  const values = new Set(Object.values(enumObj));
-  return (typeof v === "string" || typeof v === "number") && values.has(v);
-}
-__name(isEnumValue, "isEnumValue");
-
-// src/common/typeguards/objects.ts
-function isObject(v) {
-  return typeof v === "object" && v !== null;
-}
-__name(isObject, "isObject");
-function hasOwn(obj, key) {
-  return Object.prototype.hasOwnProperty.call(obj, key);
-}
-__name(hasOwn, "hasOwn");
-
-// src/common/typeguards/primitives.ts
-function isNumber(v) {
-  return typeof v === "number" && Number.isFinite(v);
-}
-__name(isNumber, "isNumber");
-function isString(v) {
-  return typeof v === "string";
-}
-__name(isString, "isString");
-function isFlag01(v) {
-  return v === 0 || v === 1;
-}
-__name(isFlag01, "isFlag01");
-function isNumberInRange(v, min, max, options) {
-  var _a, _b;
-  if (!isNumber(v)) {
-    return false;
-  }
-  const includeMin = (_a = options == null ? void 0 : options.includeMin) != null ? _a : true;
-  const includeMax = (_b = options == null ? void 0 : options.includeMax) != null ? _b : true;
-  if (includeMin ? v < min : v <= min) {
-    return false;
-  }
-  if (includeMax ? v > max : v >= max) {
-    return false;
-  }
-  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/id-path-param-resolver.utils.ts
-function resolvePathParameterId(id) {
-  return /^\d+$/.test(id) ? parseInt(id, 10) : id;
-}
-__name(resolvePathParameterId, "resolvePathParameterId");
-
-// src/common/utils/is-cron-valid.ts
-function isValidCron(expr) {
-  const parts = expr.trim().split(/\s+/);
-  if (parts.length < 5 || parts.length > 6) {
-    return false;
-  }
-  const cronPart = /^(\*|\d+|\d+\-\d+|\d+\/\d+|\*\/\d+)(,\d+)*$/;
-  return parts.every((part) => cronPart.test(part));
-}
-__name(isValidCron, "isValidCron");
-
-// 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/class/fresh-job.ts
-var import_node_schedule = require("node-schedule");
-var _FreshJob = class _FreshJob extends Singleton {
-  /**
-   * Creates and optionally schedules a singleton cron job.
-   *
-   * @param jobName - Logical name of the job (used in logs and errors).
-   * @param cronExpression - Cron expression consisting of numeric fields only.
-   * Example: `0 5 * * 4`
-   * The timezone `"Europe/Prague"` is applied automatically.
-   *
-   * @param jobEnabled - Whether the job should be scheduled immediately.
-   * If `false`, the instance exists but no cron trigger is registered.
-   *
-   * @throws Error If the cron expression is invalid.
-   * @throws Error If the job cannot be scheduled.
-   */
-  constructor(jobName, cronExpression, jobEnabled) {
-    super(false);
-    /** Human-readable job identifier (used for logs and errors). */
-    __publicField(this, "_jobName");
-    /**
-     * Cron expression defining when the job runs.
-     *
-     * Must contain numeric cron fields only.
-     * Example: `0 5 * * 4`
-     *
-     * Timezone is always forced to `"Europe/Prague"`.
-     * If you need another timezone, this class is not your friend.
-     */
-    __publicField(this, "_cronExpression");
-    /** Scheduled job instance, or `null` if the job is disabled. */
-    __publicField(this, "_job", null);
-    this._jobName = jobName;
-    if (!isValidCron(cronExpression)) {
-      throw new Error(`Job ${this.jobName} cannot be constructed with invalid cron: "${cronExpression}"`);
-    }
-    this._cronExpression = cronExpression;
-    if (jobEnabled) {
-      this._job = (0, import_node_schedule.scheduleJob)({
-        rule: this._cronExpression,
-        tz: "Europe/Prague"
-      }, async () => {
-        await this.invoke();
-      });
-      if (!this._job) {
-        throw new Error(`Job ${this._jobName} could not be scheduled`);
-      }
-    }
-    this.onInit();
-  }
-  /**
-   * Initialization hook.
-   *
-   * Called once during construction and used primarily for logging.
-   * Can also be reused by subclasses if manual rescheduling is implemented.
-   *
-   * @param rescheduled - Indicates whether the job was reconfigured
-   * after initial creation.
-   */
-  onInit(rescheduled) {
-    console.log(`Job ${this.jobName} ${rescheduled ? "rescheduled" : "initialized"} with cron rule: "${this.cronExpression}"`);
-  }
-  /** @returns The logical name of the job. */
-  get jobName() {
-    return this._jobName;
-  }
-  /** Allows subclasses to rename the job if absolutely necessary. */
-  set jobName(value) {
-    this._jobName = value;
+};
+__name(_ImATeapotError, "ImATeapotError");
+var ImATeapotError = _ImATeapotError;
+var _MisdirectedRequestError = class _MisdirectedRequestError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.MISDIRECTED_REQUEST, "error", detail, options);
   }
-  /** @returns The cron expression used to schedule the job. */
-  get cronExpression() {
-    return this._cronExpression;
+};
+__name(_MisdirectedRequestError, "MisdirectedRequestError");
+var MisdirectedRequestError = _MisdirectedRequestError;
+var _UnprocessableEntityError = class _UnprocessableEntityError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.UNPROCESSABLE_ENTITY, "validation-error", detail, options);
   }
-  /**
-   * Allows subclasses to update the cron expression internally.
-   * Does reschedule of job if exists
-   */
-  set cronExpression(value) {
-    if (!isValidCron(value)) {
-      throw new Error(`Job ${this._jobName} cannot be re-scheduled with invalid cron: "${value}"`);
-    }
-    this._cronExpression = value;
+};
+__name(_UnprocessableEntityError, "UnprocessableEntityError");
+var UnprocessableEntityError = _UnprocessableEntityError;
+var _LockedError = class _LockedError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.LOCKED, "error", detail, options);
   }
-  /** @returns The underlying scheduled job instance, or `null` if disabled. */
-  get job() {
-    return this._job;
+};
+__name(_LockedError, "LockedError");
+var LockedError = _LockedError;
+var _FailedDependencyError = class _FailedDependencyError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.FAILED_DEPENDENCY, "error", detail, options);
   }
-  /** Allows subclasses to manage the scheduled job instance. */
-  set job(value) {
-    this._job = value;
+};
+__name(_FailedDependencyError, "FailedDependencyError");
+var FailedDependencyError = _FailedDependencyError;
+var _TooEarlyError = class _TooEarlyError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.TOO_EARLY, "error", detail, options);
   }
-  reschedule(newCronExpression) {
-    let result = false;
-    if (!isValidCron(newCronExpression)) {
-      throw new Error(`Job ${this._jobName} cannot be re-scheduled with invalid cron: "${newCronExpression}"`);
-    }
-    this._cronExpression = newCronExpression;
-    if (this._job) {
-      const rescheduleSuccess = this._job.reschedule({
-        rule: this._cronExpression,
-        tz: "Europe/Prague"
-      });
-      if (!rescheduleSuccess) {
-        throw new Error(`Job ${this._jobName} could not be re-scheduled`);
-      } else {
-        this.onInit(true);
-      }
-      result = rescheduleSuccess;
-    }
-    return result;
+};
+__name(_TooEarlyError, "TooEarlyError");
+var TooEarlyError = _TooEarlyError;
+var _UpgradeRequiredError = class _UpgradeRequiredError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.UPGRADE_REQUIRED, "error", detail, options);
   }
 };
-__name(_FreshJob, "FreshJob");
-var FreshJob = _FreshJob;
-
-// src/core/errors/api-error.ts
-var _ApiError = class _ApiError extends Error {
-  constructor(statusCode, status, detail) {
-    super();
-    __publicField(this, "_statusCode");
-    __publicField(this, "_statusDto");
-    this._statusCode = statusCode;
-    this._statusDto = new StatusDto(status, detail);
+__name(_UpgradeRequiredError, "UpgradeRequiredError");
+var UpgradeRequiredError = _UpgradeRequiredError;
+var _PreconditionRequiredError = class _PreconditionRequiredError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.PRECONDITION_REQUIRED, "error", detail, options);
   }
-  get statusCode() {
-    return this._statusCode;
+};
+__name(_PreconditionRequiredError, "PreconditionRequiredError");
+var PreconditionRequiredError = _PreconditionRequiredError;
+var _TooManyRequestsError = class _TooManyRequestsError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.TOO_MANY_REQUESTS, "error", detail, options);
   }
-  get statusDto() {
-    return this._statusDto;
+};
+__name(_TooManyRequestsError, "TooManyRequestsError");
+var TooManyRequestsError = _TooManyRequestsError;
+var _RequestHeaderFieldsTooLargeError = class _RequestHeaderFieldsTooLargeError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.REQUEST_HEADER_FIELDS_TOO_LARGE, "error", detail, options);
   }
 };
-__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(_RequestHeaderFieldsTooLargeError, "RequestHeaderFieldsTooLargeError");
+var RequestHeaderFieldsTooLargeError = _RequestHeaderFieldsTooLargeError;
+var _UnavailableForLegalReasonsError = class _UnavailableForLegalReasonsError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.UNAVAILABLE_FOR_LEGAL_REASONS, "error", detail, options);
   }
 };
-__name(_BusinessWarning, "BusinessWarning");
-var BusinessWarning = _BusinessWarning;
-
-// src/core/errors/fresh-error.ts
-var _FreshError = class _FreshError extends Error {
-  constructor(statusCode, status, detail, options) {
-    super(detail != null ? detail : status);
-    /** HTTP status code sent in the response. */
-    // eslint-disable-next-line @typescript-eslint/naming-convention
-    __publicField(this, "statusCode");
-    /** Structured response body describing the error. */
-    // eslint-disable-next-line @typescript-eslint/naming-convention
-    __publicField(this, "statusDto");
-    this.name = this.constructor.name;
-    if ((options == null ? void 0 : options.cause) !== void 0) {
-      this.cause = options.cause;
-    }
-    this.statusCode = statusCode;
-    this.statusDto = new StatusDto(status, detail);
+__name(_UnavailableForLegalReasonsError, "UnavailableForLegalReasonsError");
+var UnavailableForLegalReasonsError = _UnavailableForLegalReasonsError;
+var _InternalServerError = class _InternalServerError extends FreshError {
+  constructor(detail, options) {
+    super(HttpStatus.INTERNAL_SERVER_ERROR, "internal-server-error", detail, options);
   }
 };
-__name(_FreshError, "FreshError");
-var FreshError = _FreshError;
-
-// src/core/errors/errors.ts
-var _BadRequestError = class _BadRequestError extends FreshError {
+__name(_InternalServerError, "InternalServerError");
+var InternalServerError = _InternalServerError;
+var _NotImplementedError = class _NotImplementedError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.BAD_REQUEST, "validation-error", detail, options);
+    super(HttpStatus.NOT_IMPLEMENTED, "internal-server-error", detail, options);
   }
 };
-__name(_BadRequestError, "BadRequestError");
-var BadRequestError = _BadRequestError;
-var _UnauthorizedError = class _UnauthorizedError extends FreshError {
+__name(_NotImplementedError, "NotImplementedError");
+var NotImplementedError = _NotImplementedError;
+var _BadGatewayError = class _BadGatewayError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.UNAUTHORIZED, "not-authenticated", detail, options);
+    super(HttpStatus.BAD_GATEWAY, "internal-server-error", detail, options);
   }
 };
-__name(_UnauthorizedError, "UnauthorizedError");
-var UnauthorizedError = _UnauthorizedError;
-var _PaymentRequiredError = class _PaymentRequiredError extends FreshError {
+__name(_BadGatewayError, "BadGatewayError");
+var BadGatewayError = _BadGatewayError;
+var _ServiceUnavailableError = class _ServiceUnavailableError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.PAYMENT_REQUIRED, "error", detail, options);
+    super(HttpStatus.SERVICE_UNAVAILABLE, "internal-server-error", detail, options);
   }
 };
-__name(_PaymentRequiredError, "PaymentRequiredError");
-var PaymentRequiredError = _PaymentRequiredError;
-var _ForbiddenError = class _ForbiddenError extends FreshError {
+__name(_ServiceUnavailableError, "ServiceUnavailableError");
+var ServiceUnavailableError = _ServiceUnavailableError;
+var _GatewayTimeoutError = class _GatewayTimeoutError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.FORBIDDEN, "not-authorized", detail, options);
+    super(HttpStatus.GATEWAY_TIMEOUT, "internal-server-error", detail, options);
   }
 };
-__name(_ForbiddenError, "ForbiddenError");
-var ForbiddenError = _ForbiddenError;
-var _NotFoundError = class _NotFoundError extends FreshError {
+__name(_GatewayTimeoutError, "GatewayTimeoutError");
+var GatewayTimeoutError = _GatewayTimeoutError;
+var _HttpVersionNotSupportedError = class _HttpVersionNotSupportedError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.NOT_FOUND, "error", detail, options);
+    super(HttpStatus.HTTP_VERSION_NOT_SUPPORTED, "internal-server-error", detail, options);
   }
 };
-__name(_NotFoundError, "NotFoundError");
-var NotFoundError = _NotFoundError;
-var _MethodNotAllowedError = class _MethodNotAllowedError extends FreshError {
+__name(_HttpVersionNotSupportedError, "HttpVersionNotSupportedError");
+var HttpVersionNotSupportedError = _HttpVersionNotSupportedError;
+var _VariantAlsoNegotiatesError = class _VariantAlsoNegotiatesError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.METHOD_NOT_ALLOWED, "error", detail, options);
+    super(HttpStatus.VARIANT_ALSO_NEGOTIATES, "internal-server-error", detail, options);
   }
 };
-__name(_MethodNotAllowedError, "MethodNotAllowedError");
-var MethodNotAllowedError = _MethodNotAllowedError;
-var _NotAcceptableError = class _NotAcceptableError extends FreshError {
+__name(_VariantAlsoNegotiatesError, "VariantAlsoNegotiatesError");
+var VariantAlsoNegotiatesError = _VariantAlsoNegotiatesError;
+var _InsufficientStorageError = class _InsufficientStorageError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.NOT_ACCEPTABLE, "error", detail, options);
+    super(HttpStatus.INSUFFICIENT_STORAGE, "internal-server-error", detail, options);
   }
 };
-__name(_NotAcceptableError, "NotAcceptableError");
-var NotAcceptableError = _NotAcceptableError;
-var _ProxyAuthenticationRequiredError = class _ProxyAuthenticationRequiredError extends FreshError {
+__name(_InsufficientStorageError, "InsufficientStorageError");
+var InsufficientStorageError = _InsufficientStorageError;
+var _LoopDetectedError = class _LoopDetectedError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.PROXY_AUTHENTICATION_REQUIRED, "not-authenticated", detail, options);
+    super(HttpStatus.LOOP_DETECTED, "internal-server-error", detail, options);
   }
 };
-__name(_ProxyAuthenticationRequiredError, "ProxyAuthenticationRequiredError");
-var ProxyAuthenticationRequiredError = _ProxyAuthenticationRequiredError;
-var _RequestTimeoutError = class _RequestTimeoutError extends FreshError {
+__name(_LoopDetectedError, "LoopDetectedError");
+var LoopDetectedError = _LoopDetectedError;
+var _NotExtendedError = class _NotExtendedError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.REQUEST_TIMEOUT, "error", detail, options);
+    super(HttpStatus.NOT_EXTENDED, "internal-server-error", detail, options);
   }
 };
-__name(_RequestTimeoutError, "RequestTimeoutError");
-var RequestTimeoutError = _RequestTimeoutError;
-var _ConflictError = class _ConflictError extends FreshError {
+__name(_NotExtendedError, "NotExtendedError");
+var NotExtendedError = _NotExtendedError;
+var _NetworkAuthenticationRequiredError = class _NetworkAuthenticationRequiredError extends FreshError {
   constructor(detail, options) {
-    super(HttpStatus.CONFLICT, "error", detail, options);
+    super(HttpStatus.NETWORK_AUTHENTICATION_REQUIRED, "internal-server-error", detail, options);
   }
 };
-__name(_ConflictError, "ConflictError");
-var ConflictError = _ConflictError;
-var _GoneError = class _GoneError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.GONE, "error", detail, options);
+__name(_NetworkAuthenticationRequiredError, "NetworkAuthenticationRequiredError");
+var NetworkAuthenticationRequiredError = _NetworkAuthenticationRequiredError;
+
+// src/core/data-helper.ts
+var _DataHelper = class _DataHelper {
+  constructor(startDataRetrieve = true, deviceIds) {
+    __publicField(this, "_data");
+    __publicField(this, "_dataPromise", null);
+    __publicField(this, "deviceIds");
+    this.deviceIds = deviceIds;
+    if (startDataRetrieve) {
+      this._dataPromise = this.startDataRetrieval();
+    }
+  }
+  get data() {
+    return this._data;
+  }
+  set data(value) {
+    this._data = value;
+  }
+  get dataPromise() {
+    return this._dataPromise;
+  }
+  set dataPromise(value) {
+    this._dataPromise = value;
+  }
+  async getData() {
+    if (this._dataPromise) {
+      return await this._dataPromise;
+    }
+    if (this._data === void 0) {
+      this._dataPromise = this.startDataRetrieval();
+      return this._dataPromise;
+    }
+    return this._data;
+  }
+};
+__name(_DataHelper, "DataHelper");
+var DataHelper = _DataHelper;
+
+// src/common/pagination/find-options/pagination.ts
+function buildPagination(page, limit) {
+  if (page === void 0 && limit === void 0) {
+    return void 0;
+  }
+  if (page !== void 0 && page < 1 || limit !== void 0 && limit < 0) {
+    throw new ApiError(HttpStatus.BAD_REQUEST, "validation-error", "Pagination parameters cannot be negative");
+  }
+  const p = page != null ? page : 1;
+  const l = limit != null ? limit : 1e3;
+  return {
+    page: p,
+    limit: l,
+    skip: (p - 1) * l
+  };
+}
+__name(buildPagination, "buildPagination");
+
+// src/common/pagination/constructors.ts
+function constructTypeormPagination(params) {
+  return {
+    take: params.limit,
+    skip: params.skip
+  };
+}
+__name(constructTypeormPagination, "constructTypeormPagination");
+function parsePaginationFromURL(searchParams) {
+  var _a, _b;
+  const page = Math.max(1, parseInt((_a = searchParams.get("page")) != null ? _a : "1", 10));
+  const limit = Math.min(100, Math.max(1, parseInt((_b = searchParams.get("limit")) != null ? _b : "20", 10)));
+  return {
+    page,
+    limit,
+    skip: (page - 1) * limit
+  };
+}
+__name(parsePaginationFromURL, "parsePaginationFromURL");
+
+// src/common/pagination/pagination-meta.ts
+function getPaginationMeta(total, page, limit) {
+  return {
+    total,
+    page,
+    limit,
+    totalPages: Math.ceil(total / limit)
+  };
+}
+__name(getPaginationMeta, "getPaginationMeta");
+
+// src/common/pagination/pagination-params.ts
+function getPaginationParams(params) {
+  return {
+    ...DEFAULT_PAGINATION_PARAMS,
+    ...params
+  };
+}
+__name(getPaginationParams, "getPaginationParams");
+var DEFAULT_PAGINATION_PARAMS = {
+  page: 1,
+  limit: 1e3,
+  skip: 0
+};
+
+// src/common/pagination/scrapper.ts
+async function listAll(fetchPage, batchSize = 1e3) {
+  const results = [];
+  let page = 1;
+  while (true) {
+    const { data, meta } = await fetchPage({
+      page,
+      limit: batchSize,
+      skip: (page - 1) * batchSize
+    });
+    results.push(...data);
+    if (page >= meta.totalPages) {
+      break;
+    }
+    page++;
   }
-};
-__name(_GoneError, "GoneError");
-var GoneError = _GoneError;
-var _LengthRequiredError = class _LengthRequiredError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.LENGTH_REQUIRED, "error", detail, options);
+  return results;
+}
+__name(listAll, "listAll");
+
+// src/common/promise-magic/deferred.ts
+function createDeferred() {
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  return {
+    promise,
+    resolve,
+    reject
+  };
+}
+__name(createDeferred, "createDeferred");
+
+// src/common/promise-magic/single-promise-waiter.ts
+var _SinglePromiseWaiter = class _SinglePromiseWaiter {
+  constructor() {
+    __publicField(this, "_promise", null);
   }
-};
-__name(_LengthRequiredError, "LengthRequiredError");
-var LengthRequiredError = _LengthRequiredError;
-var _PreconditionFailedError = class _PreconditionFailedError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.PRECONDITION_FAILED, "error", detail, options);
+  static getInstance() {
+    if (!_SinglePromiseWaiter._instance) {
+      _SinglePromiseWaiter._instance = new _SinglePromiseWaiter();
+    }
+    return _SinglePromiseWaiter._instance;
   }
-};
-__name(_PreconditionFailedError, "PreconditionFailedError");
-var PreconditionFailedError = _PreconditionFailedError;
-var _PayloadTooLargeError = class _PayloadTooLargeError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.PAYLOAD_TOO_LARGE, "error", detail, options);
+  get promise() {
+    return this._promise;
   }
-};
-__name(_PayloadTooLargeError, "PayloadTooLargeError");
-var PayloadTooLargeError = _PayloadTooLargeError;
-var _UriTooLongError = class _UriTooLongError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.URI_TOO_LONG, "error", detail, options);
+  set promise(promise) {
+    if (promise !== null) {
+      this._promise = promise;
+      this._promise.finally(() => {
+        this._promise = null;
+      });
+    }
   }
-};
-__name(_UriTooLongError, "UriTooLongError");
-var UriTooLongError = _UriTooLongError;
-var _UnsupportedMediaTypeError = class _UnsupportedMediaTypeError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.UNSUPPORTED_MEDIA_TYPE, "error", detail, options);
+  get hasPromise() {
+    return this._promise !== null;
   }
 };
-__name(_UnsupportedMediaTypeError, "UnsupportedMediaTypeError");
-var UnsupportedMediaTypeError = _UnsupportedMediaTypeError;
-var _RangeNotSatisfiableError = class _RangeNotSatisfiableError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.RANGE_NOT_SATISFIABLE, "error", detail, options);
+__name(_SinglePromiseWaiter, "SinglePromiseWaiter");
+__publicField(_SinglePromiseWaiter, "_instance");
+var SinglePromiseWaiter = _SinglePromiseWaiter;
+
+// src/common/schema/entities/category.entity.ts
+var import_typeorm6 = require("typeorm");
+
+// src/database/entities/fresh-entity.ts
+var import_typeorm2 = 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");
+var rnds8Pool = new Uint8Array(256);
+var poolPtr = rnds8Pool.length;
+function rng() {
+  if (poolPtr > rnds8Pool.length - 16) {
+    (0, import_crypto.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");
+var native_default = {
+  randomUUID: import_crypto2.randomUUID
 };
-__name(_RangeNotSatisfiableError, "RangeNotSatisfiableError");
-var RangeNotSatisfiableError = _RangeNotSatisfiableError;
-var _ExpectationFailedError = class _ExpectationFailedError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.EXPECTATION_FAILED, "error", detail, options);
+
+// ../../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();
   }
-};
-__name(_ExpectationFailedError, "ExpectationFailedError");
-var ExpectationFailedError = _ExpectationFailedError;
-var _ImATeapotError = class _ImATeapotError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.IM_A_TEAPOT, "error", detail, options);
+  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");
   }
-};
-__name(_ImATeapotError, "ImATeapotError");
-var ImATeapotError = _ImATeapotError;
-var _MisdirectedRequestError = class _MisdirectedRequestError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.MISDIRECTED_REQUEST, "error", detail, options);
+  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];
+    }
+    return buf;
   }
-};
-__name(_MisdirectedRequestError, "MisdirectedRequestError");
-var MisdirectedRequestError = _MisdirectedRequestError;
-var _UnprocessableEntityError = class _UnprocessableEntityError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.UNPROCESSABLE_ENTITY, "validation-error", detail, options);
+  return unsafeStringify(rnds);
+}
+__name(v4, "v4");
+var v4_default = v4;
+
+// src/database/entities/fresh-entity.ts
+function _ts_decorate(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;
+}
+__name(_ts_decorate, "_ts_decorate");
+function _ts_metadata(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata, "_ts_metadata");
+var _FreshEntity = class _FreshEntity extends import_typeorm2.BaseEntity {
+  /** After manual construction `id` is irrelevant. Refer to `uuid` only, because that will be inserted into DB */
+  constructor() {
+    super();
+    __publicField(this, "id");
+    __publicField(this, "uuid");
+    __publicField(this, "created_at");
+    __publicField(this, "updated_at");
+    // for soft delete methods by typeorm
+    __publicField(this, "deleted_at");
+    this.id = 0;
+    this.uuid = v4_default();
+    const newDate = /* @__PURE__ */ new Date();
+    this.created_at = newDate;
+    this.updated_at = newDate;
+    this.deleted_at = null;
   }
 };
-__name(_UnprocessableEntityError, "UnprocessableEntityError");
-var UnprocessableEntityError = _UnprocessableEntityError;
-var _LockedError = class _LockedError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.LOCKED, "error", detail, options);
+__name(_FreshEntity, "FreshEntity");
+var FreshEntity = _FreshEntity;
+_ts_decorate([
+  (0, import_typeorm2.PrimaryGeneratedColumn)("increment"),
+  _ts_metadata("design:type", Number)
+], FreshEntity.prototype, "id", void 0);
+_ts_decorate([
+  (0, import_typeorm2.Index)({
+    unique: true
+  }),
+  (0, import_typeorm2.Column)({
+    type: "uuid",
+    default: /* @__PURE__ */ __name(() => "gen_random_uuid()", "default")
+  }),
+  _ts_metadata("design:type", String)
+], FreshEntity.prototype, "uuid", void 0);
+_ts_decorate([
+  (0, import_typeorm2.CreateDateColumn)({
+    type: "timestamptz"
+  }),
+  _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], FreshEntity.prototype, "created_at", void 0);
+_ts_decorate([
+  (0, import_typeorm2.UpdateDateColumn)({
+    type: "timestamptz"
+  }),
+  _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], FreshEntity.prototype, "updated_at", void 0);
+_ts_decorate([
+  (0, import_typeorm2.DeleteDateColumn)({
+    type: "timestamptz",
+    nullable: true
+  }),
+  _ts_metadata("design:type", Object)
+], FreshEntity.prototype, "deleted_at", void 0);
+
+// src/database/entities/fresh-hyper-entity.ts
+var import_typeorm4 = require("typeorm");
+
+// src/database/decorators/timestamp-column.ts
+var import_typeorm3 = require("typeorm");
+function TimestampColumn(options = {}) {
+  const defaultOptions = {
+    type: "timestamptz",
+    nullable: false,
+    default: /* @__PURE__ */ __name(() => "CURRENT_TIMESTAMP", "default"),
+    ...options
+  };
+  return (0, import_typeorm3.Column)(defaultOptions);
+}
+__name(TimestampColumn, "TimestampColumn");
+
+// src/database/entities/fresh-hyper-entity.ts
+function _ts_decorate2(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;
+}
+__name(_ts_decorate2, "_ts_decorate");
+function _ts_metadata2(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata2, "_ts_metadata");
+var _FreshHyperEntity = class _FreshHyperEntity extends import_typeorm4.BaseEntity {
+  /** After manual construction `id` is irrelevant */
+  constructor(timestamp) {
+    super();
+    // input timestamp as PK
+    __publicField(this, "timestamp");
+    // just info column about time of insert
+    __publicField(this, "created_at");
+    this.timestamp = timestamp != null ? timestamp : /* @__PURE__ */ new Date();
+    this.created_at = /* @__PURE__ */ new Date();
   }
 };
-__name(_LockedError, "LockedError");
-var LockedError = _LockedError;
-var _FailedDependencyError = class _FailedDependencyError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.FAILED_DEPENDENCY, "error", detail, options);
+__name(_FreshHyperEntity, "FreshHyperEntity");
+var FreshHyperEntity = _FreshHyperEntity;
+_ts_decorate2([
+  (0, import_typeorm4.PrimaryColumn)({
+    type: "timestamptz"
+  }),
+  _ts_metadata2("design:type", typeof Date === "undefined" ? Object : Date)
+], FreshHyperEntity.prototype, "timestamp", void 0);
+_ts_decorate2([
+  TimestampColumn(),
+  _ts_metadata2("design:type", typeof Date === "undefined" ? Object : Date)
+], FreshHyperEntity.prototype, "created_at", void 0);
+
+// src/database/entities/fresh-translation-entity.ts
+var import_typeorm5 = require("typeorm");
+function _ts_decorate3(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;
+}
+__name(_ts_decorate3, "_ts_decorate");
+function _ts_metadata3(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata3, "_ts_metadata");
+var languageValues = Object.values(LanguageCode).map((v) => `'${v}'`).join(",");
+var _FreshTranslationBase = class _FreshTranslationBase extends import_typeorm5.BaseEntity {
+  constructor() {
+    super();
+    __publicField(this, "id");
+    __publicField(this, "languageCode");
+    this.id = 0;
+    this.languageCode = LanguageCode.CS;
   }
 };
-__name(_FailedDependencyError, "FailedDependencyError");
-var FailedDependencyError = _FailedDependencyError;
-var _TooEarlyError = class _TooEarlyError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.TOO_EARLY, "error", detail, options);
+__name(_FreshTranslationBase, "FreshTranslationBase");
+var FreshTranslationBase = _FreshTranslationBase;
+_ts_decorate3([
+  (0, import_typeorm5.PrimaryGeneratedColumn)(),
+  _ts_metadata3("design:type", Number)
+], FreshTranslationBase.prototype, "id", void 0);
+_ts_decorate3([
+  (0, import_typeorm5.Column)({
+    type: "varchar",
+    length: 3,
+    nullable: false
+  }),
+  (0, import_typeorm5.Check)(`"languageCode" IN (${languageValues})`),
+  _ts_metadata3("design:type", typeof LanguageCode === "undefined" ? Object : LanguageCode)
+], FreshTranslationBase.prototype, "languageCode", void 0);
+
+// src/database/dao/fresh-dao.ts
+var _FreshDao = class _FreshDao {
+  getRepo(manager, entity = this.entity) {
+    return manager ? manager.getRepository(entity) : this.repo;
   }
 };
-__name(_TooEarlyError, "TooEarlyError");
-var TooEarlyError = _TooEarlyError;
-var _UpgradeRequiredError = class _UpgradeRequiredError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.UPGRADE_REQUIRED, "error", detail, options);
+__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);
+    }
   }
-};
-__name(_UpgradeRequiredError, "UpgradeRequiredError");
-var UpgradeRequiredError = _UpgradeRequiredError;
-var _PreconditionRequiredError = class _PreconditionRequiredError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.PRECONDITION_REQUIRED, "error", detail, options);
+  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);
+    }
   }
-};
-__name(_PreconditionRequiredError, "PreconditionRequiredError");
-var PreconditionRequiredError = _PreconditionRequiredError;
-var _TooManyRequestsError = class _TooManyRequestsError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.TOO_MANY_REQUESTS, "error", detail, options);
+  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);
+    }
   }
-};
-__name(_TooManyRequestsError, "TooManyRequestsError");
-var TooManyRequestsError = _TooManyRequestsError;
-var _RequestHeaderFieldsTooLargeError = class _RequestHeaderFieldsTooLargeError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.REQUEST_HEADER_FIELDS_TOO_LARGE, "error", detail, options);
+  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);
+    }
   }
-};
-__name(_RequestHeaderFieldsTooLargeError, "RequestHeaderFieldsTooLargeError");
-var RequestHeaderFieldsTooLargeError = _RequestHeaderFieldsTooLargeError;
-var _UnavailableForLegalReasonsError = class _UnavailableForLegalReasonsError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.UNAVAILABLE_FOR_LEGAL_REASONS, "error", detail, options);
+  // ─── 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);
+    }
   }
-};
-__name(_UnavailableForLegalReasonsError, "UnavailableForLegalReasonsError");
-var UnavailableForLegalReasonsError = _UnavailableForLegalReasonsError;
-var _InternalServerError = class _InternalServerError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.INTERNAL_SERVER_ERROR, "internal-server-error", detail, options);
+  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(_InternalServerError, "InternalServerError");
-var InternalServerError = _InternalServerError;
-var _NotImplementedError = class _NotImplementedError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.NOT_IMPLEMENTED, "internal-server-error", detail, options);
-  }
+__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;
+  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;
+}
+__name(_ts_decorate4, "_ts_decorate");
+var _Category = class _Category extends FreshEntity {
 };
-__name(_NotImplementedError, "NotImplementedError");
-var NotImplementedError = _NotImplementedError;
-var _BadGatewayError = class _BadGatewayError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.BAD_GATEWAY, "internal-server-error", detail, options);
-  }
+__name(_Category, "Category");
+var Category = _Category;
+Category = _ts_decorate4([
+  (0, import_typeorm6.Entity)()
+], Category);
+
+// src/common/schema/entities/device.entity.ts
+var import_typeorm7 = require("typeorm");
+function _ts_decorate5(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;
+}
+__name(_ts_decorate5, "_ts_decorate");
+var _Device = class _Device extends FreshEntity {
 };
-__name(_BadGatewayError, "BadGatewayError");
-var BadGatewayError = _BadGatewayError;
-var _ServiceUnavailableError = class _ServiceUnavailableError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.SERVICE_UNAVAILABLE, "internal-server-error", detail, options);
-  }
+__name(_Device, "Device");
+var Device = _Device;
+Device = _ts_decorate5([
+  (0, import_typeorm7.Entity)()
+], Device);
+
+// src/common/schema/entities/manufacturer.entity.ts
+var import_typeorm8 = require("typeorm");
+function _ts_decorate6(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;
+}
+__name(_ts_decorate6, "_ts_decorate");
+var _Manufacturer = class _Manufacturer extends FreshEntity {
 };
-__name(_ServiceUnavailableError, "ServiceUnavailableError");
-var ServiceUnavailableError = _ServiceUnavailableError;
-var _GatewayTimeoutError = class _GatewayTimeoutError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.GATEWAY_TIMEOUT, "internal-server-error", detail, options);
-  }
+__name(_Manufacturer, "Manufacturer");
+var Manufacturer = _Manufacturer;
+Manufacturer = _ts_decorate6([
+  (0, import_typeorm8.Entity)()
+], Manufacturer);
+
+// src/common/schema/entities/product.entity.ts
+var import_typeorm9 = require("typeorm");
+function _ts_decorate7(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;
+}
+__name(_ts_decorate7, "_ts_decorate");
+var _Product = class _Product extends FreshEntity {
 };
-__name(_GatewayTimeoutError, "GatewayTimeoutError");
-var GatewayTimeoutError = _GatewayTimeoutError;
-var _HttpVersionNotSupportedError = class _HttpVersionNotSupportedError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.HTTP_VERSION_NOT_SUPPORTED, "internal-server-error", detail, options);
-  }
+__name(_Product, "Product");
+var Product = _Product;
+Product = _ts_decorate7([
+  (0, import_typeorm9.Entity)()
+], Product);
+
+// src/common/schema/entities/subcategory.entity.ts
+var import_typeorm10 = require("typeorm");
+function _ts_decorate8(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;
+}
+__name(_ts_decorate8, "_ts_decorate");
+var _Subcategory = class _Subcategory extends FreshEntity {
 };
-__name(_HttpVersionNotSupportedError, "HttpVersionNotSupportedError");
-var HttpVersionNotSupportedError = _HttpVersionNotSupportedError;
-var _VariantAlsoNegotiatesError = class _VariantAlsoNegotiatesError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.VARIANT_ALSO_NEGOTIATES, "internal-server-error", detail, options);
+__name(_Subcategory, "Subcategory");
+var Subcategory = _Subcategory;
+Subcategory = _ts_decorate8([
+  (0, import_typeorm10.Entity)()
+], Subcategory);
+
+// src/common/typeguards/decimal.ts
+function toDecimal(num, precision = 9, scale = 2) {
+  const limit = Math.pow(10, precision - scale);
+  if (Math.abs(num) >= limit) {
+    throw new Error(`Value ${num} exceeds the allowed precision of ${precision} and scale of ${scale}.`);
   }
-};
-__name(_VariantAlsoNegotiatesError, "VariantAlsoNegotiatesError");
-var VariantAlsoNegotiatesError = _VariantAlsoNegotiatesError;
-var _InsufficientStorageError = class _InsufficientStorageError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.INSUFFICIENT_STORAGE, "internal-server-error", detail, options);
+  return num.toFixed(scale);
+}
+__name(toDecimal, "toDecimal");
+function isDecimal(v, options) {
+  var _a, _b, _c;
+  const type = typeof v;
+  if ((options == null ? void 0 : options.allowedType) !== void 0 && type !== options.allowedType) {
+    return false;
   }
-};
-__name(_InsufficientStorageError, "InsufficientStorageError");
-var InsufficientStorageError = _InsufficientStorageError;
-var _LoopDetectedError = class _LoopDetectedError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.LOOP_DETECTED, "internal-server-error", detail, options);
+  if (type !== "number" && type !== "string") {
+    return false;
   }
-};
-__name(_LoopDetectedError, "LoopDetectedError");
-var LoopDetectedError = _LoopDetectedError;
-var _NotExtendedError = class _NotExtendedError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.NOT_EXTENDED, "internal-server-error", detail, options);
+  const sep = (_a = options == null ? void 0 : options.decimalPoint) != null ? _a : ".";
+  let intPart;
+  let fracPart;
+  if (type === "number") {
+    const n = v;
+    if (!Number.isFinite(n)) {
+      return false;
+    }
+    const str = n.toString();
+    if (str.includes("e") || str.includes("E")) {
+      return false;
+    }
+    const parts = str.replace("-", "").split(".");
+    intPart = parts[0];
+    fracPart = (_b = parts[1]) != null ? _b : "";
+  } else {
+    const s = v;
+    const escapedSep = sep === "." ? "\\." : ",";
+    const pattern = new RegExp(`^-?\\d+(?:${escapedSep}\\d+)?$`);
+    if (!pattern.test(s)) {
+      return false;
+    }
+    const parts = s.replace("-", "").split(sep);
+    intPart = parts[0];
+    fracPart = (_c = parts[1]) != null ? _c : "";
   }
-};
-__name(_NotExtendedError, "NotExtendedError");
-var NotExtendedError = _NotExtendedError;
-var _NetworkAuthenticationRequiredError = class _NetworkAuthenticationRequiredError extends FreshError {
-  constructor(detail, options) {
-    super(HttpStatus.NETWORK_AUTHENTICATION_REQUIRED, "internal-server-error", detail, options);
+  if ((options == null ? void 0 : options.scale) !== void 0 && fracPart.length > options.scale) {
+    return false;
   }
-};
-__name(_NetworkAuthenticationRequiredError, "NetworkAuthenticationRequiredError");
-var NetworkAuthenticationRequiredError = _NetworkAuthenticationRequiredError;
+  return (options == null ? void 0 : options.precision) === void 0 || intPart.length + fracPart.length <= options.precision;
+}
+__name(isDecimal, "isDecimal");
 
-// src/core/data-helper.ts
-var _DataHelper = class _DataHelper {
-  constructor(startDataRetrieve = true, deviceIds) {
-    __publicField(this, "_data");
-    __publicField(this, "_dataPromise", null);
-    __publicField(this, "deviceIds");
-    this.deviceIds = deviceIds;
-    if (startDataRetrieve) {
-      this._dataPromise = this.startDataRetrieval();
-    }
-  }
-  get data() {
-    return this._data;
+// src/common/typeguards/enums.ts
+function isEnumValue(enumObj, v) {
+  if (!enumObj) {
+    return typeof v === "string" || typeof v === "number";
   }
-  set data(value) {
-    this._data = value;
+  const values = new Set(Object.values(enumObj));
+  return (typeof v === "string" || typeof v === "number") && values.has(v);
+}
+__name(isEnumValue, "isEnumValue");
+
+// src/common/typeguards/objects.ts
+function isObject(v) {
+  return typeof v === "object" && v !== null;
+}
+__name(isObject, "isObject");
+function hasOwn(obj, key) {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+__name(hasOwn, "hasOwn");
+
+// src/common/typeguards/primitives.ts
+function isNumber(v) {
+  return typeof v === "number" && Number.isFinite(v);
+}
+__name(isNumber, "isNumber");
+function isString(v) {
+  return typeof v === "string";
+}
+__name(isString, "isString");
+function isFlag01(v) {
+  return v === 0 || v === 1;
+}
+__name(isFlag01, "isFlag01");
+function isNumberInRange(v, min, max, options) {
+  var _a, _b;
+  if (!isNumber(v)) {
+    return false;
   }
-  get dataPromise() {
-    return this._dataPromise;
+  const includeMin = (_a = options == null ? void 0 : options.includeMin) != null ? _a : true;
+  const includeMax = (_b = options == null ? void 0 : options.includeMax) != null ? _b : true;
+  if (includeMin ? v < min : v <= min) {
+    return false;
   }
-  set dataPromise(value) {
-    this._dataPromise = value;
+  if (includeMax ? v > max : v >= max) {
+    return false;
   }
-  async getData() {
-    if (this._dataPromise) {
-      return await this._dataPromise;
+  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;
     }
-    if (this._data === void 0) {
-      this._dataPromise = this.startDataRetrieval();
-      return this._dataPromise;
+    await worker(item);
+    await runNext();
+  }, "runNext");
+  await Promise.all(Array.from({
+    length: Math.min(concurrency, items.length)
+  }, runNext));
+}
+__name(runWithConcurrency, "runWithConcurrency");
+
+// src/common/utils/id-path-param-resolver.utils.ts
+function resolvePathParameterId(id) {
+  return /^\d+$/.test(id) ? parseInt(id, 10) : id;
+}
+__name(resolvePathParameterId, "resolvePathParameterId");
+
+// src/common/utils/is-cron-valid.ts
+function isValidCron(expr) {
+  const parts = expr.trim().split(/\s+/);
+  if (parts.length < 5 || parts.length > 6) {
+    return false;
+  }
+  const cronPart = /^(\*|\d+|\d+\-\d+|\d+\/\d+|\*\/\d+)(,\d+)*$/;
+  return parts.every((part) => cronPart.test(part));
+}
+__name(isValidCron, "isValidCron");
+
+// 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;
     }
-    return this._data;
+    patch[k] = (transforms == null ? void 0 : transforms[k]) ? transforms[k](value) : value;
   }
-};
-__name(_DataHelper, "DataHelper");
-var DataHelper = _DataHelper;
+  return patch;
+}
+__name(buildPatch, "buildPatch");
 
 // src/types/maybe-type.ts
 function isMaybe(v, inner) {
@@ -2333,6 +2383,9 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   UpgradeRequiredError,
   UriTooLongError,
   VariantAlsoNegotiatesError,
+  buildDateRange,
+  buildOrder,
+  buildPagination,
   buildPatch,
   constructTypeormPagination,
   createDeferred,