@freshpointcz/fresh-core 0.0.17 → 0.0.18

package/dist/index.d.mts

@@ -474,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;
 /**
@@ -605,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[];
@@ -682,4 +734,4 @@ interface HealthCheckResult {
     };
 }
 
-export { AMOUNT_UNIT, ActionCommandCode, ApiError, BaseEntityChangeSubscriber, type CardNumber, Category, DataHelper, DateUtils, type Deferred, DepotPoolStatus, Device, type EntityChangeEvent, FreshDao, FreshEntity, FreshHyperEntity, FreshJob, FreshTranslationBase, type HealthCheckResult, HttpStatus, LanguageCode, Manufacturer, type Maybe, PaymentMethod, PG_DATA_SOURCE_OPTIONS as PgDataSourceOptions, Product, SinglePromiseWaiter, Singleton, type Status, StatusDto, Subcategory, TimestampColumn, TransactionType, createDeferred, FRESH_ESLINT_CONFIG as freshEslintConfig, hasOwn, isEnumValue, isFlag01, isMaybe, isNumber, isNumberInRange, isObject, isString, isValidCron };
+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

@@ -474,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;
 /**
@@ -605,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[];
@@ -682,4 +734,4 @@ interface HealthCheckResult {
     };
 }
 
-export { AMOUNT_UNIT, ActionCommandCode, ApiError, BaseEntityChangeSubscriber, type CardNumber, Category, DataHelper, DateUtils, type Deferred, DepotPoolStatus, Device, type EntityChangeEvent, FreshDao, FreshEntity, FreshHyperEntity, FreshJob, FreshTranslationBase, type HealthCheckResult, HttpStatus, LanguageCode, Manufacturer, type Maybe, PaymentMethod, PG_DATA_SOURCE_OPTIONS as PgDataSourceOptions, Product, SinglePromiseWaiter, Singleton, type Status, StatusDto, Subcategory, TimestampColumn, TransactionType, createDeferred, FRESH_ESLINT_CONFIG as freshEslintConfig, hasOwn, isEnumValue, isFlag01, isMaybe, isNumber, isNumberInRange, isObject, isString, isValidCron };
+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) {
@@ -429,6 +429,7 @@ __export(index_exports, {
   ActionCommandCode: () => ActionCommandCode,
   ApiError: () => ApiError,
   BaseEntityChangeSubscriber: () => BaseEntityChangeSubscriber,
+  BusinessWarning: () => BusinessWarning,
   Category: () => Category,
   DataHelper: () => DataHelper,
   DateUtils: () => DateUtils,
@@ -449,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 +464,8 @@ __export(index_exports, {
   isNumberInRange: () => isNumberInRange,
   isObject: () => isObject,
   isString: () => isString,
-  isValidCron: () => isValidCron
+  isValidCron: () => isValidCron,
+  runWithConcurrency: () => runWithConcurrency
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -815,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];
     }
@@ -1367,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 {
@@ -1541,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);
@@ -1735,6 +1792,7 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   ActionCommandCode,
   ApiError,
   BaseEntityChangeSubscriber,
+  BusinessWarning,
   Category,
   DataHelper,
   DateUtils,
@@ -1755,8 +1813,10 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   Singleton,
   StatusDto,
   Subcategory,
+  TO_BINARY_FLAG,
   TimestampColumn,
   TransactionType,
+  buildPatch,
   createDeferred,
   freshEslintConfig,
   hasOwn,
@@ -1767,6 +1827,7 @@ var datasource_default = PG_DATA_SOURCE_OPTIONS;
   isNumberInRange,
   isObject,
   isString,
-  isValidCron
+  isValidCron,
+  runWithConcurrency
 });
 //# sourceMappingURL=index.js.map