@squiz/optimization-utils 7.1.2 → 7.2.0-rc1

package/dist/mjs/promises/PromiseMaxConcurrency.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/promises/PromiseMaxConcurrency.ts"],
+  "sourcesContent": ["import { injectable } from 'inversify';\n\nexport type MaxConcurrencyOptions = {\n  maxConcurrency: number;\n};\n\n/**\n * A utility class that executes promises with controlled concurrency.\n * This class helps to limit the number of promises running simultaneously,\n * preventing potential memory or performance issues when dealing with large arrays.\n */\n@injectable()\nexport class PromiseMaxConcurrency<T> {\n  private options: MaxConcurrencyOptions;\n\n  /**\n   * Creates a new instance of PromiseMaxConcurrency.\n   * @param items - Array of items to process\n   * @param options - Configuration options for controlling concurrency\n   * @param options.maxConcurrency - Maximum number of promises to run simultaneously (defaults to 3)\n   */\n  constructor(\n    private readonly items: Array<T>,\n    options?: MaxConcurrencyOptions,\n  ) {\n    this.options = options ?? {\n      maxConcurrency: 3,\n    };\n  }\n\n  async handle<R>(\n    handler: (value: T, index: number, array: Array<T>) => Promise<R>,\n  ): Promise<Array<R>> {\n    let promises: Array<Promise<R>> = [];\n    const results: Array<R> = [];\n    const maxConcurrency = this.options.maxConcurrency;\n\n    for (let i = 0; i < this.items.length; i++) {\n      promises.push(handler(this.items[i], i, this.items));\n\n      if (promises.length === maxConcurrency) {\n        const result = await Promise.all(promises);\n\n        results.push(...result);\n        promises = [];\n      }\n    }\n\n    const result = await Promise.all(promises);\n\n    results.push(...result);\n\n    return results;\n  }\n}\n\n@injectable()\nexport class PromiseMaxConcurrencyFactory {\n  constructor() {}\n\n  create<T>(\n    items: Array<T>,\n    options?: MaxConcurrencyOptions,\n  ): PromiseMaxConcurrency<T> {\n    return new PromiseMaxConcurrency(items, options);\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;AAAA,SAAS,kBAAkB;AAYpB,IAAM,wBAAN,MAAMA,uBAAqB;EAUb;EATX;;;;;;;EAQR,YACmB,OACjB,SAA+B;AADd,SAAA,QAAA;AAGjB,SAAK,UAAU,WAAW;MACxB,gBAAgB;;EAEpB;EAEA,MAAM,OACJ,SAAiE;AAEjE,QAAI,WAA8B,CAAA;AAClC,UAAM,UAAoB,CAAA;AAC1B,UAAM,iBAAiB,KAAK,QAAQ;AAEpC,aAAS,IAAI,GAAG,IAAI,KAAK,MAAM,QAAQ,KAAK;AAC1C,eAAS,KAAK,QAAQ,KAAK,MAAM,CAAC,GAAG,GAAG,KAAK,KAAK,CAAC;AAEnD,UAAI,SAAS,WAAW,gBAAgB;AACtC,cAAMC,UAAS,MAAM,QAAQ,IAAI,QAAQ;AAEzC,gBAAQ,KAAK,GAAGA,OAAM;AACtB,mBAAW,CAAA;MACb;IACF;AAEA,UAAM,SAAS,MAAM,QAAQ,IAAI,QAAQ;AAEzC,YAAQ,KAAK,GAAG,MAAM;AAEtB,WAAO;EACT;;AAzCW,wBAAqB,WAAA;EADjC,WAAU;uDAWiB,UAAK,eAAL,WAAK,aAAA,KAAA,QAAA,MAAA,CAAA;GAVpB,qBAAqB;AA6C3B,IAAM,+BAAN,MAAMC,8BAA4B;EACvC,cAAA;EAAe;EAEf,OACE,OACA,SAA+B;AAE/B,WAAO,IAAI,sBAAsB,OAAO,OAAO;EACjD;;AARW,+BAA4B,WAAA;EADxC,WAAU;;GACE,4BAA4B;",
+  "names": ["PromiseMaxConcurrency", "result", "PromiseMaxConcurrencyFactory"]
+}

package/dist/mjs/queue/LRUQueue.d.ts

