@windrun-huaiin/backend-core 29.0.2 → 29.0.3

package/dist/lib/upstash/qstash.js

@@ -67,7 +67,7 @@ const publishMessage = (options) => tslib.__awaiter(void 0, void 0, void 0, func
             messageId: typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null,
             message,
         };
-    }));
+    }), 'publishMessage');
 });
 /**
  * Publish a broadcast message to a QStash URL Group.
@@ -93,7 +93,7 @@ const publishBroadcastMessage = (options) => tslib.__awaiter(void 0, void 0, voi
             messageIds,
             message,
         };
-    }));
+    }), 'publishBroadcastMessage');
 });
 /**
  * Publish a single-recipient message into a QStash FIFO queue.
@@ -117,7 +117,7 @@ const publishFIFOQueueMessage = (options) => tslib.__awaiter(void 0, void 0, voi
             messageId: typeof result === 'string' ? result : (_b = result === null || result === void 0 ? void 0 : result.messageId) !== null && _b !== void 0 ? _b : null,
             message,
         };
-    }));
+    }), 'publishFIFOQueueMessage');
 });
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
@@ -135,7 +135,7 @@ const publishDelayedMessage = (options) => tslib.__awaiter(void 0, void 0, void
             messageId: typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null,
             message,
         };
-    }));
+    }), 'publishDelayedMessage');
 });
 /**
  * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
@@ -158,7 +158,7 @@ const scheduleMessage = (options) => tslib.__awaiter(void 0, void 0, void 0, fun
             scheduleId: typeof result === 'string' ? result : (_f = (_e = result === null || result === void 0 ? void 0 : result.scheduleId) !== null && _e !== void 0 ? _e : result === null || result === void 0 ? void 0 : result.id) !== null && _f !== void 0 ? _f : null,
             message,
         };
-    }));
+    }), 'scheduleMessage');
 });
 /**
  * Cancel a scheduled message. Returns false if QStash is unavailable.
@@ -176,7 +176,7 @@ const cancelSchedule = (scheduleId) => tslib.__awaiter(void 0, void 0, void 0, f
             return true;
         }
         return false;
-    }));
+    }), 'cancelSchedule');
     return result !== null && result !== void 0 ? result : false;
 });
 /**

package/dist/lib/upstash/qstash.mjs

@@ -65,7 +65,7 @@ const publishMessage = (options) => __awaiter(void 0, void 0, void 0, function*
             messageId: typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null,
             message,
         };
-    }));
+    }), 'publishMessage');
 });
 /**
  * Publish a broadcast message to a QStash URL Group.
@@ -91,7 +91,7 @@ const publishBroadcastMessage = (options) => __awaiter(void 0, void 0, void 0, f
             messageIds,
             message,
         };
-    }));
+    }), 'publishBroadcastMessage');
 });
 /**
  * Publish a single-recipient message into a QStash FIFO queue.
@@ -115,7 +115,7 @@ const publishFIFOQueueMessage = (options) => __awaiter(void 0, void 0, void 0, f
             messageId: typeof result === 'string' ? result : (_b = result === null || result === void 0 ? void 0 : result.messageId) !== null && _b !== void 0 ? _b : null,
             message,
         };
-    }));
+    }), 'publishFIFOQueueMessage');
 });
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
@@ -133,7 +133,7 @@ const publishDelayedMessage = (options) => __awaiter(void 0, void 0, void 0, fun
             messageId: typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null,
             message,
         };
-    }));
+    }), 'publishDelayedMessage');
 });
 /**
  * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
@@ -156,7 +156,7 @@ const scheduleMessage = (options) => __awaiter(void 0, void 0, void 0, function*
             scheduleId: typeof result === 'string' ? result : (_f = (_e = result === null || result === void 0 ? void 0 : result.scheduleId) !== null && _e !== void 0 ? _e : result === null || result === void 0 ? void 0 : result.id) !== null && _f !== void 0 ? _f : null,
             message,
         };
-    }));
+    }), 'scheduleMessage');
 });
 /**
  * Cancel a scheduled message. Returns false if QStash is unavailable.
@@ -174,7 +174,7 @@ const cancelSchedule = (scheduleId) => __awaiter(void 0, void 0, void 0, functio
             return true;
         }
         return false;
-    }));
+    }), 'cancelSchedule');
     return result !== null && result !== void 0 ? result : false;
 });
 /**

package/dist/lib/upstash-config.d.ts

@@ -19,5 +19,5 @@ export declare const getRedis: () => Redis | null;
  */
 export declare const getQstash: () => QstashClient | null;
 export declare const withRedis: <T>(fn: (redis: Redis) => Promise<T> | T) => Promise<T | null>;
