@zintrust/workers 0.4.41 → 0.4.42

package/dist/build-manifest.json

@@ -1,14 +1,14 @@
 {
   "name": "@zintrust/workers",
   "version": "0.4.41",
-  "buildDate": "2026-03-31T14:37:25.381Z",
+  "buildDate": "2026-04-01T09:59:18.039Z",
   "buildEnvironment": {
-    "node": "v22.22.1",
+    "node": "v25.6.1",
     "platform": "darwin",
     "arch": "arm64"
   },
   "git": {
-    "commit": "4c539a14",
+    "commit": "72821e8d",
     "branch": "release"
   },
   "package": {
@@ -230,8 +230,8 @@
       "sha256": "8af20d462270e7044c6ea983821f5b6e6ce8a5caf39b6e8fefff07c9a0bf071e"
     },
     "build-manifest.json": {
-      "size": 19595,
-      "sha256": "4001b2714ed94060884116aca4cc53ac46334aa4dbf9e718aaebdad65ffd6b96"
+      "size": 19594,
+      "sha256": "ddecf0356aec87965be6bedce19a58e72583c92cbf812cc4d6f070c676a2f6ab"
     },
     "config/workerConfig.d.ts": {
       "size": 132,
@@ -246,8 +246,8 @@
       "sha256": "dacd49f6c112eba439bdd9bb457eea90daedbf32efc381cd3189ce562fa5b0a8"
     },
     "createQueueWorker.js": {
-      "size": 14103,
-      "sha256": "8e619da00200c0c1270674a6a2941ae050c8ade3e38925b5446916cddc2a8b65"
+      "size": 14702,
+      "sha256": "69bf07658c185ad5b4bafd064bfc64ea257c769809b6d4811a274020b4a5a8e7"
     },
     "dashboard/index.d.ts": {
       "size": 109,
@@ -415,7 +415,7 @@
     },
     "index.js": {
       "size": 2337,
-      "sha256": "bfe511dc4d6219d056d3e49e717a0cfabc1310b3bcb4fbae25a5a6ebb522bdf2"
+      "sha256": "d50b450295bcf1c668101e8dbacc2ef2e376f6fbdf4d911a0fe953d2dfb42717"
     },
     "register.d.ts": {
       "size": 256,

package/dist/createQueueWorker.js

@@ -27,6 +27,14 @@ const getTimeoutManager = () => {
         return undefined;
     }
 };
+const getSystemDebuggerBridge = () => {
+    try {
+        return Core['SystemDebuggerBridge'];
+    }
+    catch {
+        return undefined;
+    }
+};
 const getEnvInt = (key, fallback) => {
     const getter = Env.getInt;
     if (typeof getter === 'function') {
@@ -110,6 +118,14 @@ const getTrackerApi = () => {
 const getHeartbeatStoreApi = () => {
     return (getJobHeartbeatStore() ?? {}) ?? {};
 };
+const emitJobProcessed = (name) => {
+    const bridge = (getSystemDebuggerBridge() ?? {});
+    bridge.emitJobProcessed?.(name);
+};
+const emitJobFailed = (name, error) => {
+    const bridge = (getSystemDebuggerBridge() ?? {});
+    bridge.emitJobFailed?.(name, error);
+};
 const removeHeartbeatIfSupported = async (queueName, jobId) => {
     const heartbeatStore = getHeartbeatStoreApi();
     if (typeof heartbeatStore.remove === 'function') {
@@ -161,6 +177,7 @@ const onProcessSuccess = async (input) => {
     }
     await removeHeartbeatIfSupported(input.queueName, input.message.id);
     Logger.info(`${input.options.kindLabel} processed successfully`, input.baseLogFields);
+    emitJobProcessed(input.queueName);
     return true;
 };
 const onProcessFailure = async (input) => {
@@ -173,6 +190,8 @@ const onProcessFailure = async (input) => {
         error: input.error,
         attempts: nextAttempts,
     });
+    const failure = input.error instanceof Error ? input.error : new Error(String(input.error));
+    emitJobFailed(input.queueName, failure);
     if (isTimeoutError(input.error) && typeof input.trackerApi.timedOut === 'function') {
         await input.trackerApi.timedOut({
             queueName: input.queueName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/workers",
-  "version": "0.4.41",
+  "version": "0.4.42",
   "description": "Worker orchestration and background job management for ZinTrust.",
   "private": false,
   "type": "module",
@@ -40,7 +40,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zintrust/core": "^0.4.41",
+    "@zintrust/core": "^0.4.42",
     "@zintrust/queue-monitor": "*",
     "@zintrust/queue-redis": "*"
   },
@@ -73,4 +73,4 @@
     "prom-client": "^15.1.3",
     "simple-statistics": "^7.8.9"
   }
-}
+}

package/src/createQueueWorker.ts

@@ -40,6 +40,14 @@ const getTimeoutManager = (): unknown => {
   }
 };
 
+const getSystemDebuggerBridge = (): unknown => {
+  try {
+    return (Core as Record<string, unknown>)['SystemDebuggerBridge'];
+  } catch {
+    return undefined;
+  }
+};
+
 const getEnvInt = (key: string, fallback: number): number => {
   const getter = (Env as { getInt?: (name: string, defaultValue: number) => number }).getInt;
   if (typeof getter === 'function') {
@@ -228,6 +236,22 @@ const getHeartbeatStoreApi = (): HeartbeatStoreApi => {
   return ((getJobHeartbeatStore() ?? {}) as HeartbeatStoreApi) ?? {};
 };
 
+const emitJobProcessed = (name: string): void => {
+  const bridge = (getSystemDebuggerBridge() ?? {}) as {
+    emitJobProcessed?: (jobName: string) => void;
+  };
+
+  bridge.emitJobProcessed?.(name);
+};
+
+const emitJobFailed = (name: string, error: Error): void => {
+  const bridge = (getSystemDebuggerBridge() ?? {}) as {
+    emitJobFailed?: (jobName: string, failure: Error) => void;
+  };
+
+  bridge.emitJobFailed?.(name, error);
+};
+
 const removeHeartbeatIfSupported = async (queueName: string, jobId: string): Promise<void> => {
   const heartbeatStore = getHeartbeatStoreApi();
   if (typeof heartbeatStore.remove === 'function') {
@@ -306,6 +330,7 @@ const onProcessSuccess = async <TPayload>(input: {
 
   await removeHeartbeatIfSupported(input.queueName, input.message.id);
   Logger.info(`${input.options.kindLabel} processed successfully`, input.baseLogFields);
+  emitJobProcessed(input.queueName);
   return true;
 };
 
@@ -329,6 +354,9 @@ const onProcessFailure = async <TPayload>(input: {
     attempts: nextAttempts,
   });
 
+  const failure = input.error instanceof Error ? input.error : new Error(String(input.error));
+  emitJobFailed(input.queueName, failure);
+
   if (isTimeoutError(input.error) && typeof input.trackerApi.timedOut === 'function') {
     await input.trackerApi.timedOut({
       queueName: input.queueName,