@windrun-huaiin/backend-core 20.0.0 → 20.1.0

package/dist/index.js

@@ -115,7 +115,11 @@ exports.fetchPaymentId = stripeConfig.fetchPaymentId;
 exports.getStripe = stripeConfig.getStripe;
 exports.updateSubscription = stripeConfig.updateSubscription;
 exports.validateStripeWebhook = stripeConfig.validateStripeWebhook;
+exports.getPrefixedQstashQueueName = upstashConfig.getPrefixedQstashQueueName;
+exports.getPrefixedRedisKey = upstashConfig.getPrefixedRedisKey;
+exports.getPrefixedRedisKeys = upstashConfig.getPrefixedRedisKeys;
 exports.getQstash = upstashConfig.getQstash;
+exports.getQstashNamePrefix = upstashConfig.getQstashNamePrefix;
 exports.getRedis = upstashConfig.getRedis;
 exports.withQstash = upstashConfig.withQstash;
 exports.withRedis = upstashConfig.withRedis;
@@ -171,7 +175,9 @@ exports.smembers = redisStructures.smembers;
 exports.srem = redisStructures.srem;
 exports.ttl = redisStructures.ttl;
 exports.cancelSchedule = qstash.cancelSchedule;
+exports.publishBroadcastMessage = qstash.publishBroadcastMessage;
 exports.publishDelayedMessage = qstash.publishDelayedMessage;
+exports.publishFIFOQueueMessage = qstash.publishFIFOQueueMessage;
 exports.publishMessage = qstash.publishMessage;
 exports.scheduleMessage = qstash.scheduleMessage;
 exports.verifyQstashSignature = qstash.verifyQstashSignature;

package/dist/index.mjs

@@ -26,10 +26,10 @@ export { getMoneyPriceInitUserContext } from './lib/money-price-helper.mjs';
 export { fingerprintConfig } from './lib/fingerprint-config.mjs';
 export { creditsConfig, freeAmount, freeExpiredDays, freeRegisterAmount, oneTimeExpiredDays } from './lib/credit-init.mjs';
 export { ActiveSubscriptionExistsError, cancelSubscription, createCheckoutSession, createCustomerPortalSession, createOrGetCustomer, fetchPaymentId, getStripe, updateSubscription, validateStripeWebhook } from './lib/stripe-config.mjs';
-export { getQstash, getRedis, withQstash, withRedis } from './lib/upstash-config.mjs';
+export { getPrefixedQstashQueueName, getPrefixedRedisKey, getPrefixedRedisKeys, getQstash, getQstashNamePrefix, getRedis, withQstash, withRedis } from './lib/upstash-config.mjs';
 export { acquireLock, releaseLock, withLock } from './lib/upstash/redis-lock.mjs';
 export { getTargetLikeCount, getUserLikedTargets, isTargetLiked, likeTarget, unlikeTarget } from './lib/upstash/redis-like.mjs';
 export { addFavorite, getFavoriteCount, getUserFavorites, isFavorited, removeFavorite } from './lib/upstash/redis-favorite.mjs';
 export { getCounter, getUniqueCounter, incrCounter, incrUniqueCounter } from './lib/upstash/redis-counter.mjs';
 export { del, deleteHashField, deleteKey, exists, expire, getHashAll, getHashField, getHashJson, getJson, getString, hexists, hkeys, hlen, hmget, hmset, listLength, mget, mgetJson, mset, msetJson, pipeline, popList, pushList, rangeList, sadd, scard, setHashField, setHashJson, setJson, setString, sismember, smembers, srem, ttl } from './lib/upstash/redis-structures.mjs';
-export { cancelSchedule, publishDelayedMessage, publishMessage, scheduleMessage, verifyQstashSignature } from './lib/upstash/qstash.mjs';
+export { cancelSchedule, publishBroadcastMessage, publishDelayedMessage, publishFIFOQueueMessage, publishMessage, scheduleMessage, verifyQstashSignature } from './lib/upstash/qstash.mjs';

package/dist/lib/index.js

@@ -35,7 +35,11 @@ exports.fetchPaymentId = stripeConfig.fetchPaymentId;
 exports.getStripe = stripeConfig.getStripe;
 exports.updateSubscription = stripeConfig.updateSubscription;
 exports.validateStripeWebhook = stripeConfig.validateStripeWebhook;
+exports.getPrefixedQstashQueueName = upstashConfig.getPrefixedQstashQueueName;
+exports.getPrefixedRedisKey = upstashConfig.getPrefixedRedisKey;
+exports.getPrefixedRedisKeys = upstashConfig.getPrefixedRedisKeys;
 exports.getQstash = upstashConfig.getQstash;
+exports.getQstashNamePrefix = upstashConfig.getQstashNamePrefix;
 exports.getRedis = upstashConfig.getRedis;
 exports.withQstash = upstashConfig.withQstash;
 exports.withRedis = upstashConfig.withRedis;
@@ -91,7 +95,9 @@ exports.smembers = redisStructures.smembers;
 exports.srem = redisStructures.srem;
 exports.ttl = redisStructures.ttl;
 exports.cancelSchedule = qstash.cancelSchedule;
+exports.publishBroadcastMessage = qstash.publishBroadcastMessage;
 exports.publishDelayedMessage = qstash.publishDelayedMessage;
+exports.publishFIFOQueueMessage = qstash.publishFIFOQueueMessage;
 exports.publishMessage = qstash.publishMessage;
 exports.scheduleMessage = qstash.scheduleMessage;
 exports.verifyQstashSignature = qstash.verifyQstashSignature;

package/dist/lib/index.mjs