@@ -0,0 +1,32 @@
+export type LRUQueueSetOptions<T> = {
+    keySelector: (value: T) => string;
+    /** Defaults to JSON.stringify when omitted. */
+    serialize?: (value: T) => string;
+    /** Defaults to JSON.parse when omitted. */
+    deserialize?: (payload: string) => T;
+};
+/**
+ * Least Recently Used (LRU) queue implementation using SQLite.
+ */
+export declare class LRUQueue<T> implements Disposable {
+    private readonly db;
+    private readonly keySelector;
+    private readonly serialize;
+    private readonly deserialize;
+    private readonly insertQueue;
+    private readonly selectOldestN;
+    private readonly markFetchedByKey;
+    private readonly selectPeekOldest;
+    private readonly selectPeekNewest;
+    private readonly selectCount;
+    get size(): number;
+    constructor({ keySelector, serialize, deserialize }: LRUQueueSetOptions<T>);
+    enqueue(...values: Array<T>): number;
+    dequeue(count?: number): Array<T>;
+    peekOldest(): T | undefined;
+    peekNewest(): T | undefined;
+    clone(): LRUQueue<T>;
+    toFile(filePath?: string): string;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=LRUQueue.d.ts.map

package/dist/mjs/queue/LRUQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LRUQueue.d.ts","sourceRoot":"","sources":["../../../src/queue/LRUQueue.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAClC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC,CAAE,YAAW,UAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IAErD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAE5C,IAAI,IAAI,IAAI,MAAM,CAIjB;gBAEW,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IA4C1E,OAAO,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM;IA0BpC,OAAO,CAAC,KAAK,SAAI,GAAG,KAAK,CAAC,CAAC,CAAC;IAmC5B,UAAU,IAAI,CAAC,GAAG,SAAS;IAM3B,UAAU,IAAI,CAAC,GAAG,SAAS;IAM3B,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC;IAoCpB,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAWjC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}

package/dist/mjs/queue/LRUQueue.js

