@squiz/optimization-utils 7.1.1 → 7.2.0-rc1

package/dist/mjs/data-structures/Result.d.ts

@@ -0,0 +1,50 @@
+export type ResultType = 'success' | 'failure';
+export type ResultFailure<ThisType extends Result<unknown, unknown>, TError> = Omit<ThisType, 'data' | 'error' | 'type'> & {
+    error: TError;
+    data: never;
+    type: 'failure';
+};
+export type ResultSuccess<ThisType extends Result<unknown, unknown>, TData> = Omit<ThisType, 'data' | 'error' | 'type'> & {
+    data: TData;
+    error: never;
+    type: 'success';
+};
+export declare class Result<const TData, const TError = Error> {
+    readonly type: ResultType;
+    readonly data?: TData;
+    readonly error?: TError;
+    private constructor();
+    static success<const U>(data?: U): Result<U, never>;
+    static failure<const TError>(error: TError): Result<never, TError>;
+    isSuccess<ThisType extends Result<TData, TError>>(this: ThisType): this is ResultSuccess<ThisType, TData>;
+    isFailure<ThisType extends Result<TData, TError>>(this: ThisType): this is ResultFailure<ThisType, TError>;
+    /**
+     * Type guard: checks if the error in this Result is an instance of the provided
+     * error constructors or equals any of the provided error values. When it returns true,
+     * the result is narrowed to `Result<never, TErrorGuard>`.
+     *
+     * @example
+     * ```typescript
+     * const result = Result.failure(new TypeError('Invalid type'));
+     * if (result.isErrorInstanceOf(TypeError)) {
+     *   result.error; // narrowed to TypeError
+     * }
+     * result.isErrorInstanceOf(TypeError, RangeError); // true -> error is TypeError | RangeError
+     *
+     * const strResult = Result.failure('MISSING_QUERY_EXECUTION_ID');
+     * if (strResult.isErrorInstanceOf('MISSING_QUERY_EXECUTION_ID')) {
+     *   strResult.error; // narrowed to 'MISSING_QUERY_EXECUTION_ID'
+     * }
+     * ```
+     */
+    isErrorInstanceOf<ThisType extends Result<TData, TError>, TErrorGuard extends TError>(this: ThisType, ...errorTypes: Array<(new (...args: Array<any>) => TErrorGuard) | TErrorGuard>): this is ResultFailure<ThisType, TErrorGuard>;
+    throw(): never | void;
+    unwrap(): TData;
+    match<TResult, TErrorResult>(handlers: {
+        success: (data: TData, resultThis: Result<TData, TError>) => TResult;
+        failure: (error: TError, resultThis: Result<TData, TError>) => TErrorResult;
+    }): TResult | TErrorResult;
+    toFailure(): Result<never, TError>;
+    toSuccess(): Result<TData, never>;
+}
+//# sourceMappingURL=Result.d.ts.map

package/dist/mjs/data-structures/Result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../../src/data-structures/Result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/C,MAAM,MAAM,aAAa,CACvB,QAAQ,SAAS,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EACzC,MAAM,IACJ,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,CACvB,QAAQ,SAAS,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EACzC,KAAK,IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG;IAC9C,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF,qBAAa,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK;IACnD,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,IAAI,CAAC,EAAE,KAAK,CAAC;IAC7B,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAE/B,OAAO;IAMP,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC;IAInD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;IAIlE,SAAS,CAAC,QAAQ,SAAS,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAC9C,IAAI,EAAE,QAAQ,GACb,IAAI,IAAI,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC;IAIzC,SAAS,CAAC,QAAQ,SAAS,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAC9C,IAAI,EAAE,QAAQ,GACb,IAAI,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC;IAI1C;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CACf,QAAQ,SAAS,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EACtC,WAAW,SAAS,MAAM,EAE1B,IAAI,EAAE,QAAQ,EACd,GAAG,UAAU,EAAE,KAAK,CAElB,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,WAAW,CAAC,GAAG,WAAW,CACzD,GACA,IAAI,IAAI,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC;IAa/C,KAAK,IAAI,KAAK,GAAG,IAAI;IAMrB,MAAM,IAAI,KAAK;IAQf,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE;QACrC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC;QACrE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,YAAY,CAAC;KAC7E,GAAG,OAAO,GAAG,YAAY;IAQ1B,SAAS,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;IAQlC,SAAS,IAAI,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;CAOlC"}

package/dist/mjs/data-structures/Result.js

@@ -0,0 +1,84 @@
+class Result {
+  type;
+  data;
+  error;
+  constructor(type, data, error) {
+    this.type = type;
+    this.data = data;
+    this.error = error;
+  }
+  static success(data) {
+    return new Result("success", data, void 0);
+  }
+  static failure(error) {
+    return new Result("failure", void 0, error);
+  }
+  isSuccess() {
+    return this.type === "success";
+  }
+  isFailure() {
+    return this.type === "failure";
+  }
+  /**
+   * Type guard: checks if the error in this Result is an instance of the provided
+   * error constructors or equals any of the provided error values. When it returns true,
+   * the result is narrowed to `Result<never, TErrorGuard>`.
+   *
+   * @example
+   * ```typescript
+   * const result = Result.failure(new TypeError('Invalid type'));
+   * if (result.isErrorInstanceOf(TypeError)) {
+   *   result.error; // narrowed to TypeError
+   * }
+   * result.isErrorInstanceOf(TypeError, RangeError); // true -> error is TypeError | RangeError
+   *
+   * const strResult = Result.failure('MISSING_QUERY_EXECUTION_ID');
+   * if (strResult.isErrorInstanceOf('MISSING_QUERY_EXECUTION_ID')) {
+   *   strResult.error; // narrowed to 'MISSING_QUERY_EXECUTION_ID'
+   * }
+   * ```
+   */
+  isErrorInstanceOf(...errorTypes) {
+    return errorTypes.some((errorType) => {
+      if (typeof errorType === "function") {
+        return this.error instanceof errorType;
+      }
+      return this.error === errorType;
+    });
+  }
+  throw() {
+    if (this.error) {
+      throw this.error;
+    }
+  }
+  unwrap() {
+    if (this.isFailure()) {
+      throw this.error;
+    } else {
+      return this.data;
+    }
+  }
+  match(handlers) {
+    if (this.isSuccess()) {
+      return handlers.success(this.data, this);
+    } else {
+      return handlers.failure(this.error, this);
+    }
+  }
+  toFailure() {
+    if (this.isSuccess()) {
+      throw new Error("Cannot convert a successful result to a failure result");
+    }
+    return Result.failure(this.error);
+  }
+  toSuccess() {
+    if (this.isFailure()) {
+      throw new Error("Cannot convert a failed result to a success result");
+    }
+    return Result.success(this.data);
+  }
+}
+export {
+  Result
+};
+//# sourceMappingURL=Result.js.map