@@ -3,10 +3,10 @@ export { getMoneyPriceInitUserContext } from './money-price-helper.mjs';
 export { fingerprintConfig } from './fingerprint-config.mjs';
 export { creditsConfig, freeAmount, freeExpiredDays, freeRegisterAmount, oneTimeExpiredDays } from './credit-init.mjs';
 export { ActiveSubscriptionExistsError, cancelSubscription, createCheckoutSession, createCustomerPortalSession, createOrGetCustomer, fetchPaymentId, getStripe, updateSubscription, validateStripeWebhook } from './stripe-config.mjs';
-export { getQstash, getRedis, withQstash, withRedis } from './upstash-config.mjs';
+export { getPrefixedQstashQueueName, getPrefixedRedisKey, getPrefixedRedisKeys, getQstash, getQstashNamePrefix, getRedis, withQstash, withRedis } from './upstash-config.mjs';
 export { acquireLock, releaseLock, withLock } from './upstash/redis-lock.mjs';
 export { getTargetLikeCount, getUserLikedTargets, isTargetLiked, likeTarget, unlikeTarget } from './upstash/redis-like.mjs';
 export { addFavorite, getFavoriteCount, getUserFavorites, isFavorited, removeFavorite } from './upstash/redis-favorite.mjs';
 export { getCounter, getUniqueCounter, incrCounter, incrUniqueCounter } from './upstash/redis-counter.mjs';
 export { del, deleteHashField, deleteKey, exists, expire, getHashAll, getHashField, getHashJson, getJson, getString, hexists, hkeys, hlen, hmget, hmset, listLength, mget, mgetJson, mset, msetJson, pipeline, popList, pushList, rangeList, sadd, scard, setHashField, setHashJson, setJson, setString, sismember, smembers, srem, ttl } from './upstash/redis-structures.mjs';
-export { cancelSchedule, publishDelayedMessage, publishMessage, scheduleMessage, verifyQstashSignature } from './upstash/qstash.mjs';
+export { cancelSchedule, publishBroadcastMessage, publishDelayedMessage, publishFIFOQueueMessage, publishMessage, scheduleMessage, verifyQstashSignature } from './upstash/qstash.mjs';

package/dist/lib/upstash/qstash.d.ts

@@ -7,6 +7,15 @@ export interface PublishMessageOptions<TBody extends PublishBody = PublishBody>
     url: string;
     body: TBody;
 }
+export interface PublishBroadcastMessageOptions<TBody extends PublishBody = PublishBody> {
+    urlGroup: string;
+    body: TBody;
+}
+export interface PublishFIFOQueueMessageOptions<TBody extends PublishBody = PublishBody> {
+    queueName: string;
+    url: string;
+    body: TBody;
+}
 /**
  * Publish a message. Returns message id or null if QStash is unavailable.
  */
@@ -14,6 +23,22 @@ export declare const publishMessage: <TBody extends PublishBody>(options: Publis
     messageId: string | null;
     message: QstashEnvelope<TBody>;
 } | null>;
+/**
+ * Publish a broadcast message to a QStash URL Group.
+ * Returns message ids or null if QStash is unavailable.
+ */
+export declare const publishBroadcastMessage: <TBody extends PublishBody>(options: PublishBroadcastMessageOptions<TBody>) => Promise<{
+    messageIds: string[];
+    message: QstashEnvelope<TBody>;
+} | null>;
+/**
+ * Publish a single-recipient message into a QStash FIFO queue.
+ * Returns message id or null if QStash is unavailable.
+ */
+export declare const publishFIFOQueueMessage: <TBody extends PublishBody>(options: PublishFIFOQueueMessageOptions<TBody>) => Promise<{
+    messageId: string | null;
+    message: QstashEnvelope<TBody>;
+} | null>;
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
  */

package/dist/lib/upstash/qstash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qstash.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/qstash.ts"],"names":[],"mappings":"AA8CA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAErF,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;CACb;AAiBD;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,KAAK,SAAS,WAAW,EAC5D,SAAS,qBAAqB,CAAC,KAAK,CAAC,KACpC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,IAAI,CAa7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAU,KAAK,SAAS,WAAW,EACnE,SAAS,qBAAqB,CAAC,KAAK,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAC3D,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,IAAI,CAc7E,CAAC;AAEF,MAAM,WAAW,sBAAsB,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW,CAC7E,SAAQ,qBAAqB,CAAC,KAAK,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAU,KAAK,SAAS,WAAW,EAC7D,SAAS,sBAAsB,CAAC,KAAK,CAAC,KACrC,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,IAAI,CAsB9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,OAAO,CAexE,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAU,SAAS,mBAAmB,KAAG,OAAO,CAAC,OAAO,CAqBzF,CAAC"}
+{"version":3,"file":"qstash.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/qstash.ts"],"names":[],"mappings":"AA8CA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAErF,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,8BAA8B,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,8BAA8B,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;CACb;AAiBD;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,KAAK,SAAS,WAAW,EAC5D,SAAS,qBAAqB,CAAC,KAAK,CAAC,KACpC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,IAAI,CAa7E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAU,KAAK,SAAS,WAAW,EACrE,SAAS,8BAA8B,CAAC,KAAK,CAAC,KAC7C,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,IAAI,CA0BzE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAU,KAAK,SAAS,WAAW,EACrE,SAAS,8BAA8B,CAAC,KAAK,CAAC,KAC7C,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,IAAI,CAqB7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAU,KAAK,SAAS,WAAW,EACnE,SAAS,qBAAqB,CAAC,KAAK,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAC3D,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,IAAI,CAc7E,CAAC;AAEF,MAAM,WAAW,sBAAsB,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW,CAC7E,SAAQ,qBAAqB,CAAC,KAAK,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAU,KAAK,SAAS,WAAW,EAC7D,SAAS,sBAAsB,CAAC,KAAK,CAAC,KACrC,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,IAAI,CAsB9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,OAAO,CAexE,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAU,SAAS,mBAAmB,KAAG,OAAO,CAAC,OAAO,CAqBzF,CAAC"}