-export declare const withQstash: <T>(fn: (qstash: QstashClient) => Promise<T> | T) => Promise<T | null>;
+export declare const withQstash: <T>(fn: (qstash: QstashClient) => Promise<T> | T, operation?: string) => Promise<T | null>;
 //# sourceMappingURL=upstash-config.d.ts.map

package/dist/lib/upstash-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upstash-config.d.ts","sourceRoot":"","sources":["../../src/lib/upstash-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA2DzD,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAyD,CAAC;AAE5G,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,KAAG,MAAM,EAAmC,CAAC;AAEhG,eAAO,MAAM,mBAAmB,QAAO,MAEtC,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,KAAG,MAMzD,CAAC;AAiMF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,QAAO,KAAK,GAAG,IAEnC,CAAC;AAwDF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAO,YAAY,GAAG,IAE3C,CAAC;AA+CF,eAAO,MAAM,SAAS,GAAU,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAMzF,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,CAAC,EAChC,IAAI,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAC3C,OAAO,CAAC,CAAC,GAAG,IAAI,CAMlB,CAAC"}
+{"version":3,"file":"upstash-config.d.ts","sourceRoot":"","sources":["../../src/lib/upstash-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAoHzD,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAyD,CAAC;AAE5G,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,KAAG,MAAM,EAAmC,CAAC;AAEhG,eAAO,MAAM,mBAAmB,QAAO,MAEtC,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,KAAG,MAMzD,CAAC;AAyMF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,QAAO,KAAK,GAAG,IAEnC,CAAC;AAwDF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAO,YAAY,GAAG,IAE3C,CAAC;AA+CF,eAAO,MAAM,SAAS,GAAU,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAMzF,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,CAAC,EAChC,IAAI,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC5C,kBAAqB,KACpB,OAAO,CAAC,CAAC,GAAG,IAAI,CAgBlB,CAAC"}

package/dist/lib/upstash-config.js

@@ -20,6 +20,41 @@ let qstashWarnedHealthSchedule = false;
 let redisHealthTimer = null;
 let qstashHealthTimer = null;
 let cachedRedisPrefixed = null;
+const isUpstashDebugEnabled = () => process.env.UPSTASH_DEBUG === 'true';
+const formatDuration = (startedAt) => `${Date.now() - startedAt}ms`;
+const logUpstashDuration = (scope, operation, startedAt, status, error) => {
+    if (!isUpstashDebugEnabled()) {
+        return;
+    }
+    const message = `[Upstash Debug] ${scope} ${operation} completed in ${formatDuration(startedAt)} status=${status}`;
+    if (error == null) {
+        console.log(message);
+        return;
+    }
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.log(`${message} error=${errorMessage}`);
+};
+const isPromiseLike = (value) => typeof value === 'object' && value !== null && typeof value.then === 'function';
+const trackUpstashOperation = (scope, operation, startedAt, run) => {
+    try {
+        const result = run();
+        if (isPromiseLike(result)) {
+            return result.then((resolved) => {
+                logUpstashDuration(scope, operation, startedAt, 'ok');
+                return resolved;
+            }, (error) => {
+                logUpstashDuration(scope, operation, startedAt, 'error', error);
+                throw error;
+            });
+        }
+        logUpstashDuration(scope, operation, startedAt, 'ok');
+        return result;
+    }
+    catch (error) {
+        logUpstashDuration(scope, operation, startedAt, 'error', error);
+        throw error;
+    }
+};
 const isNonEmpty = (value) => typeof value === 'string' && value.trim().length > 0;
 const isValidUrl = (value) => {
     try {
@@ -88,33 +123,39 @@ const createPrefixedPipeline = (target, prefix) => {
                 return value;
             }
             return (...args) => {
+                const operation = typeof prop === 'string' ? prop : String(prop);
+                const startedAt = Date.now();
                 if (prop === 'eval' || prop === 'evalsha' || prop === 'evalro' || prop === 'evalshaRo') {
                     const [script, keys, argv] = args;
-                    return value.call(obj, script, prefixRedisKeys(prefix, keys), argv);
+                    return trackUpstashOperation('Redis', operation, startedAt, () => value.call(obj, script, prefixRedisKeys(prefix, keys), argv));
                 }
                 if (prop === 'pipeline' || prop === 'multi') {
-                    const nested = value.call(obj);
-                    return createPrefixedPipeline(nested, prefix);
-                }
-                if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
-                    const nextArgs = prefixVariadicKeyArgs(args, prefix);
-                    return value.apply(obj, nextArgs);
-                }
-                if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
-                    const nextArgs = prefixVariadicKeyArgs(args, prefix);
-                    return value.apply(obj, nextArgs);
+                    return trackUpstashOperation('Redis', operation, startedAt, () => {
+                        const nested = value.call(obj);
+                        return createPrefixedPipeline(nested, prefix);
+                    });
                 }
-                if (prop === 'mset') {
-                    const [entries] = args;
-                    const prefixedEntries = Object.fromEntries(Object.entries(entries).map(([key, entryValue]) => [prefixRedisKey(prefix, key), entryValue]));
-                    return value.call(obj, prefixedEntries);
-                }
-                if (prop === 'hmget') {
+                return trackUpstashOperation('Redis', operation, startedAt, () => {
+                    if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
+                        const nextArgs = prefixVariadicKeyArgs(args, prefix);
+                        return value.apply(obj, nextArgs);
+                    }
+                    if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
+                        const nextArgs = prefixVariadicKeyArgs(args, prefix);
+                        return value.apply(obj, nextArgs);
+                    }
+                    if (prop === 'mset') {
+                        const [entries] = args;
+                        const prefixedEntries = Object.fromEntries(Object.entries(entries).map(([key, entryValue]) => [prefixRedisKey(prefix, key), entryValue]));
+                        return value.call(obj, prefixedEntries);
+                    }
+                    if (prop === 'hmget') {
+                        const nextArgs = prefixFirstStringArg(args, prefix);
+                        return value.apply(obj, nextArgs);
+                    }
                     const nextArgs = prefixFirstStringArg(args, prefix);
                     return value.apply(obj, nextArgs);
-                }
-                const nextArgs = prefixFirstStringArg(args, prefix);
-                return value.apply(obj, nextArgs);
+                });
             };
         },
     });