package/dist/mjs/data-structures/Result.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/data-structures/Result.ts"],
+  "sourcesContent": ["export type ResultType = 'success' | 'failure';\n\nexport type ResultFailure<\n  ThisType extends Result<unknown, unknown>,\n  TError,\n> = Omit<ThisType, 'data' | 'error' | 'type'> & {\n  error: TError;\n  data: never;\n  type: 'failure';\n};\n\nexport type ResultSuccess<\n  ThisType extends Result<unknown, unknown>,\n  TData,\n> = Omit<ThisType, 'data' | 'error' | 'type'> & {\n  data: TData;\n  error: never;\n  type: 'success';\n};\n\nexport class Result<const TData, const TError = Error> {\n  public readonly type: ResultType;\n  public readonly data?: TData;\n  public readonly error?: TError;\n\n  private constructor(type: ResultType, data?: TData, error?: TError) {\n    this.type = type;\n    this.data = data;\n    this.error = error;\n  }\n\n  static success<const U>(data?: U): Result<U, never> {\n    return new Result<U, never>('success', data, undefined);\n  }\n\n  static failure<const TError>(error: TError): Result<never, TError> {\n    return new Result<never, TError>('failure', undefined, error);\n  }\n\n  isSuccess<ThisType extends Result<TData, TError>>(\n    this: ThisType,\n  ): this is ResultSuccess<ThisType, TData> {\n    return this.type === 'success';\n  }\n\n  isFailure<ThisType extends Result<TData, TError>>(\n    this: ThisType,\n  ): this is ResultFailure<ThisType, TError> {\n    return this.type === 'failure';\n  }\n\n  /**\n   * Type guard: checks if the error in this Result is an instance of the provided\n   * error constructors or equals any of the provided error values. When it returns true,\n   * the result is narrowed to `Result<never, TErrorGuard>`.\n   *\n   * @example\n   * ```typescript\n   * const result = Result.failure(new TypeError('Invalid type'));\n   * if (result.isErrorInstanceOf(TypeError)) {\n   *   result.error; // narrowed to TypeError\n   * }\n   * result.isErrorInstanceOf(TypeError, RangeError); // true -> error is TypeError | RangeError\n   *\n   * const strResult = Result.failure('MISSING_QUERY_EXECUTION_ID');\n   * if (strResult.isErrorInstanceOf('MISSING_QUERY_EXECUTION_ID')) {\n   *   strResult.error; // narrowed to 'MISSING_QUERY_EXECUTION_ID'\n   * }\n   * ```\n   */\n  isErrorInstanceOf<\n    ThisType extends Result<TData, TError>,\n    TErrorGuard extends TError,\n  >(\n    this: ThisType,\n    ...errorTypes: Array<\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (new (...args: Array<any>) => TErrorGuard) | TErrorGuard\n    >\n  ): this is ResultFailure<ThisType, TErrorGuard> {\n    return errorTypes.some((errorType) => {\n      if (typeof errorType === 'function') {\n        return (\n          this.error instanceof\n          (errorType as new (...args: Array<unknown>) => TErrorGuard)\n        );\n      }\n\n      return this.error === errorType;\n    });\n  }\n\n  throw(): never | void {\n    if (this.error) {\n      throw this.error;\n    }\n  }\n\n  unwrap(): TData {\n    if (this.isFailure()) {\n      throw this.error;\n    } else {\n      return this.data!;\n    }\n  }\n\n  match<TResult, TErrorResult>(handlers: {\n    success: (data: TData, resultThis: Result<TData, TError>) => TResult;\n    failure: (error: TError, resultThis: Result<TData, TError>) => TErrorResult;\n  }): TResult | TErrorResult {\n    if (this.isSuccess()) {\n      return handlers.success(this.data!, this);\n    } else {\n      return handlers.failure(this.error!, this);\n    }\n  }\n\n  toFailure(): Result<never, TError> {\n    if (this.isSuccess()) {\n      throw new Error('Cannot convert a successful result to a failure result');\n    }\n\n    return Result.failure(this.error!);\n  }\n\n  toSuccess(): Result<TData, never> {\n    if (this.isFailure()) {\n      throw new Error('Cannot convert a failed result to a success result');\n    }\n\n    return Result.success(this.data!);\n  }\n}\n"],
+  "mappings": "AAoBO,MAAM,OAA0C;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,MAAkB,MAAc,OAAgB;AAClE,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,OAAO,QAAiB,MAA4B;AAClD,WAAO,IAAI,OAAiB,WAAW,MAAM,MAAS;AAAA,EACxD;AAAA,EAEA,OAAO,QAAsB,OAAsC;AACjE,WAAO,IAAI,OAAsB,WAAW,QAAW,KAAK;AAAA,EAC9D;AAAA,EAEA,YAE0C;AACxC,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,YAE2C;AACzC,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,qBAKK,YAI2C;AAC9C,WAAO,WAAW,KAAK,CAAC,cAAc;AACpC,UAAI,OAAO,cAAc,YAAY;AACnC,eACE,KAAK,iBACJ;AAAA,MAEL;AAEA,aAAO,KAAK,UAAU;AAAA,IACxB,CAAC;AAAA,EACH;AAAA,EAEA,QAAsB;AACpB,QAAI,KAAK,OAAO;AACd,YAAM,KAAK;AAAA,IACb;AAAA,EACF;AAAA,EAEA,SAAgB;AACd,QAAI,KAAK,UAAU,GAAG;AACpB,YAAM,KAAK;AAAA,IACb,OAAO;AACL,aAAO,KAAK;AAAA,IACd;AAAA,EACF;AAAA,EAEA,MAA6B,UAGF;AACzB,QAAI,KAAK,UAAU,GAAG;AACpB,aAAO,SAAS,QAAQ,KAAK,MAAO,IAAI;AAAA,IAC1C,OAAO;AACL,aAAO,SAAS,QAAQ,KAAK,OAAQ,IAAI;AAAA,IAC3C;AAAA,EACF;AAAA,EAEA,YAAmC;AACjC,QAAI,KAAK,UAAU,GAAG;AACpB,YAAM,IAAI,MAAM,wDAAwD;AAAA,IAC1E;AAEA,WAAO,OAAO,QAAQ,KAAK,KAAM;AAAA,EACnC;AAAA,EAEA,YAAkC;AAChC,QAAI,KAAK,UAAU,GAAG;AACpB,YAAM,IAAI,MAAM,oDAAoD;AAAA,IACtE;AAEA,WAAO,OAAO,QAAQ,KAAK,IAAK;AAAA,EAClC;AACF;",
+  "names": []
+}