package/dist/lib/upstash/qstash.js

@@ -69,6 +69,56 @@ const publishMessage = (options) => tslib.__awaiter(void 0, void 0, void 0, func
         };
     }));
 });
+/**
+ * Publish a broadcast message to a QStash URL Group.
+ * Returns message ids or null if QStash is unavailable.
+ */
+const publishBroadcastMessage = (options) => tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const message = createEnvelope(options.body);
+    return upstashConfig.withQstash((client) => tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const result = yield client.publishJSON({
+            urlGroup: options.urlGroup,
+            body: message,
+        });
+        const messageIds = Array.isArray(result)
+            ? result
+                .map((item) => typeof item === 'string' ? item : typeof (item === null || item === void 0 ? void 0 : item.messageId) === 'string' ? item.messageId : null)
+                .filter((messageId) => typeof messageId === 'string')
+            : typeof result === 'string'
+                ? [result]
+                : typeof (result === null || result === void 0 ? void 0 : result.messageId) === 'string'
+                    ? [result.messageId]
+                    : [];
+        return {
+            messageIds,
+            message,
+        };
+    }));
+});
+/**
+ * Publish a single-recipient message into a QStash FIFO queue.
+ * Returns message id or null if QStash is unavailable.
+ */
+const publishFIFOQueueMessage = (options) => tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const message = createEnvelope(options.body);
+    const queueName = upstashConfig.getPrefixedQstashQueueName(options.queueName);
+    return upstashConfig.withQstash((client) => tslib.__awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
+        const anyClient = client;
+        const queueClient = (_a = anyClient.queue) === null || _a === void 0 ? void 0 : _a.call(anyClient, { queueName });
+        if (!(queueClient === null || queueClient === void 0 ? void 0 : queueClient.enqueueJSON)) {
+            throw new Error('QStash queue enqueueJSON API is unavailable');
+        }
+        const result = yield queueClient.enqueueJSON({
+            url: options.url,
+            body: message,
+        });
+        return {
+            messageId: typeof result === 'string' ? result : (_b = result === null || result === void 0 ? void 0 : result.messageId) !== null && _b !== void 0 ? _b : null,
+            message,
+        };
+    }));
+});
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
  */
@@ -154,7 +204,9 @@ const verifyQstashSignature = (options) => tslib.__awaiter(void 0, void 0, void
 });
 
 exports.cancelSchedule = cancelSchedule;
+exports.publishBroadcastMessage = publishBroadcastMessage;
 exports.publishDelayedMessage = publishDelayedMessage;
+exports.publishFIFOQueueMessage = publishFIFOQueueMessage;
 exports.publishMessage = publishMessage;
 exports.scheduleMessage = scheduleMessage;
 exports.verifyQstashSignature = verifyQstashSignature;

package/dist/lib/upstash/qstash.mjs

@@ -1,6 +1,6 @@
 import { __awaiter } from 'tslib';
 import { Receiver } from '@upstash/qstash';
-import { withQstash } from '../upstash-config.mjs';
+import { withQstash, getPrefixedQstashQueueName } from '../upstash-config.mjs';
 
 let cachedReceiver = null;
 let receiverWarnedMissingEnv = false;
@@ -67,6 +67,56 @@ const publishMessage = (options) => __awaiter(void 0, void 0, void 0, function*
         };
     }));
 });
+/**
+ * Publish a broadcast message to a QStash URL Group.
+ * Returns message ids or null if QStash is unavailable.
+ */
+const publishBroadcastMessage = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const message = createEnvelope(options.body);
+    return withQstash((client) => __awaiter(void 0, void 0, void 0, function* () {
+        const result = yield client.publishJSON({
+            urlGroup: options.urlGroup,
+            body: message,
+        });
+        const messageIds = Array.isArray(result)
+            ? result
+                .map((item) => typeof item === 'string' ? item : typeof (item === null || item === void 0 ? void 0 : item.messageId) === 'string' ? item.messageId : null)
+                .filter((messageId) => typeof messageId === 'string')
+            : typeof result === 'string'
+                ? [result]
+                : typeof (result === null || result === void 0 ? void 0 : result.messageId) === 'string'
+                    ? [result.messageId]
+                    : [];
+        return {
+            messageIds,
+            message,
+        };
+    }));
+});
+/**
+ * Publish a single-recipient message into a QStash FIFO queue.
+ * Returns message id or null if QStash is unavailable.
+ */
+const publishFIFOQueueMessage = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const message = createEnvelope(options.body);
+    const queueName = getPrefixedQstashQueueName(options.queueName);
+    return withQstash((client) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
+        const anyClient = client;
+        const queueClient = (_a = anyClient.queue) === null || _a === void 0 ? void 0 : _a.call(anyClient, { queueName });
+        if (!(queueClient === null || queueClient === void 0 ? void 0 : queueClient.enqueueJSON)) {
+            throw new Error('QStash queue enqueueJSON API is unavailable');
+        }
+        const result = yield queueClient.enqueueJSON({
+            url: options.url,
+            body: message,
+        });
+        return {
+            messageId: typeof result === 'string' ? result : (_b = result === null || result === void 0 ? void 0 : result.messageId) !== null && _b !== void 0 ? _b : null,
+            message,
+        };
+    }));
+});
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
  */
@@ -151,4 +201,4 @@ const verifyQstashSignature = (options) => __awaiter(void 0, void 0, void 0, fun
     return true;
 });
 
-export { cancelSchedule, publishDelayedMessage, publishMessage, scheduleMessage, verifyQstashSignature };
+export { cancelSchedule, publishBroadcastMessage, publishDelayedMessage, publishFIFOQueueMessage, publishMessage, scheduleMessage, verifyQstashSignature };