@@ -0,0 +1,154 @@
+import { randomUUID } from "node:crypto";
+import * as path from "node:path";
+import { resolve } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+class LRUQueue {
+  db;
+  keySelector;
+  serialize;
+  deserialize;
+  insertQueue;
+  selectOldestN;
+  markFetchedByKey;
+  selectPeekOldest;
+  selectPeekNewest;
+  selectCount;
+  get size() {
+    const row = this.selectCount.get();
+    return row?.c ?? 0;
+  }
+  constructor({ keySelector, serialize, deserialize }) {
+    this.db = new DatabaseSync(":memory:");
+    this.db.exec(`
+      PRAGMA journal_mode = MEMORY;
+      PRAGMA synchronous = OFF;
+
+      CREATE TABLE queue (
+        item_key TEXT PRIMARY KEY,
+        payload TEXT NOT NULL,
+        fetched INTEGER NOT NULL DEFAULT 0
+          CHECK (fetched IN (0, 1))
+      );
+
+      CREATE INDEX idx_queue_pending ON queue (fetched);
+    `);
+    this.keySelector = keySelector;
+    this.serialize = serialize ?? ((value) => JSON.stringify(value));
+    this.deserialize = deserialize ?? ((payload) => JSON.parse(payload));
+    this.insertQueue = this.db.prepare(
+      "INSERT OR IGNORE INTO queue (item_key, payload) VALUES (?, ?)"
+    );
+    this.selectOldestN = this.db.prepare(
+      `SELECT item_key, payload FROM queue
+       WHERE fetched = 0 ORDER BY rowid ASC LIMIT ?`
+    );
+    this.markFetchedByKey = this.db.prepare(
+      "UPDATE queue SET fetched = 1 WHERE item_key = ? AND fetched = 0"
+    );
+    this.selectPeekOldest = this.db.prepare(
+      `SELECT payload FROM queue
+       WHERE fetched = 0 ORDER BY rowid ASC LIMIT 1`
+    );
+    this.selectPeekNewest = this.db.prepare(
+      `SELECT payload FROM queue
+       WHERE fetched = 0 ORDER BY rowid DESC LIMIT 1`
+    );
+    this.selectCount = this.db.prepare(
+      "SELECT COUNT(*) AS c FROM queue WHERE fetched = 0"
+    );
+  }
+  enqueue(...values) {
+    let added = 0;
+    this.db.exec("BEGIN IMMEDIATE");
+    try {
+      for (const value of values) {
+        const key = this.keySelector(value);
+        const payload = this.serialize(value);
+        const insertResult = this.insertQueue.run(key, payload);
+        if (insertResult.changes === 0) {
+          continue;
+        }
+        added++;
+      }
+      this.db.exec("COMMIT");
+    } catch (error) {
+      this.db.exec("ROLLBACK");
+      throw error;
+    }
+    return added;
+  }
+  dequeue(count = 1) {
+    if (!Number.isInteger(count) || count < 0) {
+      throw new Error("count must be a non-negative integer");
+    }
+    if (count === 0) {
+      return [];
+    }
+    this.db.exec("BEGIN IMMEDIATE");
+    try {
+      const rows = this.selectOldestN.all(count);
+      if (rows.length === 0) {
+        this.db.exec("COMMIT");
+        return [];
+      }
+      for (const row of rows) {
+        this.markFetchedByKey.run(row.item_key);
+      }
+      this.db.exec("COMMIT");
+      return rows.map((row) => this.deserialize(row.payload));
+    } catch (error) {
+      this.db.exec("ROLLBACK");
+      throw error;
+    }
+  }
+  peekOldest() {
+    const row = this.selectPeekOldest.get();
+    return row ? this.deserialize(row.payload) : void 0;
+  }
+  peekNewest() {
+    const row = this.selectPeekNewest.get();
+    return row ? this.deserialize(row.payload) : void 0;
+  }
+  clone() {
+    const cloned = new LRUQueue({
+      keySelector: this.keySelector,
+      serialize: this.serialize,
+      deserialize: this.deserialize
+    });
+    const rows = this.db.prepare(
+      "SELECT item_key, payload, fetched FROM queue ORDER BY rowid ASC"
+    ).all();
+    if (rows.length === 0) {
+      return cloned;
+    }
+    const insert = cloned.db.prepare(
+      "INSERT INTO queue (item_key, payload, fetched) VALUES (?, ?, ?)"
+    );
+    cloned.db.exec("BEGIN IMMEDIATE");
+    try {
+      for (const row of rows) {
+        insert.run(row.item_key, row.payload, row.fetched);
+      }
+      cloned.db.exec("COMMIT");
+    } catch (error) {
+      cloned.db.exec("ROLLBACK");
+      throw error;
+    }
+    return cloned;
+  }
+  toFile(filePath) {
+    const absolutePath = resolve(
+      filePath ?? path.join(process.cwd(), `${randomUUID()}.sqlite`)
+    );
+    const escaped = absolutePath.replace(/'/g, `''`);
+    this.db.exec(`VACUUM INTO '${escaped}'`);
+    return absolutePath;
+  }
+  [Symbol.dispose]() {
+    this.db[Symbol.dispose]();
+  }
+}
+export {
+  LRUQueue
+};
+//# sourceMappingURL=LRUQueue.js.map

package/dist/mjs/queue/LRUQueue.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/queue/LRUQueue.ts"],
+  "sourcesContent": ["import { randomUUID } from 'node:crypto';\nimport * as path from 'node:path';\nimport { resolve } from 'node:path';\nimport { DatabaseSync, StatementSync } from 'node:sqlite';\n\nexport type LRUQueueSetOptions<T> = {\n  keySelector: (value: T) => string;\n  /** Defaults to JSON.stringify when omitted. */\n  serialize?: (value: T) => string;\n  /** Defaults to JSON.parse when omitted. */\n  deserialize?: (payload: string) => T;\n};\n\n/**\n * Least Recently Used (LRU) queue implementation using SQLite.\n */\nexport class LRUQueue<T> implements Disposable {\n  private readonly db: DatabaseSync;\n  private readonly keySelector: (value: T) => string;\n  private readonly serialize: (value: T) => string;\n  private readonly deserialize: (payload: string) => T;\n\n  private readonly insertQueue: StatementSync;\n  private readonly selectOldestN: StatementSync;\n  private readonly markFetchedByKey: StatementSync;\n  private readonly selectPeekOldest: StatementSync;\n  private readonly selectPeekNewest: StatementSync;\n  private readonly selectCount: StatementSync;\n\n  get size(): number {\n    const row = this.selectCount.get() as { c: number } | undefined;\n\n    return row?.c ?? 0;\n  }\n\n  constructor({ keySelector, serialize, deserialize }: LRUQueueSetOptions<T>) {\n    this.db = new DatabaseSync(':memory:');\n    this.db.exec(`\n      PRAGMA journal_mode = MEMORY;\n      PRAGMA synchronous = OFF;\n\n      CREATE TABLE queue (\n        item_key TEXT PRIMARY KEY,\n        payload TEXT NOT NULL,\n        fetched INTEGER NOT NULL DEFAULT 0\n          CHECK (fetched IN (0, 1))\n      );\n\n      CREATE INDEX idx_queue_pending ON queue (fetched);\n    `);\n\n    this.keySelector = keySelector;\n    this.serialize = serialize ?? ((value: T): string => JSON.stringify(value));\n    this.deserialize =\n      deserialize ?? ((payload: string): T => JSON.parse(payload) as T);\n\n    this.insertQueue = this.db.prepare(\n      'INSERT OR IGNORE INTO queue (item_key, payload) VALUES (?, ?)',\n    );\n    this.selectOldestN = this.db.prepare(\n      `SELECT item_key, payload FROM queue\n       WHERE fetched = 0 ORDER BY rowid ASC LIMIT ?`,\n    );\n    this.markFetchedByKey = this.db.prepare(\n      'UPDATE queue SET fetched = 1 WHERE item_key = ? AND fetched = 0',\n    );\n    this.selectPeekOldest = this.db.prepare(\n      `SELECT payload FROM queue\n       WHERE fetched = 0 ORDER BY rowid ASC LIMIT 1`,\n    );\n    this.selectPeekNewest = this.db.prepare(\n      `SELECT payload FROM queue\n       WHERE fetched = 0 ORDER BY rowid DESC LIMIT 1`,\n    );\n    this.selectCount = this.db.prepare(\n      'SELECT COUNT(*) AS c FROM queue WHERE fetched = 0',\n    );\n  }\n\n  enqueue(...values: Array<T>): number {\n    let added = 0;\n\n    this.db.exec('BEGIN IMMEDIATE');\n    try {\n      for (const value of values) {\n        const key = this.keySelector(value);\n        const payload = this.serialize(value);\n        const insertResult = this.insertQueue.run(key, payload);\n\n        if (insertResult.changes === 0) {\n          continue;\n        }\n\n        added++;\n      }\n\n      this.db.exec('COMMIT');\n    } catch (error) {\n      this.db.exec('ROLLBACK');\n      throw error;\n    }\n\n    return added;\n  }\n\n  dequeue(count = 1): Array<T> {\n    if (!Number.isInteger(count) || count < 0) {\n      throw new Error('count must be a non-negative integer');\n    }\n\n    if (count === 0) {\n      return [];\n    }\n\n    this.db.exec('BEGIN IMMEDIATE');\n    try {\n      const rows = this.selectOldestN.all(count) as Array<{\n        item_key: string;\n        payload: string;\n      }>;\n\n      if (rows.length === 0) {\n        this.db.exec('COMMIT');\n\n        return [];\n      }\n\n      for (const row of rows) {\n        this.markFetchedByKey.run(row.item_key);\n      }\n\n      this.db.exec('COMMIT');\n\n      return rows.map((row) => this.deserialize(row.payload));\n    } catch (error) {\n      this.db.exec('ROLLBACK');\n      throw error;\n    }\n  }\n\n  peekOldest(): T | undefined {\n    const row = this.selectPeekOldest.get() as { payload: string } | undefined;\n\n    return row ? this.deserialize(row.payload) : undefined;\n  }\n\n  peekNewest(): T | undefined {\n    const row = this.selectPeekNewest.get() as { payload: string } | undefined;\n\n    return row ? this.deserialize(row.payload) : undefined;\n  }\n\n  clone(): LRUQueue<T> {\n    const cloned = new LRUQueue<T>({\n      keySelector: this.keySelector,\n      serialize: this.serialize,\n      deserialize: this.deserialize,\n    });\n\n    const rows = this.db\n      .prepare(\n        'SELECT item_key, payload, fetched FROM queue ORDER BY rowid ASC',\n      )\n      .all() as Array<{ item_key: string; payload: string; fetched: number }>;\n\n    if (rows.length === 0) {\n      return cloned;\n    }\n\n    const insert = cloned.db.prepare(\n      'INSERT INTO queue (item_key, payload, fetched) VALUES (?, ?, ?)',\n    );\n\n    cloned.db.exec('BEGIN IMMEDIATE');\n    try {\n      for (const row of rows) {\n        insert.run(row.item_key, row.payload, row.fetched);\n      }\n\n      cloned.db.exec('COMMIT');\n    } catch (error) {\n      cloned.db.exec('ROLLBACK');\n      throw error;\n    }\n\n    return cloned;\n  }\n\n  toFile(filePath?: string): string {\n    const absolutePath = resolve(\n      filePath ?? path.join(process.cwd(), `${randomUUID()}.sqlite`),\n    );\n    const escaped = absolutePath.replace(/'/g, `''`);\n\n    this.db.exec(`VACUUM INTO '${escaped}'`);\n\n    return absolutePath;\n  }\n\n  [Symbol.dispose](): void {\n    this.db[Symbol.dispose]();\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/mjs/queue/LRUQueueFactory.d.ts

@@ -0,0 +1,5 @@
+import { LRUQueue, LRUQueueSetOptions } from './LRUQueue.js';
+export declare class LRUQueueFactory {
+    create<T>(options: LRUQueueSetOptions<T>): LRUQueue<T>;
+}
+//# sourceMappingURL=LRUQueueFactory.d.ts.map

package/dist/mjs/queue/LRUQueueFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LRUQueueFactory.d.ts","sourceRoot":"","sources":["../../../src/queue/LRUQueueFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG1D,qBACa,eAAe;IAC1B,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;CAGvD"}

package/dist/mjs/queue/LRUQueueFactory.js

@@ -0,0 +1,20 @@
+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;
+};
+import { LRUQueue } from "./LRUQueue.js";
+import { injectable } from "inversify";
+let LRUQueueFactory = class LRUQueueFactory2 {
+  create(options) {
+    return new LRUQueue(options);
+  }
+};
+LRUQueueFactory = __decorate([
+  injectable()
+], LRUQueueFactory);
+export {
+  LRUQueueFactory
+};
+//# sourceMappingURL=LRUQueueFactory.js.map

package/dist/mjs/queue/LRUQueueFactory.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/queue/LRUQueueFactory.ts"],
+  "sourcesContent": ["import { LRUQueue, LRUQueueSetOptions } from './LRUQueue';\nimport { injectable } from 'inversify';\n\n@injectable()\nexport class LRUQueueFactory {\n  create<T>(options: LRUQueueSetOptions<T>): LRUQueue<T> {\n    return new LRUQueue(options);\n  }\n}\n"],
+  "mappings": ";;;;;;AAAA,SAAS,gBAAoC;AAC7C,SAAS,kBAAkB;AAGpB,IAAM,kBAAN,MAAMA,iBAAe;EAC1B,OAAU,SAA8B;AACtC,WAAO,IAAI,SAAS,OAAO;EAC7B;;AAHW,kBAAe,WAAA;EAD3B,WAAU;GACE,eAAe;",
+  "names": ["LRUQueueFactory"]
+}