@@ -337,12 +378,22 @@ const withRedis = (fn) => tslib.__awaiter(void 0, void 0, void 0, function* () {
     }
     return fn(redis);
 });
-const withQstash = (fn) => tslib.__awaiter(void 0, void 0, void 0, function* () {
+const withQstash = (fn_1, ...args_1) => tslib.__awaiter(void 0, [fn_1, ...args_1], void 0, function* (fn, operation = 'request') {
+    const startedAt = Date.now();
     const qstash = yield ensureQstash();
     if (!qstash) {
+        logUpstashDuration('QStash', operation, startedAt, 'unavailable');
         return null;
     }
-    return fn(qstash);
+    try {
+        const result = yield fn(qstash);
+        logUpstashDuration('QStash', operation, startedAt, 'ok');
+        return result;
+    }
+    catch (error) {
+        logUpstashDuration('QStash', operation, startedAt, 'error', error);
+        throw error;
+    }
 });
 
 exports.getPrefixedQstashQueueName = getPrefixedQstashQueueName;

package/dist/lib/upstash-config.mjs

@@ -18,6 +18,41 @@ let qstashWarnedHealthSchedule = false;
 let redisHealthTimer = null;
 let qstashHealthTimer = null;
 let cachedRedisPrefixed = null;
+const isUpstashDebugEnabled = () => process.env.UPSTASH_DEBUG === 'true';
+const formatDuration = (startedAt) => `${Date.now() - startedAt}ms`;
+const logUpstashDuration = (scope, operation, startedAt, status, error) => {
+    if (!isUpstashDebugEnabled()) {
+        return;
+    }
+    const message = `[Upstash Debug] ${scope} ${operation} completed in ${formatDuration(startedAt)} status=${status}`;
+    if (error == null) {
+        console.log(message);
+        return;
+    }
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.log(`${message} error=${errorMessage}`);
+};
+const isPromiseLike = (value) => typeof value === 'object' && value !== null && typeof value.then === 'function';
+const trackUpstashOperation = (scope, operation, startedAt, run) => {
+    try {
+        const result = run();
+        if (isPromiseLike(result)) {
+            return result.then((resolved) => {
+                logUpstashDuration(scope, operation, startedAt, 'ok');
+                return resolved;
+            }, (error) => {
+                logUpstashDuration(scope, operation, startedAt, 'error', error);
+                throw error;
+            });
+        }
+        logUpstashDuration(scope, operation, startedAt, 'ok');
+        return result;
+    }
+    catch (error) {
+        logUpstashDuration(scope, operation, startedAt, 'error', error);
+        throw error;
+    }
+};
 const isNonEmpty = (value) => typeof value === 'string' && value.trim().length > 0;
 const isValidUrl = (value) => {
     try {
@@ -86,33 +121,39 @@ const createPrefixedPipeline = (target, prefix) => {
                 return value;
             }
             return (...args) => {
+                const operation = typeof prop === 'string' ? prop : String(prop);
+                const startedAt = Date.now();
                 if (prop === 'eval' || prop === 'evalsha' || prop === 'evalro' || prop === 'evalshaRo') {
                     const [script, keys, argv] = args;
-                    return value.call(obj, script, prefixRedisKeys(prefix, keys), argv);
+                    return trackUpstashOperation('Redis', operation, startedAt, () => value.call(obj, script, prefixRedisKeys(prefix, keys), argv));
                 }
                 if (prop === 'pipeline' || prop === 'multi') {
-                    const nested = value.call(obj);
-                    return createPrefixedPipeline(nested, prefix);
-                }
-                if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
-                    const nextArgs = prefixVariadicKeyArgs(args, prefix);
-                    return value.apply(obj, nextArgs);
-                }
-                if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
-                    const nextArgs = prefixVariadicKeyArgs(args, prefix);
-                    return value.apply(obj, nextArgs);
+                    return trackUpstashOperation('Redis', operation, startedAt, () => {
+                        const nested = value.call(obj);
+                        return createPrefixedPipeline(nested, prefix);
+                    });
                 }
-                if (prop === 'mset') {
-                    const [entries] = args;
-                    const prefixedEntries = Object.fromEntries(Object.entries(entries).map(([key, entryValue]) => [prefixRedisKey(prefix, key), entryValue]));
-                    return value.call(obj, prefixedEntries);
-                }
-                if (prop === 'hmget') {
+                return trackUpstashOperation('Redis', operation, startedAt, () => {
+                    if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
+                        const nextArgs = prefixVariadicKeyArgs(args, prefix);
+                        return value.apply(obj, nextArgs);
+                    }
+                    if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
+                        const nextArgs = prefixVariadicKeyArgs(args, prefix);
+                        return value.apply(obj, nextArgs);
+                    }
+                    if (prop === 'mset') {
+                        const [entries] = args;
+                        const prefixedEntries = Object.fromEntries(Object.entries(entries).map(([key, entryValue]) => [prefixRedisKey(prefix, key), entryValue]));
+                        return value.call(obj, prefixedEntries);
+                    }
+                    if (prop === 'hmget') {
+                        const nextArgs = prefixFirstStringArg(args, prefix);
+                        return value.apply(obj, nextArgs);
+                    }
                     const nextArgs = prefixFirstStringArg(args, prefix);
                     return value.apply(obj, nextArgs);
-                }
-                const nextArgs = prefixFirstStringArg(args, prefix);
-                return value.apply(obj, nextArgs);
+                });
             };
         },
     });