package/dist/lib/upstash/redis-structures.d.ts

@@ -30,7 +30,7 @@ export declare const setJson: <T>(key: string, value: T, ttlSec?: number) => Pro
  */
 export declare const getJson: <T>(key: string) => Promise<T | null>;
 /**
- * MGET JSON values stored as strings. Missing or invalid values are returned as null.
+ * MGET JSON values. Missing or invalid string values are returned as null.
  */
 export declare const mgetJson: <T>(keys: string[]) => Promise<(T | null)[] | null>;
 /**

package/dist/lib/upstash/redis-structures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-structures.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/redis-structures.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"redis-structures.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/redis-structures.ts"],"names":[],"mappings":"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"}

package/dist/lib/upstash/redis-structures.js

@@ -3,6 +3,23 @@
 var tslib = require('tslib');
 var upstashConfig = require('../upstash-config.js');
 
+const parseJsonPayload = (payload) => {
+    if (payload == null) {
+        return null;
+    }
+    if (typeof payload === 'string') {
+        if (!payload) {
+            return null;
+        }
+        try {
+            return JSON.parse(payload);
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    return payload;
+};
 /**
  * Set a plain string value with optional TTL (seconds).
  */
@@ -66,19 +83,11 @@ const setJson = (key, value, ttlSec) => tslib.__awaiter(void 0, void 0, void 0,
 const getJson = (key) => tslib.__awaiter(void 0, void 0, void 0, function* () {
     return upstashConfig.withRedis((redis) => tslib.__awaiter(void 0, void 0, void 0, function* () {
         const payload = yield redis.get(key);
-        if (!payload) {
-            return null;
-        }
-        try {
-            return JSON.parse(payload);
-        }
-        catch (_a) {
-            return null;
-        }
+        return parseJsonPayload(payload);
     }));
 });
 /**
- * MGET JSON values stored as strings. Missing or invalid values are returned as null.
+ * MGET JSON values. Missing or invalid string values are returned as null.
  */
 const mgetJson = (keys) => tslib.__awaiter(void 0, void 0, void 0, function* () {
     return upstashConfig.withRedis((redis) => tslib.__awaiter(void 0, void 0, void 0, function* () {
@@ -86,17 +95,7 @@ const mgetJson = (keys) => tslib.__awaiter(void 0, void 0, void 0, function* ()
             return [];
         }
         const payloads = yield redis.mget(...keys);
-        return payloads.map((payload) => {
-            if (!payload) {
-                return null;
-            }
-            try {
-                return JSON.parse(payload);
-            }
-            catch (_a) {
-                return null;
-            }
-        });
+        return payloads.map((payload) => parseJsonPayload(payload));
     }));
 });
 /**

package/dist/lib/upstash/redis-structures.mjs

@@ -1,6 +1,23 @@
 import { __awaiter } from 'tslib';
 import { withRedis } from '../upstash-config.mjs';
 
+const parseJsonPayload = (payload) => {
+    if (payload == null) {
+        return null;
+    }
+    if (typeof payload === 'string') {
+        if (!payload) {
+            return null;
+        }
+        try {
+            return JSON.parse(payload);
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    return payload;
+};
 /**
  * Set a plain string value with optional TTL (seconds).
  */
@@ -64,19 +81,11 @@ const setJson = (key, value, ttlSec) => __awaiter(void 0, void 0, void 0, functi
 const getJson = (key) => __awaiter(void 0, void 0, void 0, function* () {
     return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
         const payload = yield redis.get(key);
-        if (!payload) {
-            return null;
-        }
-        try {
-            return JSON.parse(payload);
-        }
-        catch (_a) {
-            return null;
-        }
+        return parseJsonPayload(payload);
     }));
 });
 /**
- * MGET JSON values stored as strings. Missing or invalid values are returned as null.
+ * MGET JSON values. Missing or invalid string values are returned as null.
  */
 const mgetJson = (keys) => __awaiter(void 0, void 0, void 0, function* () {
     return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
@@ -84,17 +93,7 @@ const mgetJson = (keys) => __awaiter(void 0, void 0, void 0, function* () {
             return [];
         }
         const payloads = yield redis.mget(...keys);
-        return payloads.map((payload) => {
-            if (!payload) {
-                return null;
-            }
-            try {
-                return JSON.parse(payload);
-            }
-            catch (_a) {
-                return null;
-            }
-        });
+        return payloads.map((payload) => parseJsonPayload(payload));
     }));
 });
 /**

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

@@ -1,5 +1,9 @@
 import { Redis } from '@upstash/redis';
 import { Client as QstashClient } from '@upstash/qstash';
+export declare const getPrefixedRedisKey: (key: string) => string;
+export declare const getPrefixedRedisKeys: (keys: string[]) => string[];
+export declare const getQstashNamePrefix: () => string;
+export declare const getPrefixedQstashQueueName: (name: string) => string;
 /**
  * Get the Upstash Redis client. Returns null when required env vars are missing/invalid.
  *

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;AAwOzD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,QAAO,KAAK,GAAG,IAEnC,CAAC;AAwDF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAO,YAAY,GAAG,IAE3C,CAAC;AAyCF,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;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"}

package/dist/lib/upstash-config.js

@@ -45,7 +45,19 @@ const getRedisKeyPrefix = () => {
     const envSuffix = process.env.NODE_ENV === 'production' ? 'live' : 'test';
     return `${getRequiredRedisAppName()}_${envSuffix}`;
 };
-const prefixRedisKey = (prefix, key) => `${prefix}:${key}`;
+const buildPrefixedRedisKey = (prefix, key) => `${prefix}:${key}`;
+const getPrefixedRedisKey = (key) => buildPrefixedRedisKey(getRedisKeyPrefix(), key);
+const getPrefixedRedisKeys = (keys) => keys.map(getPrefixedRedisKey);
+const getQstashNamePrefix = () => {
+    return getRedisKeyPrefix();
+};
+const getPrefixedQstashQueueName = (name) => {
+    if (!isNonEmpty(name)) {
+        throw new Error('[Upstash QStash] queue name must not be empty');
+    }
+    return `${getQstashNamePrefix()}_queue_${name}`;
+};
+const prefixRedisKey = (prefix, key) => buildPrefixedRedisKey(prefix, key);
 const prefixRedisKeys = (prefix, keys) => keys.map((key) => prefixRedisKey(prefix, key));
 const prefixFirstStringArg = (args, prefix) => {
     if (typeof args[0] !== 'string') {
@@ -55,8 +67,16 @@ const prefixFirstStringArg = (args, prefix) => {
     nextArgs[0] = prefixRedisKey(prefix, args[0]);
     return nextArgs;
 };
-const prefixAllStringArgs = (args, prefix) => {
-    return args.map((arg) => (typeof arg === 'string' ? prefixRedisKey(prefix, arg) : arg));
+const prefixVariadicKeyArgs = (args, prefix) => {
+    return args.flatMap((arg) => {
+        if (typeof arg === 'string') {
+            return [prefixRedisKey(prefix, arg)];
+        }
+        if (Array.isArray(arg) && arg.every((key) => typeof key === 'string')) {
+            return prefixRedisKeys(prefix, arg);
+        }
+        return [arg];
+    });
 };
 const keyArrayCommands = new Set(['mget', 'del']);
 const allStringKeyCommands = new Set(['exists']);
@@ -77,11 +97,11 @@ const createPrefixedPipeline = (target, prefix) => {
                     return createPrefixedPipeline(nested, prefix);
                 }
                 if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
-                    const nextArgs = prefixAllStringArgs(args, prefix);
+                    const nextArgs = prefixVariadicKeyArgs(args, prefix);
                     return value.apply(obj, nextArgs);
                 }
                 if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
-                    const nextArgs = prefixAllStringArgs(args, prefix);
+                    const nextArgs = prefixVariadicKeyArgs(args, prefix);
                     return value.apply(obj, nextArgs);
                 }
                 if (prop === 'mset') {
@@ -111,7 +131,10 @@ const parseMinutes = (value, fallback) => {
 };
 const getRedisHealthIntervalMinutes = () => parseMinutes(process.env.UPSTASH_REDIS_HEALTHCHECK_INTERVAL_MINUTES, 10);
 const getQstashHealthIntervalMinutes = () => parseMinutes(process.env.UPSTASH_QSTASH_HEALTHCHECK_INTERVAL_MINUTES, 10);
-const getQstashHealthcheckUrl = () => { var _a; return (_a = process.env.UPSTASH_QSTASH_HEALTHCHECK_URL) !== null && _a !== void 0 ? _a : 'https://qstash.upstash.io/v2/topics'; };
+const getQstashHealthcheckUrl = () => {
+    const url = process.env.UPSTASH_QSTASH_HEALTHCHECK_URL;
+    return isNonEmpty(url) ? url : null;
+};
 const scheduleRedisHealthCheck = () => {
     if (redisHealthTimer || !cachedRedis) {
         return;
@@ -148,7 +171,11 @@ const scheduleRedisHealthCheck = () => {
     }), delayMs);
 };
 const checkQstashHealth = (token) => tslib.__awaiter(void 0, void 0, void 0, function* () {
-    const response = yield fetch(getQstashHealthcheckUrl(), {
+    const healthcheckUrl = getQstashHealthcheckUrl();
+    if (!healthcheckUrl) {
+        return;
+    }
+    const response = yield fetch(healthcheckUrl, {
         method: 'GET',
         headers: {
             Authorization: `Bearer ${token}`,
@@ -160,7 +187,7 @@ const checkQstashHealth = (token) => tslib.__awaiter(void 0, void 0, void 0, fun
     }
 });
 const scheduleQstashHealthCheck = (token) => {
-    if (qstashHealthTimer || !cachedQstash) {
+    if (qstashHealthTimer || !cachedQstash || !getQstashHealthcheckUrl()) {
         return;
     }
     const delayMs = getQstashHealthIntervalMinutes() * 60000;
@@ -173,7 +200,6 @@ const scheduleQstashHealthCheck = (token) => {
             yield checkQstashHealth(token);
         }
         catch (error) {
-            cachedQstash = null;
             if (!qstashWarnedHealthCheck) {
                 qstashWarnedHealthCheck = true;
                 const message = error instanceof Error ? error.message : String(error);
@@ -279,8 +305,14 @@ const ensureQstash = () => tslib.__awaiter(void 0, void 0, void 0, function* ()
         }
         try {
             const client = new qstash.Client({ token: QSTASH_TOKEN });
-            yield checkQstashHealth(QSTASH_TOKEN);
             cachedQstash = client;
+            checkQstashHealth(QSTASH_TOKEN).catch((error) => {
+                if (!qstashWarnedHealthCheck) {
+                    qstashWarnedHealthCheck = true;
+                    const message = error instanceof Error ? error.message : String(error);
+                    console.warn(`[Upstash Config] QStash health check failed: ${message}`);
+                }
+            });
             scheduleQstashHealthCheck(QSTASH_TOKEN);
             return cachedQstash;
         }
@@ -313,7 +345,11 @@ const withQstash = (fn) => tslib.__awaiter(void 0, void 0, void 0, function* ()
     return fn(qstash);
 });
 
+exports.getPrefixedQstashQueueName = getPrefixedQstashQueueName;
+exports.getPrefixedRedisKey = getPrefixedRedisKey;
+exports.getPrefixedRedisKeys = getPrefixedRedisKeys;
 exports.getQstash = getQstash;
+exports.getQstashNamePrefix = getQstashNamePrefix;
 exports.getRedis = getRedis;
 exports.withQstash = withQstash;
 exports.withRedis = withRedis;

package/dist/lib/upstash-config.mjs

@@ -43,7 +43,19 @@ const getRedisKeyPrefix = () => {
     const envSuffix = process.env.NODE_ENV === 'production' ? 'live' : 'test';
     return `${getRequiredRedisAppName()}_${envSuffix}`;
 };
-const prefixRedisKey = (prefix, key) => `${prefix}:${key}`;
+const buildPrefixedRedisKey = (prefix, key) => `${prefix}:${key}`;
+const getPrefixedRedisKey = (key) => buildPrefixedRedisKey(getRedisKeyPrefix(), key);
+const getPrefixedRedisKeys = (keys) => keys.map(getPrefixedRedisKey);
+const getQstashNamePrefix = () => {
+    return getRedisKeyPrefix();
+};
+const getPrefixedQstashQueueName = (name) => {
+    if (!isNonEmpty(name)) {
+        throw new Error('[Upstash QStash] queue name must not be empty');
+    }
+    return `${getQstashNamePrefix()}_queue_${name}`;
+};
+const prefixRedisKey = (prefix, key) => buildPrefixedRedisKey(prefix, key);
 const prefixRedisKeys = (prefix, keys) => keys.map((key) => prefixRedisKey(prefix, key));
 const prefixFirstStringArg = (args, prefix) => {
     if (typeof args[0] !== 'string') {
@@ -53,8 +65,16 @@ const prefixFirstStringArg = (args, prefix) => {
     nextArgs[0] = prefixRedisKey(prefix, args[0]);
     return nextArgs;
 };
-const prefixAllStringArgs = (args, prefix) => {
-    return args.map((arg) => (typeof arg === 'string' ? prefixRedisKey(prefix, arg) : arg));
+const prefixVariadicKeyArgs = (args, prefix) => {
+    return args.flatMap((arg) => {
+        if (typeof arg === 'string') {
+            return [prefixRedisKey(prefix, arg)];
+        }
+        if (Array.isArray(arg) && arg.every((key) => typeof key === 'string')) {
+            return prefixRedisKeys(prefix, arg);
+        }
+        return [arg];
+    });
 };
 const keyArrayCommands = new Set(['mget', 'del']);
 const allStringKeyCommands = new Set(['exists']);
@@ -75,11 +95,11 @@ const createPrefixedPipeline = (target, prefix) => {
                     return createPrefixedPipeline(nested, prefix);
                 }
                 if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
-                    const nextArgs = prefixAllStringArgs(args, prefix);
+                    const nextArgs = prefixVariadicKeyArgs(args, prefix);
                     return value.apply(obj, nextArgs);
                 }
                 if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
-                    const nextArgs = prefixAllStringArgs(args, prefix);
+                    const nextArgs = prefixVariadicKeyArgs(args, prefix);
                     return value.apply(obj, nextArgs);
                 }
                 if (prop === 'mset') {
@@ -109,7 +129,10 @@ const parseMinutes = (value, fallback) => {
 };
 const getRedisHealthIntervalMinutes = () => parseMinutes(process.env.UPSTASH_REDIS_HEALTHCHECK_INTERVAL_MINUTES, 10);
 const getQstashHealthIntervalMinutes = () => parseMinutes(process.env.UPSTASH_QSTASH_HEALTHCHECK_INTERVAL_MINUTES, 10);
-const getQstashHealthcheckUrl = () => { var _a; return (_a = process.env.UPSTASH_QSTASH_HEALTHCHECK_URL) !== null && _a !== void 0 ? _a : 'https://qstash.upstash.io/v2/topics'; };
+const getQstashHealthcheckUrl = () => {
+    const url = process.env.UPSTASH_QSTASH_HEALTHCHECK_URL;
+    return isNonEmpty(url) ? url : null;
+};
 const scheduleRedisHealthCheck = () => {
     if (redisHealthTimer || !cachedRedis) {
         return;
@@ -146,7 +169,11 @@ const scheduleRedisHealthCheck = () => {
     }), delayMs);
 };
 const checkQstashHealth = (token) => __awaiter(void 0, void 0, void 0, function* () {
-    const response = yield fetch(getQstashHealthcheckUrl(), {
+    const healthcheckUrl = getQstashHealthcheckUrl();
+    if (!healthcheckUrl) {
+        return;
+    }
+    const response = yield fetch(healthcheckUrl, {
         method: 'GET',
         headers: {
             Authorization: `Bearer ${token}`,
@@ -158,7 +185,7 @@ const checkQstashHealth = (token) => __awaiter(void 0, void 0, void 0, function*
     }
 });
 const scheduleQstashHealthCheck = (token) => {
-    if (qstashHealthTimer || !cachedQstash) {
+    if (qstashHealthTimer || !cachedQstash || !getQstashHealthcheckUrl()) {
         return;
     }
     const delayMs = getQstashHealthIntervalMinutes() * 60000;
@@ -171,7 +198,6 @@ const scheduleQstashHealthCheck = (token) => {
             yield checkQstashHealth(token);
         }
         catch (error) {
-            cachedQstash = null;
             if (!qstashWarnedHealthCheck) {
                 qstashWarnedHealthCheck = true;
                 const message = error instanceof Error ? error.message : String(error);
@@ -277,8 +303,14 @@ const ensureQstash = () => __awaiter(void 0, void 0, void 0, function* () {
         }
         try {
             const client = new Client({ token: QSTASH_TOKEN });
-            yield checkQstashHealth(QSTASH_TOKEN);
             cachedQstash = client;
+            checkQstashHealth(QSTASH_TOKEN).catch((error) => {
+                if (!qstashWarnedHealthCheck) {
+                    qstashWarnedHealthCheck = true;
+                    const message = error instanceof Error ? error.message : String(error);
+                    console.warn(`[Upstash Config] QStash health check failed: ${message}`);
+                }
+            });
             scheduleQstashHealthCheck(QSTASH_TOKEN);
             return cachedQstash;
         }
@@ -311,4 +343,4 @@ const withQstash = (fn) => __awaiter(void 0, void 0, void 0, function* () {
     return fn(qstash);
 });
 
-export { getQstash, getRedis, withQstash, withRedis };
+export { getPrefixedQstashQueueName, getPrefixedRedisKey, getPrefixedRedisKeys, getQstash, getQstashNamePrefix, getRedis, withQstash, withRedis };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "20.0.0",
+  "version": "20.1.0",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",

package/src/lib/upstash/qstash.ts

@@ -1,5 +1,5 @@
 import { Receiver } from '@upstash/qstash';
-import { withQstash } from '../upstash-config';
+import { getPrefixedQstashQueueName, withQstash } from '../upstash-config';
 
 let cachedReceiver: Receiver | null = null;
 let receiverWarnedMissingEnv = false;
@@ -56,6 +56,17 @@ export interface PublishMessageOptions<TBody extends PublishBody = PublishBody>
   body: TBody;
 }
 
+export interface PublishBroadcastMessageOptions<TBody extends PublishBody = PublishBody> {
+  urlGroup: string;
+  body: TBody;
+}
+
+export interface PublishFIFOQueueMessageOptions<TBody extends PublishBody = PublishBody> {
+  queueName: string;
+  url: string;
+  body: TBody;
+}
+
 const generateSourceMessageId = (): string => {
   try {
     return crypto.randomUUID();
@@ -91,6 +102,69 @@ export const publishMessage = async <TBody extends PublishBody>(
   });
 };
 
+/**
+ * Publish a broadcast message to a QStash URL Group.
+ * Returns message ids or null if QStash is unavailable.
+ */
+export const publishBroadcastMessage = async <TBody extends PublishBody>(
+  options: PublishBroadcastMessageOptions<TBody>
+): Promise<{ messageIds: string[]; message: QstashEnvelope<TBody> } | null> => {
+  const message = createEnvelope(options.body);
+
+  return withQstash(async (client) => {
+    const result = await (client as any).publishJSON({
+      urlGroup: options.urlGroup,
+      body: message,
+    });
+
+    const messageIds = Array.isArray(result)
+      ? result
+          .map((item) =>
+            typeof item === 'string' ? item : typeof item?.messageId === 'string' ? item.messageId : null
+          )
+          .filter((messageId): messageId is string => typeof messageId === 'string')
+      : typeof result === 'string'
+        ? [result]
+        : typeof result?.messageId === 'string'
+          ? [result.messageId]
+          : [];
+
+    return {
+      messageIds,
+      message,
+    };
+  });
+};
+
+/**
+ * Publish a single-recipient message into a QStash FIFO queue.
+ * Returns message id or null if QStash is unavailable.
+ */
+export const publishFIFOQueueMessage = async <TBody extends PublishBody>(
+  options: PublishFIFOQueueMessageOptions<TBody>
+): Promise<{ messageId: string | null; message: QstashEnvelope<TBody> } | null> => {
+  const message = createEnvelope(options.body);
+  const queueName = getPrefixedQstashQueueName(options.queueName);
+
+  return withQstash(async (client) => {
+    const anyClient = client as any;
+    const queueClient = anyClient.queue?.({ queueName });
+    if (!queueClient?.enqueueJSON) {
+      throw new Error('QStash queue enqueueJSON API is unavailable');
+    }
+
+    const result = await queueClient.enqueueJSON({
+      url: options.url,
+      body: message,
+    });
+
+    return {
+      messageId: typeof result === 'string' ? result : result?.messageId ?? null,
+      message,
+    };
+  });
+};
+
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
  */