package/dist/mjs/data-structures/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Result.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mjs/data-structures/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data-structures/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/mjs/data-structures/index.js

@@ -0,0 +1,2 @@
+export * from "./Result.js";
+//# sourceMappingURL=index.js.map

package/dist/mjs/data-structures/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/data-structures/index.ts"],
+  "sourcesContent": ["export * from './Result';\n"],
+  "mappings": "AAAA,cAAc;",
+  "names": []
+}

package/dist/mjs/index.d.ts

@@ -0,0 +1,14 @@
+export * from './types/class-utilities-types.js';
+export * from './retries/Retries.js';
+export * from './queue/LRUQueue.js';
+export * from './queue/LRUQueueFactory.js';
+export * from './promises/PromiseMaxConcurrency.js';
+export * from './object/getProperty.js';
+export * from './metadata/CopyReflection.js';
+export * from './measurement/performance.js';
+export * from './logging/Log.js';
+export * from './data-structures/Result.js';
+export * from './change-tracker/ChangeTracker.js';
+export * from './array/chunkify.js';
+export * from './array/unique.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/mjs/index.js

@@ -0,0 +1,14 @@
+export * from "./types/class-utilities-types.js";
+export * from "./retries/Retries.js";
+export * from "./queue/LRUQueue.js";
+export * from "./queue/LRUQueueFactory.js";
+export * from "./promises/PromiseMaxConcurrency.js";
+export * from "./object/getProperty.js";
+export * from "./metadata/CopyReflection.js";
+export * from "./measurement/performance.js";
+export * from "./logging/Log.js";
+export * from "./data-structures/Result.js";
+export * from "./change-tracker/ChangeTracker.js";
+export * from "./array/chunkify.js";
+export * from "./array/unique.js";
+//# sourceMappingURL=index.js.map

