@intlayer/engine 9.1.3 → 9.2.0

package/dist/types/utils/runOnce.d.ts

@@ -1,4 +1,16 @@
 //#region src/utils/runOnce.d.ts
+/**
+ * Context handed to the callback so it can interact with the lock it runs under.
+ */
+type RunOnceContext = {
+  /**
+   * Re-create the sentinel file after an operation that may have deleted it —
+   * typically cleaning the output directory, which wipes the cache directory the
+   * sentinel lives in. Without this, concurrent processes would see no lock and
+   * start a competing run while this one is still writing.
+   */
+  renewLock: () => Promise<void>;
+};
 type RunOnceOptions = {
   /**
    * The function to execute when the sentinel is not found or is older than the cache timeout.
@@ -16,30 +28,42 @@ type RunOnceOptions = {
    * @default false
    */
   forceRun?: boolean;
+  /**
+   * How long to wait for another process to release the sentinel before
+   * considering its run abandoned and taking the lock over.
+   *
+   * @default 300000 = 5 minutes
+   */
+  lockWaitTimeoutMs?: number;
 };
 /**
  * Ensures a callback function runs only once within a specified time window across multiple processes.
  * Uses a sentinel file to coordinate execution and prevent duplicate work.
  *
+ * Processes that lose the race for the sentinel wait for the owner to finish
+ * rather than running a competing copy of the callback — concurrent runs would
+ * otherwise write to (and clean) the same output directory at the same time.
+ *
  * @param sentinelFilePath - Path to the sentinel file used for coordination
  * @param callback - The function to execute (should be async)
  * @param options - The options for the runOnce function
  *
  * @example
  * ```typescript
- * await runPrepareIntlayerOnce(
+ * await runOnce(
  *   '/tmp/intlayer-sentinel',
- *   async () => {
- *     // Your initialization logic here
+ *   async ({ renewLock }) => {
+ *     await cleanOutputDir(configuration); // may delete the sentinel
+ *     await renewLock();
  *     await prepareIntlayer();
  *   },
- *   30 * 1000 // 30 seconds cache
+ *   { cacheTimeoutMs: 30 * 1000 } // 30 seconds cache
  * );
  * ```
  *
  * @throws {Error} When there are unexpected filesystem errors
  */
-declare const runOnce: (sentinelFilePath: string, callback: () => void | Promise<void>, options?: RunOnceOptions) => Promise<void>;
+declare const runOnce: (sentinelFilePath: string, callback: (context: RunOnceContext) => void | Promise<void>, options?: RunOnceOptions) => Promise<void>;
 //#endregion
-export { runOnce };
+export { RunOnceContext, runOnce };
 //# sourceMappingURL=runOnce.d.ts.map

package/dist/types/utils/runOnce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runOnce.d.ts","names":[],"sources":["../../../src/utils/runOnce.ts"],"mappings":";KAIK;;;;EAIH,0BAA0B;;;;;;EAM1B;;;;;;EAMA;;;;;;;;;;;;;;;;;;;;;;;;cAoEW,UAAO,0BACM,uBACD,eAAa,UAC1B,mBAAc"}
+{"version":3,"file":"runOnce.d.ts","names":[],"sources":["../../../src/utils/runOnce.ts"],"mappings":";;;;KA4BY;;;;;;;EAOV,iBAAiB;;KAGd;;;;EAIH,0BAA0B;;;;;;EAM1B;;;;;;EAMA;;;;;;;EAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwKW,UAAO,0BACM,WACb,SAAS,0BAA0B,eAAa,UACjD,mBAAc"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/engine",
-  "version": "9.1.3",
+  "version": "9.2.0",
   "private": false,
   "description": "Scans and builds Intlayer declaration files into dictionaries based on Intlayer configuration.",
   "keywords": [
@@ -141,13 +141,13 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "9.1.3",
-    "@intlayer/config": "9.1.3",
-    "@intlayer/core": "9.1.3",
-    "@intlayer/dictionaries-entry": "9.1.3",
-    "@intlayer/remote-dictionaries-entry": "9.1.3",
-    "@intlayer/types": "9.1.3",
-    "@intlayer/unmerged-dictionaries-entry": "9.1.3",
+    "@intlayer/api": "9.2.0",
+    "@intlayer/config": "9.2.0",
+    "@intlayer/core": "9.2.0",
+    "@intlayer/dictionaries-entry": "9.2.0",
+    "@intlayer/remote-dictionaries-entry": "9.2.0",
+    "@intlayer/types": "9.2.0",
+    "@intlayer/unmerged-dictionaries-entry": "9.2.0",
     "@parcel/watcher": "2.6.0",
     "defu": "6.1.7",
     "fast-glob": "3.3.3",
@@ -167,7 +167,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "@intlayer/babel": "9.1.3"
+    "@intlayer/babel": "9.2.0"
   },
   "peerDependenciesMeta": {
     "@intlayer/babel": {