package/src/lib/upstash/redis-structures.ts

@@ -9,6 +9,26 @@ export type RedisPipelineBuilder<TResult> = (pipeline: ReturnType<Redis['pipelin
   exec: () => Promise<TResult>;
 };
 
+const parseJsonPayload = <T>(payload: unknown): T | null => {
+  if (payload == null) {
+    return null;
+  }
+
+  if (typeof payload === 'string') {
+    if (!payload) {
+      return null;
+    }
+
+    try {
+      return JSON.parse(payload) as T;
+    } catch {
+      return null;
+    }
+  }
+
+  return payload as T;
+};
+
 /**
  * Set a plain string value with optional TTL (seconds).
  */
@@ -88,21 +108,13 @@ export const setJson = async <T>(
  */
 export const getJson = async <T>(key: string): Promise<T | null> => {
   return withRedis(async (redis) => {
-    const payload = await redis.get<string>(key);
-    if (!payload) {
-      return null;
-    }
-
-    try {
-      return JSON.parse(payload) as T;
-    } catch {
-      return null;
-    }
+    const payload = await redis.get<unknown>(key);
+    return parseJsonPayload<T>(payload);
   });
 };
 
 /**
- * MGET JSON values stored as strings. Missing or invalid values are returned as null.
+ * MGET JSON values. Missing or invalid string values are returned as null.
  */
 export const mgetJson = async <T>(keys: string[]): Promise<(T | null)[] | null> => {
   return withRedis(async (redis) => {
@@ -110,18 +122,8 @@ export const mgetJson = async <T>(keys: string[]): Promise<(T | null)[] | null>
       return [];
     }
 
-    const payloads = await redis.mget<(string | null)[]>(...keys);
-    return payloads.map((payload) => {
-      if (!payload) {
-        return null;
-      }
-
-      try {
-        return JSON.parse(payload) as T;
-      } catch {
-        return null;
-      }
-    });
+    const payloads = await redis.mget<unknown[]>(...keys);
+    return payloads.map((payload) => parseJsonPayload<T>(payload));
   });
 };
 

package/src/lib/upstash-config.ts

@@ -56,7 +56,25 @@ const getRedisKeyPrefix = (): string => {
   return `${getRequiredRedisAppName()}_${envSuffix}`;
 };
 
-const prefixRedisKey = (prefix: string, key: string): string => `${prefix}:${key}`;
+const buildPrefixedRedisKey = (prefix: string, key: string): string => `${prefix}:${key}`;
+
+export const getPrefixedRedisKey = (key: string): string => buildPrefixedRedisKey(getRedisKeyPrefix(), key);
+
+export const getPrefixedRedisKeys = (keys: string[]): string[] => keys.map(getPrefixedRedisKey);
+
+export const getQstashNamePrefix = (): string => {
+  return getRedisKeyPrefix();
+};
+
+export const getPrefixedQstashQueueName = (name: string): string => {
+  if (!isNonEmpty(name)) {
+    throw new Error('[Upstash QStash] queue name must not be empty');
+  }
+
+  return `${getQstashNamePrefix()}_queue_${name}`;
+};
+
+const prefixRedisKey = (prefix: string, key: string): string => buildPrefixedRedisKey(prefix, key);
 
 const prefixRedisKeys = (prefix: string, keys: string[]): string[] =>
   keys.map((key) => prefixRedisKey(prefix, key));
@@ -71,8 +89,18 @@ const prefixFirstStringArg = (args: unknown[], prefix: string): unknown[] => {
   return nextArgs;
 };
 
-const prefixAllStringArgs = (args: unknown[], prefix: string): unknown[] => {
-  return args.map((arg) => (typeof arg === 'string' ? prefixRedisKey(prefix, arg) : arg));
+const prefixVariadicKeyArgs = (args: unknown[], prefix: string): unknown[] => {
+  return args.flatMap((arg) => {
+    if (typeof arg === 'string') {
+      return [prefixRedisKey(prefix, arg)];
+    }
+
+    if (Array.isArray(arg) && arg.every((key) => typeof key === 'string')) {
+      return prefixRedisKeys(prefix, arg);
+    }
+
+    return [arg];
+  });
 };
 
 const keyArrayCommands = new Set(['mget', 'del']);
@@ -103,12 +131,12 @@ const createPrefixedPipeline = <T extends object>(target: T, prefix: string): T
         }
 
         if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
-          const nextArgs = prefixAllStringArgs(args, prefix);
+          const nextArgs = prefixVariadicKeyArgs(args, prefix);
           return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
         }
 
         if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