package/dist/mjs/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["export * from './types/class-utilities-types';\nexport * from './retries/Retries';\nexport * from './queue/LRUQueue';\nexport * from './queue/LRUQueueFactory';\nexport * from './promises/PromiseMaxConcurrency';\nexport * from './object/getProperty';\nexport * from './metadata/CopyReflection';\nexport * from './measurement/performance';\nexport * from './logging/Log';\nexport * from './data-structures/Result';\nexport * from './change-tracker/ChangeTracker';\nexport * from './array/chunkify';\nexport * from './array/unique';\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/mjs/logging/Log.d.ts

@@ -0,0 +1,19 @@
+import { Logger } from '@squiz/optimization-logger';
+type MetadataCallback = (...args: Array<any>) => Record<string, unknown>;
+type ErrorCallback = (error: unknown) => Record<string, unknown>;
+type SuccessCallback = (result: any, ...args: Array<any>) => Record<string, unknown>;
+export type LogOptions = {
+    before?: string;
+    success?: string;
+    error?: string;
+    metadata?: MetadataCallback;
+    errorMetadata?: ErrorCallback;
+    successMetadata?: SuccessCallback;
+    loggingLevel?: keyof Logger;
+    loggingSuccessLevel?: keyof Logger;
+    loggingErrorLevel?: keyof Logger;
+    loggingResultFailureAsError?: boolean;
+};
+export declare function Log(options: LogOptions): MethodDecorator;
+export {};
+//# sourceMappingURL=Log.d.ts.map

package/dist/mjs/logging/Log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Log.d.ts","sourceRoot":"","sources":["../../../src/logging/Log.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAKlE,KAAK,gBAAgB,GAAG,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACzE,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjE,KAAK,eAAe,GAAG,CAErB,MAAM,EAAE,GAAG,EAEX,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA+F7B,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC,CAAC;AAEF,wBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CAkCxD"}

package/dist/mjs/logging/Log.js

@@ -0,0 +1,103 @@
+import util from "node:util";
+import { inject } from "inversify";
+import { createLogger, Logger } from "@squiz/optimization-logger";
+import { Result } from "../data-structures/index.js";
+import { CopyReflection } from "../metadata/CopyReflection.js";
+function _log(callback, {
+  args,
+  logOptions,
+  propertyKey
+}, logger) {
+  const defaultError = "Error while executing the method";
+  const metadata = logOptions.metadata?.(...args);
+  const loggingLevel = logOptions.loggingLevel ?? "debug";
+  const successLoggingLevel = logOptions.loggingSuccessLevel ?? "debug";
+  const errorLoggingLevel = logOptions.loggingErrorLevel ?? "error";
+  const method = propertyKey;
+  const logError = (resultOrError) => {
+    const isResultFailure = resultOrError instanceof Result && resultOrError.isFailure();
+    if (isResultFailure && !logOptions.loggingResultFailureAsError) {
+      return;
+    }
+    const error = isResultFailure ? resultOrError.error : resultOrError;
+    const errorMetadata = logOptions.errorMetadata?.(error);
+    logger[errorLoggingLevel]({
+      message: logOptions.error ?? defaultError,
+      error,
+      method,
+      ...metadata,
+      ...errorMetadata
+    });
+  };
+  const logAfter = (v) => {
+    if (v instanceof Result && v.isFailure()) {
+      logError(v);
+    } else if (logOptions.success) {
+      const successMetadata = logOptions.successMetadata?.(v, ...args);
+      logger[successLoggingLevel]({
+        message: logOptions.success,
+        method,
+        ...metadata,
+        ...successMetadata
+      });
+    }
+  };
+  if (logOptions.before) {
+    logger[loggingLevel]({
+      message: logOptions.before,
+      method,
+      ...metadata
+    });
+  }
+  let result;
+  try {
+    result = callback();
+    if (!util.types.isPromise(result)) {
+      logAfter(result);
+      return result;
+    }
+  } catch (e) {
+    logError(e);
+    throw e;
+  }
+  return result.catch((e) => {
+    logError(e);
+    throw e;
+  }).then((v) => {
+    logAfter(v);
+    return v;
+  });
+}
+function Log(options) {
+  return function(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    const injection = inject(Logger);
+    const loggerSymbol = /* @__PURE__ */ Symbol("logger");
+    if (!Reflect.has(target, loggerSymbol)) {
+      injection(target, loggerSymbol);
+    }
+    descriptor.value = function(...args) {
+      const logger = this[loggerSymbol] || createLogger();
+      return _log(
+        () => {
+          return originalMethod.apply(this, args);
+        },
+        {
+          logOptions: options,
+          propertyKey,
+          args
+        },
+        logger
+      );
+    };
+    CopyReflection.copyPropertyMetadata(
+      originalMethod,
+      descriptor.value,
+      propertyKey
+    );
+  };
+}
+export {
+  Log
+};
+//# sourceMappingURL=Log.js.map

package/dist/mjs/logging/Log.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/logging/Log.ts"],
+  "sourcesContent": ["import util from 'node:util';\nimport { inject } from 'inversify';\nimport { createLogger, Logger } from '@squiz/optimization-logger';\nimport { Result } from '../data-structures';\nimport { CopyReflection } from '../metadata/CopyReflection';\n\n/* eslint-disable-next-line @typescript-eslint/no-explicit-any */\ntype MetadataCallback = (...args: Array<any>) => Record<string, unknown>;\ntype ErrorCallback = (error: unknown) => Record<string, unknown>;\ntype SuccessCallback = (\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  result: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ...args: Array<any>\n) => Record<string, unknown>;\n\nfunction _log<T>(\n  callback: () => T | Promise<T>,\n  {\n    args,\n    logOptions,\n    propertyKey,\n  }: {\n    logOptions: LogOptions;\n    args: Array<unknown>;\n    propertyKey: string | symbol;\n  },\n  logger: Logger,\n): T | Promise<T> {\n  const defaultError = 'Error while executing the method';\n  const metadata = logOptions.metadata?.(...args);\n  const loggingLevel = logOptions.loggingLevel ?? 'debug';\n  const successLoggingLevel = logOptions.loggingSuccessLevel ?? 'debug';\n  const errorLoggingLevel = logOptions.loggingErrorLevel ?? 'error';\n\n  const method = propertyKey;\n\n  const logError = (resultOrError?: unknown): void => {\n    const isResultFailure =\n      resultOrError instanceof Result && resultOrError.isFailure();\n\n    if (isResultFailure && !logOptions.loggingResultFailureAsError) {\n      return;\n    }\n\n    const error = isResultFailure ? resultOrError.error : resultOrError;\n\n    const errorMetadata = logOptions.errorMetadata?.(error);\n\n    logger[errorLoggingLevel]({\n      message: logOptions.error ?? defaultError,\n      error,\n      method,\n      ...metadata,\n      ...errorMetadata,\n    });\n  };\n\n  const logAfter = (v: unknown): void => {\n    if (v instanceof Result && v.isFailure()) {\n      logError(v);\n    } else if (logOptions.success) {\n      const successMetadata = logOptions.successMetadata?.(v, ...args);\n\n      logger[successLoggingLevel]({\n        message: logOptions.success,\n        method,\n        ...metadata,\n        ...successMetadata,\n      });\n    }\n  };\n\n  if (logOptions.before) {\n    logger[loggingLevel]({\n      message: logOptions.before,\n      method,\n      ...metadata,\n    });\n  }\n\n  let result: T | Promise<T>;\n\n  try {\n    result = callback();\n\n    if (!util.types.isPromise(result)) {\n      logAfter(result);\n\n      return result;\n    }\n  } catch (e) {\n    logError(e);\n\n    throw e;\n  }\n\n  return result\n    .catch((e) => {\n      logError(e);\n\n      throw e;\n    })\n    .then((v) => {\n      logAfter(v);\n      return v;\n    });\n}\n\nexport type LogOptions = {\n  before?: string;\n  success?: string;\n  error?: string;\n  metadata?: MetadataCallback;\n  errorMetadata?: ErrorCallback;\n  successMetadata?: SuccessCallback;\n  loggingLevel?: keyof Logger;\n  loggingSuccessLevel?: keyof Logger;\n  loggingErrorLevel?: keyof Logger;\n  loggingResultFailureAsError?: boolean;\n};\n\nexport function Log(options: LogOptions): MethodDecorator {\n  return function (target, propertyKey, descriptor: PropertyDescriptor): void {\n    const originalMethod = descriptor.value;\n\n    const injection = inject(Logger);\n    const loggerSymbol = Symbol('logger');\n\n    if (!Reflect.has(target, loggerSymbol)) {\n      injection(target, loggerSymbol);\n    }\n\n    descriptor.value = function (...args: Array<unknown>): unknown {\n      const logger =\n        (this as { [loggerSymbol]: Logger })[loggerSymbol] || createLogger();\n\n      return _log(\n        () => {\n          return originalMethod.apply(this, args);\n        },\n        {\n          logOptions: options,\n          propertyKey,\n          args,\n        },\n        logger,\n      );\n    };\n\n    CopyReflection.copyPropertyMetadata(\n      originalMethod,\n      descriptor.value,\n      propertyKey,\n    );\n  };\n}\n"],
+  "mappings": "AAAA,OAAO,UAAU;AACjB,SAAS,cAAc;AACvB,SAAS,cAAc,cAAc;AACrC,SAAS,cAAc;AACvB,SAAS,sBAAsB;AAY/B,SAAS,KACP,UACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF,GAKA,QACgB;AAChB,QAAM,eAAe;AACrB,QAAM,WAAW,WAAW,WAAW,GAAG,IAAI;AAC9C,QAAM,eAAe,WAAW,gBAAgB;AAChD,QAAM,sBAAsB,WAAW,uBAAuB;AAC9D,QAAM,oBAAoB,WAAW,qBAAqB;AAE1D,QAAM,SAAS;AAEf,QAAM,WAAW,CAAC,kBAAkC;AAClD,UAAM,kBACJ,yBAAyB,UAAU,cAAc,UAAU;AAE7D,QAAI,mBAAmB,CAAC,WAAW,6BAA6B;AAC9D;AAAA,IACF;AAEA,UAAM,QAAQ,kBAAkB,cAAc,QAAQ;AAEtD,UAAM,gBAAgB,WAAW,gBAAgB,KAAK;AAEtD,WAAO,iBAAiB,EAAE;AAAA,MACxB,SAAS,WAAW,SAAS;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,GAAG;AAAA,MACH,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAEA,QAAM,WAAW,CAAC,MAAqB;AACrC,QAAI,aAAa,UAAU,EAAE,UAAU,GAAG;AACxC,eAAS,CAAC;AAAA,IACZ,WAAW,WAAW,SAAS;AAC7B,YAAM,kBAAkB,WAAW,kBAAkB,GAAG,GAAG,IAAI;AAE/D,aAAO,mBAAmB,EAAE;AAAA,QAC1B,SAAS,WAAW;AAAA,QACpB;AAAA,QACA,GAAG;AAAA,QACH,GAAG;AAAA,MACL,CAAC;AAAA,IACH;AAAA,EACF;AAEA,MAAI,WAAW,QAAQ;AACrB,WAAO,YAAY,EAAE;AAAA,MACnB,SAAS,WAAW;AAAA,MACpB;AAAA,MACA,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AAEA,MAAI;AAEJ,MAAI;AACF,aAAS,SAAS;AAElB,QAAI,CAAC,KAAK,MAAM,UAAU,MAAM,GAAG;AACjC,eAAS,MAAM;AAEf,aAAO;AAAA,IACT;AAAA,EACF,SAAS,GAAG;AACV,aAAS,CAAC;AAEV,UAAM;AAAA,EACR;AAEA,SAAO,OACJ,MAAM,CAAC,MAAM;AACZ,aAAS,CAAC;AAEV,UAAM;AAAA,EACR,CAAC,EACA,KAAK,CAAC,MAAM;AACX,aAAS,CAAC;AACV,WAAO;AAAA,EACT,CAAC;AACL;AAeO,SAAS,IAAI,SAAsC;AACxD,SAAO,SAAU,QAAQ,aAAa,YAAsC;AAC1E,UAAM,iBAAiB,WAAW;AAElC,UAAM,YAAY,OAAO,MAAM;AAC/B,UAAM,eAAe,uBAAO,QAAQ;AAEpC,QAAI,CAAC,QAAQ,IAAI,QAAQ,YAAY,GAAG;AACtC,gBAAU,QAAQ,YAAY;AAAA,IAChC;AAEA,eAAW,QAAQ,YAAa,MAA+B;AAC7D,YAAM,SACH,KAAoC,YAAY,KAAK,aAAa;AAErE,aAAO;AAAA,QACL,MAAM;AACJ,iBAAO,eAAe,MAAM,MAAM,IAAI;AAAA,QACxC;AAAA,QACA;AAAA,UACE,YAAY;AAAA,UACZ;AAAA,UACA;AAAA,QACF;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,mBAAe;AAAA,MACb;AAAA,MACA,WAAW;AAAA,MACX;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/mjs/measurement/performance.d.ts

@@ -0,0 +1,6 @@
+import { Logger } from '@squiz/optimization-logger';
+export declare const createPerf: (logger?: Logger) => <T>(callback: () => T | Promise<T>, label: string) => T | Promise<T>;
+export declare function perf<T>(callback: () => T, label: string, logger?: Logger): T;
+export declare function perf<T>(callback: () => Promise<T>, label: string, logger?: Logger): Promise<T>;
+export declare function LogPerf(customLabel?: string): MethodDecorator;
+//# sourceMappingURL=performance.d.ts.map

package/dist/mjs/measurement/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../src/measurement/performance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAIlE,eAAO,MAAM,UAAU,GACpB,SAAS,MAAM,MACf,CAAC,EAAE,UAAU,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,MAAM,KAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAClC,CAAC;AAElC,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;AAC9E,wBAAgB,IAAI,CAAC,CAAC,EACpB,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAAC;AAmCd,wBAAgB,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CA2B7D"}

package/dist/mjs/measurement/performance.js

@@ -0,0 +1,50 @@
+import { createLogger, Logger } from "@squiz/optimization-logger";
+import * as util from "node:util";
+import { inject } from "inversify";
+const createPerf = (logger) => (callback, label) => perf(callback, label, logger);
+function perf(callback, label, logger) {
+  const start = performance.now();
+  logger = logger ? logger : createLogger();
+  const result = callback();
+  const logPerformance = () => {
+    const end = performance.now();
+    const duration = (end - start).toFixed(2);
+    logger.debug({
+      message: `Execution of ${label} took ${duration} ms`,
+      duration,
+      label
+    });
+  };
+  if (util.types.isPromise(result)) {
+    return result.finally(() => {
+      logPerformance();
+    });
+  }
+  logPerformance();
+  return result;
+}
+function LogPerf(customLabel) {
+  return function(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    const label = customLabel ? customLabel : `${target.constructor.name}.${propertyKey}`;
+    const injection = inject(Logger);
+    const loggerSymbol = /* @__PURE__ */ Symbol("logger");
+    injection(target, loggerSymbol);
+    descriptor.value = function(...args) {
+      const logger = this[loggerSymbol];
+      return perf(
+        () => {
+          return originalMethod.apply(this, args);
+        },
+        label,
+        logger
+      );
+    };
+  };
+}
+export {
+  LogPerf,
+  createPerf,
+  perf
+};
+//# sourceMappingURL=performance.js.map

package/dist/mjs/measurement/performance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/measurement/performance.ts"],
+  "sourcesContent": ["import { createLogger, Logger } from '@squiz/optimization-logger';\nimport * as util from 'node:util';\nimport { inject } from 'inversify';\n\nexport const createPerf =\n  (logger?: Logger) =>\n  <T>(callback: () => T | Promise<T>, label: string): T | Promise<T> =>\n    perf(callback, label, logger);\n\nexport function perf<T>(callback: () => T, label: string, logger?: Logger): T;\nexport function perf<T>(\n  callback: () => Promise<T>,\n  label: string,\n  logger?: Logger,\n): Promise<T>;\n\nexport function perf<T>(\n  callback: () => T | Promise<T>,\n  label: string,\n  logger?: Logger,\n): T | Promise<T> {\n  const start = performance.now();\n\n  logger = logger ? logger : createLogger();\n\n  const result = callback();\n\n  const logPerformance = () => {\n    const end = performance.now();\n    const duration = (end - start).toFixed(2);\n\n    logger.debug({\n      message: `Execution of ${label} took ${duration} ms`,\n      duration,\n      label,\n    });\n  };\n\n  if (util.types.isPromise(result)) {\n    return result.finally(() => {\n      logPerformance();\n    });\n  }\n\n  logPerformance();\n\n  return result;\n}\n\nexport function LogPerf(customLabel?: string): MethodDecorator {\n  return function (target, propertyKey, descriptor: PropertyDescriptor): void {\n    const originalMethod = descriptor.value;\n\n    const label = customLabel\n      ? customLabel\n      : `${target.constructor.name}.${propertyKey as string}`;\n\n    const injection = inject(Logger);\n    const loggerSymbol = Symbol('logger');\n\n    injection(target, loggerSymbol);\n\n    descriptor.value = function (...args: Array<unknown>): unknown {\n      const logger = (this as { [loggerSymbol]: Logger | undefined })[\n        loggerSymbol\n      ];\n\n      return perf(\n        () => {\n          return originalMethod.apply(this, args);\n        },\n        label,\n        logger,\n      );\n    };\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc,cAAc;AACrC,YAAY,UAAU;AACtB,SAAS,cAAc;AAEhB,MAAM,aACX,CAAC,WACD,CAAI,UAAgC,UAClC,KAAK,UAAU,OAAO,MAAM;AASzB,SAAS,KACd,UACA,OACA,QACgB;AAChB,QAAM,QAAQ,YAAY,IAAI;AAE9B,WAAS,SAAS,SAAS,aAAa;AAExC,QAAM,SAAS,SAAS;AAExB,QAAM,iBAAiB,MAAM;AAC3B,UAAM,MAAM,YAAY,IAAI;AAC5B,UAAM,YAAY,MAAM,OAAO,QAAQ,CAAC;AAExC,WAAO,MAAM;AAAA,MACX,SAAS,gBAAgB,KAAK,SAAS,QAAQ;AAAA,MAC/C;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,MAAI,KAAK,MAAM,UAAU,MAAM,GAAG;AAChC,WAAO,OAAO,QAAQ,MAAM;AAC1B,qBAAe;AAAA,IACjB,CAAC;AAAA,EACH;AAEA,iBAAe;AAEf,SAAO;AACT;AAEO,SAAS,QAAQ,aAAuC;AAC7D,SAAO,SAAU,QAAQ,aAAa,YAAsC;AAC1E,UAAM,iBAAiB,WAAW;AAElC,UAAM,QAAQ,cACV,cACA,GAAG,OAAO,YAAY,IAAI,IAAI,WAAqB;AAEvD,UAAM,YAAY,OAAO,MAAM;AAC/B,UAAM,eAAe,uBAAO,QAAQ;AAEpC,cAAU,QAAQ,YAAY;AAE9B,eAAW,QAAQ,YAAa,MAA+B;AAC7D,YAAM,SAAU,KACd,YACF;AAEA,aAAO;AAAA,QACL,MAAM;AACJ,iBAAO,eAAe,MAAM,MAAM,IAAI;AAAA,QACxC;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/mjs/metadata/CopyReflection.d.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+export declare class CopyReflection {
+    static copyMetadata(source: object, target: object): void;
+    static copyPropertyMetadata(source: object, target: object, propertyKey: string | symbol): void;
+}
+//# sourceMappingURL=CopyReflection.d.ts.map

package/dist/mjs/metadata/CopyReflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyReflection.d.ts","sourceRoot":"","sources":["../../../src/metadata/CopyReflection.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,qBAAa,cAAc;WACX,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;WAUlD,oBAAoB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,IAAI;CASR"}

package/dist/mjs/metadata/CopyReflection.js

@@ -0,0 +1,21 @@
+import "reflect-metadata";
+class CopyReflection {
+  static copyMetadata(source, target) {
+    const metadataKeys = Reflect.getMetadataKeys(source);
+    metadataKeys.forEach((key) => {
+      const metadata = Reflect.getMetadata(key, source);
+      Reflect.defineMetadata(key, metadata, target);
+    });
+  }
+  static copyPropertyMetadata(source, target, propertyKey) {
+    const metadataKeys = Reflect.getMetadataKeys(source, propertyKey);
+    metadataKeys.forEach((key) => {
+      const metadata = Reflect.getMetadata(key, source, propertyKey);
+      Reflect.defineMetadata(key, metadata, target, propertyKey);
+    });
+  }
+}
+export {
+  CopyReflection
+};
+//# sourceMappingURL=CopyReflection.js.map

package/dist/mjs/metadata/CopyReflection.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/metadata/CopyReflection.ts"],
+  "sourcesContent": ["import 'reflect-metadata';\n\nexport class CopyReflection {\n  public static copyMetadata(source: object, target: object): void {\n    const metadataKeys = Reflect.getMetadataKeys(source);\n\n    metadataKeys.forEach((key) => {\n      const metadata = Reflect.getMetadata(key, source);\n\n      Reflect.defineMetadata(key, metadata, target);\n    });\n  }\n\n  public static copyPropertyMetadata(\n    source: object,\n    target: object,\n    propertyKey: string | symbol,\n  ): void {\n    const metadataKeys = Reflect.getMetadataKeys(source, propertyKey);\n\n    metadataKeys.forEach((key) => {\n      const metadata = Reflect.getMetadata(key, source, propertyKey);\n\n      Reflect.defineMetadata(key, metadata, target, propertyKey);\n    });\n  }\n}\n"],
+  "mappings": "AAAA,OAAO;AAEA,MAAM,eAAe;AAAA,EAC1B,OAAc,aAAa,QAAgB,QAAsB;AAC/D,UAAM,eAAe,QAAQ,gBAAgB,MAAM;AAEnD,iBAAa,QAAQ,CAAC,QAAQ;AAC5B,YAAM,WAAW,QAAQ,YAAY,KAAK,MAAM;AAEhD,cAAQ,eAAe,KAAK,UAAU,MAAM;AAAA,IAC9C,CAAC;AAAA,EACH;AAAA,EAEA,OAAc,qBACZ,QACA,QACA,aACM;AACN,UAAM,eAAe,QAAQ,gBAAgB,QAAQ,WAAW;AAEhE,iBAAa,QAAQ,CAAC,QAAQ;AAC5B,YAAM,WAAW,QAAQ,YAAY,KAAK,QAAQ,WAAW;AAE7D,cAAQ,eAAe,KAAK,UAAU,QAAQ,WAAW;AAAA,IAC3D,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/dist/mjs/object/getProperty.d.ts

@@ -0,0 +1,2 @@
+export declare const getProperty: (obj: Record<string | symbol | number, unknown>, path: string, defaultValue?: unknown) => unknown;
+//# sourceMappingURL=getProperty.d.ts.map

package/dist/mjs/object/getProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProperty.d.ts","sourceRoot":"","sources":["../../../src/object/getProperty.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAC9C,MAAM,MAAM,EACZ,eAAc,OAAmB,KAChC,OAgBF,CAAC"}

package/dist/mjs/object/getProperty.js

@@ -0,0 +1,12 @@
+const getProperty = (obj, path, defaultValue = void 0) => {
+  const travel = (regexp) => path.split(regexp).filter(Boolean).reduce(
+    (res, key) => res !== null && res !== void 0 ? res[key] : res,
+    obj
+  );
+  const result = travel(/[,[\]]+?/) || travel(/[,[\].]+?/);
+  return result === void 0 || result === obj ? defaultValue : result;
+};
+export {
+  getProperty
+};
+//# sourceMappingURL=getProperty.js.map

package/dist/mjs/object/getProperty.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/object/getProperty.ts"],
+  "sourcesContent": ["export const getProperty = (\n  obj: Record<string | symbol | number, unknown>,\n  path: string,\n  defaultValue: unknown = undefined,\n): unknown => {\n  const travel = (regexp: RegExp) =>\n    path\n      .split(regexp)\n      .filter(Boolean)\n      .reduce<unknown>(\n        (res, key) =>\n          res !== null && res !== undefined\n            ? (res as Record<string, unknown>)[key]\n            : res,\n        obj,\n      );\n\n  const result = travel(/[,[\\]]+?/) || travel(/[,[\\].]+?/);\n\n  return result === undefined || result === obj ? defaultValue : result;\n};\n"],
+  "mappings": "AAAO,MAAM,cAAc,CACzB,KACA,MACA,eAAwB,WACZ;AACZ,QAAM,SAAS,CAAC,WACd,KACG,MAAM,MAAM,EACZ,OAAO,OAAO,EACd;AAAA,IACC,CAAC,KAAK,QACJ,QAAQ,QAAQ,QAAQ,SACnB,IAAgC,GAAG,IACpC;AAAA,IACN;AAAA,EACF;AAEJ,QAAM,SAAS,OAAO,UAAU,KAAK,OAAO,WAAW;AAEvD,SAAO,WAAW,UAAa,WAAW,MAAM,eAAe;AACjE;",
+  "names": []
+}