@@ -335,12 +376,22 @@ const withRedis = (fn) => __awaiter(void 0, void 0, void 0, function* () {
     }
     return fn(redis);
 });
-const withQstash = (fn) => __awaiter(void 0, void 0, void 0, function* () {
+const withQstash = (fn_1, ...args_1) => __awaiter(void 0, [fn_1, ...args_1], void 0, function* (fn, operation = 'request') {
+    const startedAt = Date.now();
     const qstash = yield ensureQstash();
     if (!qstash) {
+        logUpstashDuration('QStash', operation, startedAt, 'unavailable');
         return null;
     }
-    return fn(qstash);
+    try {
+        const result = yield fn(qstash);
+        logUpstashDuration('QStash', operation, startedAt, 'ok');
+        return result;
+    }
+    catch (error) {
+        logUpstashDuration('QStash', operation, startedAt, 'error', error);
+        throw error;
+    }
 });
 
 export { getPrefixedQstashQueueName, getPrefixedRedisKey, getPrefixedRedisKeys, getQstash, getQstashNamePrefix, getRedis, withQstash, withRedis };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "29.0.2",
+  "version": "29.0.3",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -149,8 +149,8 @@
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
     "@windrun-huaiin/contracts": "^29.0.0",
-    "@windrun-huaiin/third-ui": "^29.0.3",
-    "@windrun-huaiin/lib": "^29.0.0"
+    "@windrun-huaiin/lib": "^29.0.0",
+    "@windrun-huaiin/third-ui": "^29.0.3"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",

package/src/lib/upstash/qstash.ts

@@ -99,7 +99,7 @@ export const publishMessage = async <TBody extends PublishBody>(
       messageId: typeof result === 'string' ? result : result?.messageId ?? null,
       message,
     };
-  });
+  }, 'publishMessage');
 };
 
 /**
@@ -133,7 +133,7 @@ export const publishBroadcastMessage = async <TBody extends PublishBody>(
       messageIds,
       message,
     };
-  });
+  }, 'publishBroadcastMessage');
 };
 
 /**
@@ -162,7 +162,7 @@ export const publishFIFOQueueMessage = async <TBody extends PublishBody>(
       messageId: typeof result === 'string' ? result : result?.messageId ?? null,
       message,
     };
-  });
+  }, 'publishFIFOQueueMessage');
 };
 
 /**
@@ -183,7 +183,7 @@ export const publishDelayedMessage = async <TBody extends PublishBody>(
       messageId: typeof result === 'string' ? result : result?.messageId ?? null,
       message,
     };
-  });
+  }, 'publishDelayedMessage');
 };
 
 export interface ScheduleMessageOptions<TBody extends PublishBody = PublishBody>
@@ -217,7 +217,7 @@ export const scheduleMessage = async <TBody extends PublishBody>(
       scheduleId: typeof result === 'string' ? result : result?.scheduleId ?? result?.id ?? null,
       message,
     };
-  });
+  }, 'scheduleMessage');
 };
 
 /**
@@ -235,7 +235,7 @@ export const cancelSchedule = async (scheduleId: string): Promise<boolean> => {
       return true;
     }
     return false;
-  });
+  }, 'cancelSchedule');
 
   return result ?? false;
 };

package/src/lib/upstash-config.ts

@@ -21,6 +21,63 @@ let redisHealthTimer: ReturnType<typeof setTimeout> | null = null;
 let qstashHealthTimer: ReturnType<typeof setTimeout> | null = null;
 let cachedRedisPrefixed: Redis | null = null;
 
+const isUpstashDebugEnabled = (): boolean => process.env.UPSTASH_DEBUG === 'true';
+
+const formatDuration = (startedAt: number): string => `${Date.now() - startedAt}ms`;
+
+const logUpstashDuration = (
+  scope: string,
+  operation: string,
+  startedAt: number,
+  status: 'ok' | 'error' | 'unavailable',
+  error?: unknown
+): void => {
+  if (!isUpstashDebugEnabled()) {
+    return;
+  }
+
+  const message = `[Upstash Debug] ${scope} ${operation} completed in ${formatDuration(startedAt)} status=${status}`;
+  if (error == null) {
+    console.log(message);
+    return;
+  }
+
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  console.log(`${message} error=${errorMessage}`);
+};
+
+const isPromiseLike = <T>(value: unknown): value is Promise<T> =>
+  typeof value === 'object' && value !== null && typeof (value as Promise<T>).then === 'function';
+
+const trackUpstashOperation = <T>(
+  scope: string,
+  operation: string,
+  startedAt: number,
+  run: () => T
+): T => {
+  try {
+    const result = run();
+    if (isPromiseLike(result)) {
+      return result.then(
+        (resolved) => {
+          logUpstashDuration(scope, operation, startedAt, 'ok');
+          return resolved;
+        },
+        (error) => {
+          logUpstashDuration(scope, operation, startedAt, 'error', error);
+          throw error;
+        }
+      ) as T;
+    }
+
+    logUpstashDuration(scope, operation, startedAt, 'ok');
+    return result;
+  } catch (error) {
+    logUpstashDuration(scope, operation, startedAt, 'error', error);
+    throw error;
+  }
+};
+
 const isNonEmpty = (value: string | undefined): value is string =>
   typeof value === 'string' && value.trim().length > 0;
 
@@ -115,46 +172,54 @@ const createPrefixedPipeline = <T extends object>(target: T, prefix: string): T
       }
 
       return (...args: unknown[]) => {
+        const operation = typeof prop === 'string' ? prop : String(prop);
+        const startedAt = Date.now();
         if (prop === 'eval' || prop === 'evalsha' || prop === 'evalro' || prop === 'evalshaRo') {
           const [script, keys, argv] = args as [string, string[], unknown[]];
-          return (value as (...innerArgs: unknown[]) => unknown).call(
-            obj,
-            script,
-            prefixRedisKeys(prefix, keys),
-            argv
+          return trackUpstashOperation('Redis', operation, startedAt, () =>
+            (value as (...innerArgs: unknown[]) => unknown).call(
+              obj,
+              script,
+              prefixRedisKeys(prefix, keys),
+              argv
+            )
           );
         }
 
         if (prop === 'pipeline' || prop === 'multi') {
-          const nested = (value as (...innerArgs: unknown[]) => unknown).call(obj);
-          return createPrefixedPipeline(nested as T, prefix);
-        }
-
-        if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
-          const nextArgs = prefixVariadicKeyArgs(args, prefix);
-          return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
-        }
-
-        if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
-          const nextArgs = prefixVariadicKeyArgs(args, prefix);
-          return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
+          return trackUpstashOperation('Redis', operation, startedAt, () => {
+            const nested = (value as (...innerArgs: unknown[]) => unknown).call(obj);
+            return createPrefixedPipeline(nested as T, prefix);
+          });
         }
 
-        if (prop === 'mset') {
-          const [entries] = args as [Record<string, unknown>];
-          const prefixedEntries = Object.fromEntries(
-            Object.entries(entries).map(([key, entryValue]) => [prefixRedisKey(prefix, key), entryValue])
-          );
-          return (value as (...innerArgs: unknown[]) => unknown).call(obj, prefixedEntries);
-        }
+        return trackUpstashOperation('Redis', operation, startedAt, () => {
+          if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
+            const nextArgs = prefixVariadicKeyArgs(args, prefix);
+            return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
+          }
+
+          if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
+            const nextArgs = prefixVariadicKeyArgs(args, prefix);
+            return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
+          }
+
+          if (prop === 'mset') {
+            const [entries] = args as [Record<string, unknown>];
+            const prefixedEntries = Object.fromEntries(
+              Object.entries(entries).map(([key, entryValue]) => [prefixRedisKey(prefix, key), entryValue])
+            );
+            return (value as (...innerArgs: unknown[]) => unknown).call(obj, prefixedEntries);
+          }
+
+          if (prop === 'hmget') {
+            const nextArgs = prefixFirstStringArg(args, prefix);
+            return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
+          }
 
-        if (prop === 'hmget') {
           const nextArgs = prefixFirstStringArg(args, prefix);
           return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
-        }
-
-        const nextArgs = prefixFirstStringArg(args, prefix);
-        return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
+        });
       };
     },
   });
@@ -393,11 +458,22 @@ export const withRedis = async <T>(fn: (redis: Redis) => Promise<T> | T): Promis
 };
 
 export const withQstash = async <T>(
-  fn: (qstash: QstashClient) => Promise<T> | T
+  fn: (qstash: QstashClient) => Promise<T> | T,
+  operation = 'request'
 ): Promise<T | null> => {
+  const startedAt = Date.now();
   const qstash = await ensureQstash();
   if (!qstash) {
+    logUpstashDuration('QStash', operation, startedAt, 'unavailable');
     return null;
   }
-  return fn(qstash);
+
+  try {
+    const result = await fn(qstash);
+    logUpstashDuration('QStash', operation, startedAt, 'ok');
+    return result;
+  } catch (error) {
+    logUpstashDuration('QStash', operation, startedAt, 'error', error);
+    throw error;
+  }
 };