-          const nextArgs = prefixAllStringArgs(args, prefix);
+          const nextArgs = prefixVariadicKeyArgs(args, prefix);
           return (value as (...innerArgs: unknown[]) => unknown).apply(obj, nextArgs);
         }
 
@@ -149,8 +177,10 @@ const getRedisHealthIntervalMinutes = (): number =>
 const getQstashHealthIntervalMinutes = (): number =>
   parseMinutes(process.env.UPSTASH_QSTASH_HEALTHCHECK_INTERVAL_MINUTES, 10);
 
-const getQstashHealthcheckUrl = (): string =>
-  process.env.UPSTASH_QSTASH_HEALTHCHECK_URL ?? 'https://qstash.upstash.io/v2/topics';
+const getQstashHealthcheckUrl = (): string | null => {
+  const url = process.env.UPSTASH_QSTASH_HEALTHCHECK_URL;
+  return isNonEmpty(url) ? url : null;
+};
 
 const scheduleRedisHealthCheck = (): void => {
   if (redisHealthTimer || !cachedRedis) {
@@ -186,7 +216,12 @@ const scheduleRedisHealthCheck = (): void => {
 };
 
 const checkQstashHealth = async (token: string): Promise<void> => {
-  const response = await fetch(getQstashHealthcheckUrl(), {
+  const healthcheckUrl = getQstashHealthcheckUrl();
+  if (!healthcheckUrl) {
+    return;
+  }
+
+  const response = await fetch(healthcheckUrl, {
     method: 'GET',
     headers: {
       Authorization: `Bearer ${token}`,
@@ -199,7 +234,7 @@ const checkQstashHealth = async (token: string): Promise<void> => {
 };
 
 const scheduleQstashHealthCheck = (token: string): void => {
-  if (qstashHealthTimer || !cachedQstash) {
+  if (qstashHealthTimer || !cachedQstash || !getQstashHealthcheckUrl()) {
     return;
   }
   const delayMs = getQstashHealthIntervalMinutes() * 60_000;
@@ -211,7 +246,6 @@ const scheduleQstashHealthCheck = (token: string): void => {
     try {
       await checkQstashHealth(token);
     } catch (error) {
-      cachedQstash = null;
       if (!qstashWarnedHealthCheck) {
         qstashWarnedHealthCheck = true;
         const message = error instanceof Error ? error.message : String(error);
@@ -325,8 +359,14 @@ const ensureQstash = async (): Promise<QstashClient | null> => {
 
     try {
       const client = new QstashClient({ token: QSTASH_TOKEN });
-      await checkQstashHealth(QSTASH_TOKEN);
       cachedQstash = client;
+      checkQstashHealth(QSTASH_TOKEN).catch((error) => {
+        if (!qstashWarnedHealthCheck) {
+          qstashWarnedHealthCheck = true;
+          const message = error instanceof Error ? error.message : String(error);
+          console.warn(`[Upstash Config] QStash health check failed: ${message}`);
+        }
+      });
       scheduleQstashHealthCheck(QSTASH_TOKEN);
       return cachedQstash;
     } catch (error) {