package/dist/mjs/object/index.d.ts

@@ -0,0 +1,2 @@
+export * from './getProperty.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mjs/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/object/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/mjs/object/index.js

@@ -0,0 +1,2 @@
+export * from "./getProperty.js";
+//# sourceMappingURL=index.js.map

package/dist/mjs/object/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/object/index.ts"],
+  "sourcesContent": ["export * from './getProperty';\n"],
+  "mappings": "AAAA,cAAc;",
+  "names": []
+}

package/dist/mjs/promises/PromiseMaxConcurrency.d.ts

@@ -0,0 +1,25 @@
+export type MaxConcurrencyOptions = {
+    maxConcurrency: number;
+};
+/**
+ * A utility class that executes promises with controlled concurrency.
+ * This class helps to limit the number of promises running simultaneously,
+ * preventing potential memory or performance issues when dealing with large arrays.
+ */
+export declare class PromiseMaxConcurrency<T> {
+    private readonly items;
+    private options;
+    /**
+     * Creates a new instance of PromiseMaxConcurrency.
+     * @param items - Array of items to process
+     * @param options - Configuration options for controlling concurrency
+     * @param options.maxConcurrency - Maximum number of promises to run simultaneously (defaults to 3)
+     */
+    constructor(items: Array<T>, options?: MaxConcurrencyOptions);
+    handle<R>(handler: (value: T, index: number, array: Array<T>) => Promise<R>): Promise<Array<R>>;
+}
+export declare class PromiseMaxConcurrencyFactory {
+    constructor();
+    create<T>(items: Array<T>, options?: MaxConcurrencyOptions): PromiseMaxConcurrency<T>;
+}
+//# sourceMappingURL=PromiseMaxConcurrency.d.ts.map