package/dist/mjs/retries/Retries.d.ts

@@ -0,0 +1,6 @@
+export declare function Retry({ delay, retries, retryableErrors, }: {
+    retries: number;
+    delay: number;
+    retryableErrors: Array<new (...args: Array<any>) => Error>;
+}): MethodDecorator;
+//# sourceMappingURL=Retries.d.ts.map

package/dist/mjs/retries/Retries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Retries.d.ts","sourceRoot":"","sources":["../../../src/retries/Retries.ts"],"names":[],"mappings":"AAKA,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,OAAO,EACP,eAAe,GAChB,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IAEd,eAAe,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC;CAC5D,GAAG,eAAe,CAgElB"}

package/dist/mjs/retries/Retries.js

@@ -0,0 +1,61 @@
+import { setTimeout } from "timers/promises";
+import { inject } from "inversify";
+import { createLogger, Logger } from "@squiz/optimization-logger";
+import { CopyReflection } from "../metadata/CopyReflection.js";
+function Retry({
+  delay,
+  retries,
+  retryableErrors
+}) {
+  return (target, propertyKey, descriptor) => {
+    const injection = inject(Logger);
+    const loggerSymbol = /* @__PURE__ */ Symbol("logger");
+    injection(target, loggerSymbol);
+    const originalMethod = descriptor.value;
+    descriptor.value = async function(...args) {
+      const logger = this[loggerSymbol] || createLogger();
+      let attempt = 0;
+      while (attempt <= retries) {
+        try {
+          return await originalMethod.apply(this, args);
+        } catch (error) {
+          logger.debug({
+            message: `Attempt ${attempt} of ${retries}`
+          });
+          attempt++;
+          if (!retryableErrors.some((errType) => error instanceof errType)) {
+            logger.error({
+              message: `Non-retryable error encountered`,
+              error
+            });
+            throw error;
+          }
+          const isMaxRetriesReached = attempt > retries;
+          if (isMaxRetriesReached) {
+            logger.error({
+              message: `Max retries (${retries}) reached`,
+              error
+            });
+            throw error;
+          }
+          const _delay = delay * Math.pow(2, attempt - 1);
+          logger.debug({
+            message: `Retrying in ${_delay}ms`,
+            attempt,
+            delay: _delay
+          });
+          await setTimeout(_delay);
+        }
+      }
+    };
+    CopyReflection.copyPropertyMetadata(
+      originalMethod,
+      descriptor.value,
+      propertyKey
+    );
+  };
+}
+export {
+  Retry
+};
+//# sourceMappingURL=Retries.js.map