package/dist/mjs/promises/PromiseMaxConcurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromiseMaxConcurrency.d.ts","sourceRoot":"","sources":["../../../src/promises/PromiseMaxConcurrency.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,qBAAqB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,qBACa,qBAAqB,CAAC,CAAC;IAUhC,OAAO,CAAC,QAAQ,CAAC,KAAK;IATxB,OAAO,CAAC,OAAO,CAAwB;IAEvC;;;;;OAKG;gBAEgB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAChC,OAAO,CAAC,EAAE,qBAAqB;IAO3B,MAAM,CAAC,CAAC,EACZ,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAChE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAsBrB;AAED,qBACa,4BAA4B;;IAGvC,MAAM,CAAC,CAAC,EACN,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,OAAO,CAAC,EAAE,qBAAqB,GAC9B,qBAAqB,CAAC,CAAC,CAAC;CAG5B"}

package/dist/mjs/promises/PromiseMaxConcurrency.js

@@ -0,0 +1,63 @@
+var __decorate = function(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;
+};
+var __metadata = function(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var _a;
+import { injectable } from "inversify";
+let PromiseMaxConcurrency = class PromiseMaxConcurrency2 {
+  items;
+  options;
+  /**
+   * Creates a new instance of PromiseMaxConcurrency.
+   * @param items - Array of items to process
+   * @param options - Configuration options for controlling concurrency
+   * @param options.maxConcurrency - Maximum number of promises to run simultaneously (defaults to 3)
+   */
+  constructor(items, options) {
+    this.items = items;
+    this.options = options ?? {
+      maxConcurrency: 3
+    };
+  }
+  async handle(handler) {
+    let promises = [];
+    const results = [];
+    const maxConcurrency = this.options.maxConcurrency;
+    for (let i = 0; i < this.items.length; i++) {
+      promises.push(handler(this.items[i], i, this.items));
+      if (promises.length === maxConcurrency) {
+        const result2 = await Promise.all(promises);
+        results.push(...result2);
+        promises = [];
+      }
+    }
+    const result = await Promise.all(promises);
+    results.push(...result);
+    return results;
+  }
+};
+PromiseMaxConcurrency = __decorate([
+  injectable(),
+  __metadata("design:paramtypes", [typeof (_a = typeof Array !== "undefined" && Array) === "function" ? _a : Object, Object])
+], PromiseMaxConcurrency);
+let PromiseMaxConcurrencyFactory = class PromiseMaxConcurrencyFactory2 {
+  constructor() {
+  }
+  create(items, options) {
+    return new PromiseMaxConcurrency(items, options);
+  }
+};
+PromiseMaxConcurrencyFactory = __decorate([
+  injectable(),
+  __metadata("design:paramtypes", [])
+], PromiseMaxConcurrencyFactory);
+export {
+  PromiseMaxConcurrency,
+  PromiseMaxConcurrencyFactory
+};
+//# sourceMappingURL=PromiseMaxConcurrency.js.map