package/dist/mjs/retries/Retries.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/retries/Retries.ts"],
+  "sourcesContent": ["import { setTimeout } from 'timers/promises';\nimport { inject } from 'inversify';\nimport { createLogger, Logger } from '@squiz/optimization-logger';\nimport { CopyReflection } from '../metadata/CopyReflection';\n\nexport function Retry({\n  delay,\n  retries,\n  retryableErrors,\n}: {\n  retries: number;\n  delay: number;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  retryableErrors: Array<new (...args: Array<any>) => Error>;\n}): MethodDecorator {\n  return (target, propertyKey, descriptor: PropertyDescriptor): void => {\n    const injection = inject(Logger);\n    const loggerSymbol = Symbol('logger');\n\n    injection(target, loggerSymbol);\n\n    const originalMethod = descriptor.value;\n\n    descriptor.value = async function (\n      ...args: Array<unknown>\n    ): Promise<unknown> {\n      const logger =\n        (this as { [loggerSymbol]: Logger | undefined })[loggerSymbol] ||\n        createLogger();\n\n      let attempt = 0;\n\n      while (attempt <= retries) {\n        try {\n          return await originalMethod.apply(this, args);\n        } catch (error) {\n          logger.debug({\n            message: `Attempt ${attempt} of ${retries}`,\n          });\n          attempt++;\n\n          if (!retryableErrors.some((errType) => error instanceof errType)) {\n            logger.error({\n              message: `Non-retryable error encountered`,\n              error,\n            });\n            throw error;\n          }\n\n          const isMaxRetriesReached = attempt > retries;\n\n          if (isMaxRetriesReached) {\n            logger.error({\n              message: `Max retries (${retries}) reached`,\n              error,\n            });\n            throw error;\n          }\n\n          const _delay = delay * Math.pow(2, attempt - 1);\n\n          logger.debug({\n            message: `Retrying in ${_delay}ms`,\n            attempt,\n            delay: _delay,\n          });\n\n          await setTimeout(_delay);\n        }\n      }\n    };\n\n    CopyReflection.copyPropertyMetadata(\n      originalMethod,\n      descriptor.value,\n      propertyKey,\n    );\n  };\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,cAAc;AACvB,SAAS,cAAc,cAAc;AACrC,SAAS,sBAAsB;AAExB,SAAS,MAAM;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AACF,GAKoB;AAClB,SAAO,CAAC,QAAQ,aAAa,eAAyC;AACpE,UAAM,YAAY,OAAO,MAAM;AAC/B,UAAM,eAAe,uBAAO,QAAQ;AAEpC,cAAU,QAAQ,YAAY;AAE9B,UAAM,iBAAiB,WAAW;AAElC,eAAW,QAAQ,kBACd,MACe;AAClB,YAAM,SACH,KAAgD,YAAY,KAC7D,aAAa;AAEf,UAAI,UAAU;AAEd,aAAO,WAAW,SAAS;AACzB,YAAI;AACF,iBAAO,MAAM,eAAe,MAAM,MAAM,IAAI;AAAA,QAC9C,SAAS,OAAO;AACd,iBAAO,MAAM;AAAA,YACX,SAAS,WAAW,OAAO,OAAO,OAAO;AAAA,UAC3C,CAAC;AACD;AAEA,cAAI,CAAC,gBAAgB,KAAK,CAAC,YAAY,iBAAiB,OAAO,GAAG;AAChE,mBAAO,MAAM;AAAA,cACX,SAAS;AAAA,cACT;AAAA,YACF,CAAC;AACD,kBAAM;AAAA,UACR;AAEA,gBAAM,sBAAsB,UAAU;AAEtC,cAAI,qBAAqB;AACvB,mBAAO,MAAM;AAAA,cACX,SAAS,gBAAgB,OAAO;AAAA,cAChC;AAAA,YACF,CAAC;AACD,kBAAM;AAAA,UACR;AAEA,gBAAM,SAAS,QAAQ,KAAK,IAAI,GAAG,UAAU,CAAC;AAE9C,iBAAO,MAAM;AAAA,YACX,SAAS,eAAe,MAAM;AAAA,YAC9B;AAAA,YACA,OAAO;AAAA,UACT,CAAC;AAED,gBAAM,WAAW,MAAM;AAAA,QACzB;AAAA,MACF;AAAA,IACF;AAEA,mBAAe;AAAA,MACb;AAAA,MACA,WAAW;AAAA,MACX;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/mjs/types/class-utilities-types.d.ts

@@ -0,0 +1,10 @@
+type MethodKeysOrNever<T> = {
+    [K in keyof T]: T[K] extends (...args: Array<unknown>) => unknown ? K : never;
+};
+export type MethodKeys<T> = MethodKeysOrNever<T>[keyof T];
+export type ClassFields<T> = Omit<T, Exclude<MethodKeys<T>, undefined>>;
+export type OverwriteValueOf<TInstance, DValueOfReturn> = Omit<TInstance, 'valueOf'> & {
+    valueOf(): DValueOfReturn;
+};
+export {};
+//# sourceMappingURL=class-utilities-types.d.ts.map

package/dist/mjs/types/class-utilities-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-utilities-types.d.ts","sourceRoot":"","sources":["../../../src/types/class-utilities-types.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,KAAK;CAC9E,CAAC;AACF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;AACxE,MAAM,MAAM,gBAAgB,CAAC,SAAS,EAAE,cAAc,IAAI,IAAI,CAC5D,SAAS,EACT,SAAS,CACV,GAAG;IACF,OAAO,IAAI,cAAc,CAAC;CAC3B,CAAC"}

package/dist/mjs/types/class-utilities-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=class-utilities-types.js.map

package/dist/mjs/types/class-utilities-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

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

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

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

package/dist/mjs/types/index.js

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

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

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

package/package.json

@@ -1,42 +1,77 @@
 {
   "name": "@squiz/optimization-utils",
-  "version": "7.1.2",
+  "version": "7.2.0-rc1",
   "description": "",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "repository": "https://gitlab.squiz.net/optimization/optimization-utils",
-  "scripts": {
-    "build": "tsc -p ./tsconfig-package.json",
-    "build:check": "tsc --noEmit",
-    "exports:generate": "opti-build-utils exports:generate --config ../../generate-barrels.json && prettier -w ./src/index.ts"
-  },
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/mjs/index.js",
+  "types": "./dist/mjs/index.d.ts",
   "exports": {
     ".": {
-      "default": "./dist/index.js"
+      "import": {
+        "types": "./dist/mjs/index.d.ts",
+        "default": "./dist/mjs/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
     },
     "./array": {
-      "default": "./dist/array/index.js",
-      "types": "./dist/array/index.d.ts"
+      "import": {
+        "types": "./dist/mjs/array/index.d.ts",
+        "default": "./dist/mjs/array/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/array/index.d.ts",
+        "default": "./dist/cjs/array/index.js"
+      }
     },
     "./object": {
-      "default": "./dist/object/index.js",
-      "types": "./dist/object/index.d.ts"
+      "import": {
+        "types": "./dist/mjs/object/index.d.ts",
+        "default": "./dist/mjs/object/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/object/index.d.ts",
+        "default": "./dist/cjs/object/index.js"
+      }
     },
     "./data-structures": {
-      "default": "./dist/data-structures/index.js",
-      "types": "./dist/data-structures/index.d.ts"
+      "import": {
+        "types": "./dist/mjs/data-structures/index.d.ts",
+        "default": "./dist/mjs/data-structures/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/data-structures/index.d.ts",
+        "default": "./dist/cjs/data-structures/index.js"
+      }
     },
     "./types": {
-      "default": "./dist/types/index.js",
-      "types": "./dist/types/index.d.ts"
+      "import": {
+        "types": "./dist/mjs/types/index.d.ts",
+        "default": "./dist/mjs/types/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/types/index.d.ts",
+        "default": "./dist/cjs/types/index.js"
+      }
     }
   },
+  "repository": "https://gitlab.squiz.net/optimization/optimization-utils",
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:mjs",
+    "build:check": "tsc --noEmit",
+    "exports:generate": "opti-build-utils exports:generate --config ../../generate-barrels.json && prettier -w ./src/index.ts",
+    "build:cjs": "tsc -p ./tsconfig-cjs.json",
+    "build:mjs": "tsc -p ./tsconfig-mjs.json && node ./scripts/build.mjs"
+  },
   "dependencies": {},
-  "devDependencies": {},
   "peerDependencies": {
-    "inversify": "^7.11.0",
+    "inversify": "^8.1.0",
     "@squiz/optimization-logger": "^1.11.4"
   },
+  "devDependencies": {},
   "author": "",
   "license": "ISC"
 }

package/scripts/build.mjs

@@ -0,0 +1,96 @@
+import { build } from 'esbuild';
+import esbuildPluginTsc from 'esbuild-plugin-tsc';
+import path from 'node:path';
+import fs from 'node:fs';
+import * as fsPromises from 'node:fs/promises';
+
+const packageRoot = path.resolve(import.meta.dirname, '..');
+const tsconfigMjsPath = path.join(packageRoot, 'tsconfig-mjs.json');
+const mjsOutDir = path.join(packageRoot, 'dist/mjs');
+const cjsOutDir = path.join(packageRoot, 'dist/cjs');
+
+const entryPoints = fs
+  .globSync('src/**/*.ts', {
+    cwd: packageRoot,
+    exclude: (file) => file.endsWith('.spec.ts') || file.endsWith('.d.ts'),
+  })
+  .map((file) => path.join(packageRoot, file));
+
+await build({
+  entryPoints,
+  outdir: mjsOutDir,
+  outbase: path.join(packageRoot, 'src'),
+  platform: 'node',
+  target: 'node22',
+  format: 'esm',
+  sourcemap: true,
+  plugins: [esbuildPluginTsc({ tsconfigPath: tsconfigMjsPath })],
+  tsconfig: tsconfigMjsPath,
+  packages: 'external',
+});
+
+// Add .js extension to relative imports for native ESM and Node16/NodeNext type resolution.
+// Resolve directory imports ("./foo") to "./foo/index.js" when applicable.
+const relativeImportRegex =
+  /(\bfrom\s+["']|\bimport\s*\(\s*["'])(\.{1,2}\/[^"']*?)(["'])/g;
+const filesToRewrite = fs.globSync('**/*.{js,d.ts}', { cwd: mjsOutDir });
+
+function resolveImport(fromFile, importPath) {
+  if (/\.(?:m?js|json|d\.ts)$/.test(importPath)) {
+    return importPath;
+  }
+  const absoluteFrom = path.dirname(fromFile);
+  const candidateFile = path.resolve(absoluteFrom, `${importPath}.js`);
+  if (fs.existsSync(candidateFile)) {
+    return `${importPath}.js`;
+  }
+  const candidateDir = path.resolve(absoluteFrom, importPath);
+  if (
+    fs.existsSync(candidateDir) &&
+    fs.statSync(candidateDir).isDirectory() &&
+    fs.existsSync(path.join(candidateDir, 'index.js'))
+  ) {
+    const sep = importPath.endsWith('/') ? '' : '/';
+    return `${importPath}${sep}index.js`;
+  }
+  return `${importPath}.js`;
+}
+
+await Promise.all(
+  filesToRewrite.map(async (file) => {
+    const filePath = path.join(mjsOutDir, file);
+    const content = await fsPromises.readFile(filePath, 'utf8');
+    const updated = content.replace(
+      relativeImportRegex,
+      (match, prefix, importPath, suffix) => {
+        const resolved = resolveImport(filePath, importPath);
+        if (resolved === importPath) {
+          return match;
+        }
+        return `${prefix}${resolved}${suffix}`;
+      },
+    );
+    if (updated !== content) {
+      await fsPromises.writeFile(filePath, updated, 'utf8');
+    }
+  }),
+);
+
+// Mark dist/cjs as commonjs (root package.json declares "type": "module")
+if (fs.existsSync(cjsOutDir)) {
+  await fsPromises.writeFile(
+    path.join(cjsOutDir, 'package.json'),
+    `${JSON.stringify({ type: 'commonjs' }, null, 2)}\n`,
+  );
+
+  // Copy .d.ts (and source maps) from dist/mjs so CJS consumers also get types
+  const typeFiles = fs.globSync('**/*.{d.ts,d.ts.map}', { cwd: mjsOutDir });
+  await Promise.all(
+    typeFiles.map(async (file) => {
+      const src = path.join(mjsOutDir, file);
+      const dst = path.join(cjsOutDir, file);
+      await fsPromises.mkdir(path.dirname(dst), { recursive: true });
+      await fsPromises.copyFile(src, dst);
+    }),
+  );
+}

package/tsconfig-cjs.json

@@ -0,0 +1,15 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "CommonJS",
+    "moduleResolution": "Bundler",
+    "verbatimModuleSyntax": false,
+    "ignoreDeprecations": "6.0",
+    "outDir": "dist/cjs",
+    "rootDir": "./src",
+    "declaration": false,
+    "types": ["*"]
+  },
+  "include": ["src"],
+  "exclude": ["dist", "**/*.spec.ts", "**/*.test.ts"]
+}

package/tsconfig-mjs.json

@@ -0,0 +1,24 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "verbatimModuleSyntax": false,
+    "outDir": "dist/mjs",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": true,
+    "types": [
+      "*"
+    ]
+  },
+  "include": [
+    "src"
+  ],
+  "exclude": [
+    "dist",
+    "**/*.spec.ts",
+    "**/*.test.ts"
+  ]
+}

package/dist/array/__tests__/chunkify.test.d.ts

@@ -1 +0,0 @@
-export {};