@windrun-huaiin/backend-core 15.1.0 → 16.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 D8ger
+Copyright (c) 2026 D8ger
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.d.ts

@@ -3,5 +3,6 @@ export * from './services/database';
 export * from './services/aggregate';
 export * from './services/context';
 export * from './services/stripe';
+export * from './services/ai';
 export * from './lib';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC"}

package/dist/index.js

@@ -16,6 +16,13 @@ var anonymous_aggregate_service = require('./services/aggregate/anonymous.aggreg
 var userContextService = require('./services/context/user-context-service.js');
 var userContextFinalizer = require('./services/context/user-context-finalizer.js');
 var webhookHandler = require('./services/stripe/webhook-handler.js');
+var abort = require('./services/ai/abort.js');
+var error = require('./services/ai/error.js');
+var env = require('./services/ai/env.js');
+var messageBuilder = require('./services/ai/message-builder.js');
+var mock = require('./services/ai/mock.js');
+var openrouterClient = require('./services/ai/openrouter-client.js');
+var route = require('./services/ai/route.js');
 var moneyPriceConfig = require('./lib/money-price-config.js');
 var moneyPriceHelper = require('./lib/money-price-helper.js');
 var fingerprintConfig = require('./lib/fingerprint-config.js');
@@ -70,6 +77,24 @@ exports.mapSubscriptionToXSubscription = userContextService.mapSubscriptionToXSu
 exports.mapUserToXUser = userContextService.mapUserToXUser;
 exports.finalizeUserContext = userContextFinalizer.finalizeUserContext;
 exports.handleStripeEvent = webhookHandler.handleStripeEvent;
+exports.createUpstreamAbortSignal = abort.createUpstreamAbortSignal;
+exports.normalizeAIError = error.normalizeAIError;
+exports.createOpenRouterClientConfigFromEnv = env.createOpenRouterClientConfigFromEnv;
+exports.createOpenRouterMockFromEnv = env.createOpenRouterMockFromEnv;
+exports.createOpenRouterMockFromEnvForContext = env.createOpenRouterMockFromEnvForContext;
+exports.getOpenRouterEnvConfig = env.getOpenRouterEnvConfig;
+exports.buildModelMessages = messageBuilder.buildModelMessages;
+exports.createConfigurableMockHandler = mock.createConfigurableMockHandler;
+exports.createErrorMockResponse = mock.createErrorMockResponse;
+exports.createScenarioMockHandler = mock.createScenarioMockHandler;
+exports.createSimpleMockHandler = mock.createSimpleMockHandler;
+exports.getMockScenario = mock.getMockScenario;
+exports.callOpenRouterStream = openrouterClient.callOpenRouterStream;
+exports.guardedOpenRouterStreamStart = openrouterClient.guardedOpenRouterStreamStart;
+exports.createOpenRouterRoute = route.createOpenRouterRoute;
+exports.dynamic = route.dynamic;
+exports.revalidate = route.revalidate;
+exports.runtime = route.runtime;
 exports.getActiveProviderConfig = moneyPriceConfig.getActiveProviderConfig;
 exports.getCreditsFromPriceId = moneyPriceConfig.getCreditsFromPriceId;
 exports.getPriceConfig = moneyPriceConfig.getPriceConfig;
@@ -111,21 +136,40 @@ exports.getCounter = redisCounter.getCounter;
 exports.getUniqueCounter = redisCounter.getUniqueCounter;
 exports.incrCounter = redisCounter.incrCounter;
 exports.incrUniqueCounter = redisCounter.incrUniqueCounter;
+exports.del = redisStructures.del;
 exports.deleteHashField = redisStructures.deleteHashField;
 exports.deleteKey = redisStructures.deleteKey;
+exports.exists = redisStructures.exists;
+exports.expire = redisStructures.expire;
 exports.getHashAll = redisStructures.getHashAll;
 exports.getHashField = redisStructures.getHashField;
 exports.getHashJson = redisStructures.getHashJson;
 exports.getJson = redisStructures.getJson;
 exports.getString = redisStructures.getString;
+exports.hexists = redisStructures.hexists;
+exports.hkeys = redisStructures.hkeys;
+exports.hlen = redisStructures.hlen;
+exports.hmget = redisStructures.hmget;
+exports.hmset = redisStructures.hmset;
 exports.listLength = redisStructures.listLength;
+exports.mget = redisStructures.mget;
+exports.mgetJson = redisStructures.mgetJson;
+exports.mset = redisStructures.mset;
+exports.msetJson = redisStructures.msetJson;
+exports.pipeline = redisStructures.pipeline;
 exports.popList = redisStructures.popList;
 exports.pushList = redisStructures.pushList;
 exports.rangeList = redisStructures.rangeList;
+exports.sadd = redisStructures.sadd;
+exports.scard = redisStructures.scard;
 exports.setHashField = redisStructures.setHashField;
 exports.setHashJson = redisStructures.setHashJson;
 exports.setJson = redisStructures.setJson;
 exports.setString = redisStructures.setString;
+exports.sismember = redisStructures.sismember;
+exports.smembers = redisStructures.smembers;
+exports.srem = redisStructures.srem;
+exports.ttl = redisStructures.ttl;
 exports.cancelSchedule = qstash.cancelSchedule;
 exports.publishDelayedMessage = qstash.publishDelayedMessage;
 exports.publishMessage = qstash.publishMessage;

package/dist/index.mjs

@@ -14,6 +14,13 @@ export { anonymousAggregateService } from './services/aggregate/anonymous.aggreg
 export { buildInitUserContextFromEntities, fetchLatestUserContextByFingerprintId, fetchUserContextByClerkUserId, mapCreditToXCredit, mapSubscriptionToXSubscription, mapUserToXUser } from './services/context/user-context-service.mjs';
 export { finalizeUserContext } from './services/context/user-context-finalizer.mjs';
 export { handleStripeEvent } from './services/stripe/webhook-handler.mjs';
+export { createUpstreamAbortSignal } from './services/ai/abort.mjs';
+export { normalizeAIError } from './services/ai/error.mjs';
+export { createOpenRouterClientConfigFromEnv, createOpenRouterMockFromEnv, createOpenRouterMockFromEnvForContext, getOpenRouterEnvConfig } from './services/ai/env.mjs';
+export { buildModelMessages } from './services/ai/message-builder.mjs';
+export { createConfigurableMockHandler, createErrorMockResponse, createScenarioMockHandler, createSimpleMockHandler, getMockScenario } from './services/ai/mock.mjs';
+export { callOpenRouterStream, guardedOpenRouterStreamStart } from './services/ai/openrouter-client.mjs';
+export { createOpenRouterRoute, dynamic, revalidate, runtime } from './services/ai/route.mjs';
 export { getActiveProviderConfig, getCreditsFromPriceId, getPriceConfig, moneyPriceConfig } from './lib/money-price-config.mjs';
 export { getMoneyPriceInitUserContext } from './lib/money-price-helper.mjs';
 export { fingerprintConfig } from './lib/fingerprint-config.mjs';
@@ -24,5 +31,5 @@ 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 { deleteHashField, deleteKey, getHashAll, getHashField, getHashJson, getJson, getString, listLength, popList, pushList, rangeList, setHashField, setHashJson, setJson, setString } from './lib/upstash/redis-structures.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';

package/dist/lib/index.js

@@ -56,21 +56,40 @@ exports.getCounter = redisCounter.getCounter;
 exports.getUniqueCounter = redisCounter.getUniqueCounter;
 exports.incrCounter = redisCounter.incrCounter;
 exports.incrUniqueCounter = redisCounter.incrUniqueCounter;
+exports.del = redisStructures.del;
 exports.deleteHashField = redisStructures.deleteHashField;
 exports.deleteKey = redisStructures.deleteKey;
+exports.exists = redisStructures.exists;
+exports.expire = redisStructures.expire;
 exports.getHashAll = redisStructures.getHashAll;
 exports.getHashField = redisStructures.getHashField;
 exports.getHashJson = redisStructures.getHashJson;
 exports.getJson = redisStructures.getJson;
 exports.getString = redisStructures.getString;
+exports.hexists = redisStructures.hexists;
+exports.hkeys = redisStructures.hkeys;
+exports.hlen = redisStructures.hlen;
+exports.hmget = redisStructures.hmget;
+exports.hmset = redisStructures.hmset;
 exports.listLength = redisStructures.listLength;
+exports.mget = redisStructures.mget;
+exports.mgetJson = redisStructures.mgetJson;
+exports.mset = redisStructures.mset;
+exports.msetJson = redisStructures.msetJson;
+exports.pipeline = redisStructures.pipeline;
 exports.popList = redisStructures.popList;
 exports.pushList = redisStructures.pushList;
 exports.rangeList = redisStructures.rangeList;
+exports.sadd = redisStructures.sadd;
+exports.scard = redisStructures.scard;
 exports.setHashField = redisStructures.setHashField;
 exports.setHashJson = redisStructures.setHashJson;
 exports.setJson = redisStructures.setJson;
 exports.setString = redisStructures.setString;
+exports.sismember = redisStructures.sismember;
+exports.smembers = redisStructures.smembers;
+exports.srem = redisStructures.srem;
+exports.ttl = redisStructures.ttl;
 exports.cancelSchedule = qstash.cancelSchedule;
 exports.publishDelayedMessage = qstash.publishDelayedMessage;
 exports.publishMessage = qstash.publishMessage;

package/dist/lib/index.mjs

@@ -8,5 +8,5 @@ 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 { deleteHashField, deleteKey, getHashAll, getHashField, getHashJson, getJson, getString, listLength, popList, pushList, rangeList, setHashField, setHashJson, setJson, setString } from './upstash/redis-structures.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';

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

@@ -1,25 +1,38 @@
 export type PublishBody = Record<string, unknown> | string | number | boolean | null;
-export interface PublishMessageOptions {
+export interface QstashEnvelope<TBody extends PublishBody = PublishBody> {
+    source_msg_id: string;
+    payload: TBody;
+}
+export interface PublishMessageOptions<TBody extends PublishBody = PublishBody> {
     url: string;
-    body: PublishBody;
+    body: TBody;
 }
 /**
  * Publish a message. Returns message id or null if QStash is unavailable.
  */
-export declare const publishMessage: (options: PublishMessageOptions) => Promise<string | null>;
+export declare const publishMessage: <TBody extends PublishBody>(options: PublishMessageOptions<TBody>) => Promise<{
+    messageId: string | null;
+    message: QstashEnvelope<TBody>;
+} | null>;
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
  */
-export declare const publishDelayedMessage: (options: PublishMessageOptions & {
+export declare const publishDelayedMessage: <TBody extends PublishBody>(options: PublishMessageOptions<TBody> & {
     delaySec: number;
-}) => Promise<string | null>;
-export interface ScheduleMessageOptions extends PublishMessageOptions {
+}) => Promise<{
+    messageId: string | null;
+    message: QstashEnvelope<TBody>;
+} | null>;
+export interface ScheduleMessageOptions<TBody extends PublishBody = PublishBody> extends PublishMessageOptions<TBody> {
     cron: string;
 }
 /**
  * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
  */
-export declare const scheduleMessage: (options: ScheduleMessageOptions) => Promise<string | null>;
+export declare const scheduleMessage: <TBody extends PublishBody>(options: ScheduleMessageOptions<TBody>) => Promise<{
+    scheduleId: string | null;
+    message: QstashEnvelope<TBody>;
+} | null>;
 /**
  * Cancel a scheduled message. Returns false 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,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,qBAAqB,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAQ1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,qBAAqB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KACpD,OAAO,CAAC,MAAM,GAAG,IAAI,CASvB,CAAC;AAEF,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,sBAAsB,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAiB5F,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;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"}

package/dist/lib/upstash/qstash.js

@@ -38,50 +38,76 @@ const getReceiver = () => {
         return null;
     }
 };
+const generateSourceMessageId = () => {
+    try {
+        return crypto.randomUUID();
+    }
+    catch (_a) {
+        return `${Date.now()}_${Math.random().toString(16).slice(2)}`;
+    }
+};
+const createEnvelope = (body) => {
+    return {
+        source_msg_id: generateSourceMessageId(),
+        payload: body,
+    };
+};
 /**
  * Publish a message. Returns message id or null if QStash is unavailable.
  */
 const publishMessage = (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* () {
         var _a;
         const result = yield client.publishJSON({
             url: options.url,
-            body: options.body,
+            body: message,
         });
-        return typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null;
+        return {
+            messageId: typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null,
+            message,
+        };
     }));
 });
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
  */
 const publishDelayedMessage = (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* () {
         var _a;
         const result = yield client.publishJSON({
             url: options.url,
-            body: options.body,
+            body: message,
             delay: options.delaySec,
         });
-        return typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null;
+        return {
+            messageId: typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null,
+            message,
+        };
     }));
 });
 /**
  * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
  */
 const scheduleMessage = (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* () {
         var _a, _b, _c, _d, _e, _f;
         const anyClient = client;
         const result = (_c = (yield ((_b = (_a = anyClient.schedules) === null || _a === void 0 ? void 0 : _a.create) === null || _b === void 0 ? void 0 : _b.call(_a, {
             url: options.url,
-            body: options.body,
+            body: message,
             cron: options.cron,
         })))) !== null && _c !== void 0 ? _c : (yield ((_d = anyClient.publishJSON) === null || _d === void 0 ? void 0 : _d.call(anyClient, {
             url: options.url,
-            body: options.body,
+            body: message,
             cron: options.cron,
         })));
-        return 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;
+        return {
+            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,
+        };
     }));
 });
 /**

package/dist/lib/upstash/qstash.mjs

@@ -36,50 +36,76 @@ const getReceiver = () => {
         return null;
     }
 };
+const generateSourceMessageId = () => {
+    try {
+        return crypto.randomUUID();
+    }
+    catch (_a) {
+        return `${Date.now()}_${Math.random().toString(16).slice(2)}`;
+    }
+};
+const createEnvelope = (body) => {
+    return {
+        source_msg_id: generateSourceMessageId(),
+        payload: body,
+    };
+};
 /**
  * Publish a message. Returns message id or null if QStash is unavailable.
  */
 const publishMessage = (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* () {
         var _a;
         const result = yield client.publishJSON({
             url: options.url,
-            body: options.body,
+            body: message,
         });
-        return typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null;
+        return {
+            messageId: typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null,
+            message,
+        };
     }));
 });
 /**
  * Publish a delayed message. Returns message id or null if QStash is unavailable.
  */
 const publishDelayedMessage = (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* () {
         var _a;
         const result = yield client.publishJSON({
             url: options.url,
-            body: options.body,
+            body: message,
             delay: options.delaySec,
         });
-        return typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null;
+        return {
+            messageId: typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null,
+            message,
+        };
     }));
 });
 /**
  * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
  */
 const scheduleMessage = (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* () {
         var _a, _b, _c, _d, _e, _f;
         const anyClient = client;
         const result = (_c = (yield ((_b = (_a = anyClient.schedules) === null || _a === void 0 ? void 0 : _a.create) === null || _b === void 0 ? void 0 : _b.call(_a, {
             url: options.url,
-            body: options.body,
+            body: message,
             cron: options.cron,
         })))) !== null && _c !== void 0 ? _c : (yield ((_d = anyClient.publishJSON) === null || _d === void 0 ? void 0 : _d.call(anyClient, {
             url: options.url,
-            body: options.body,
+            body: message,
             cron: options.cron,
         })));
-        return 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;
+        return {
+            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,
+        };
     }));
 });
 /**

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

@@ -1,3 +1,10 @@
+import type { Redis } from '@upstash/redis';
+export type RedisStringKeyValue = Record<string, string>;
+export type RedisJsonKeyValue<T> = Record<string, T>;
+export type RedisHashStringValue = Record<string, string>;
+export type RedisPipelineBuilder<TResult> = (pipeline: ReturnType<Redis['pipeline']>) => {
+    exec: () => Promise<TResult>;
+};
 /**
  * Set a plain string value with optional TTL (seconds).
  */
@@ -6,6 +13,14 @@ export declare const setString: (key: string, value: string, ttlSec?: number) =>
  * Get a plain string value. Returns null if Redis is unavailable or key missing.
  */
 export declare const getString: (key: string) => Promise<string | null>;
+/**
+ * MGET plain string values. Missing keys are returned as null.
+ */
+export declare const mget: (keys: string[]) => Promise<(string | null)[] | null>;
+/**
+ * MSET plain string values.
+ */
+export declare const mset: (entries: RedisStringKeyValue) => Promise<boolean>;
 /**
  * Store an object as JSON string with optional TTL (seconds).
  */
@@ -14,10 +29,34 @@ export declare const setJson: <T>(key: string, value: T, ttlSec?: number) => Pro
  * Get an object stored as JSON string. Returns null if missing or invalid JSON.
  */
 export declare const getJson: <T>(key: string) => Promise<T | null>;
+/**
+ * MGET JSON values stored as strings. Missing or invalid values are returned as null.
+ */
+export declare const mgetJson: <T>(keys: string[]) => Promise<(T | null)[] | null>;
+/**
+ * MSET JSON values as strings.
+ */
+export declare const msetJson: <T>(entries: RedisJsonKeyValue<T>) => Promise<boolean>;
 /**
  * Delete a key. Returns false if Redis is unavailable.
  */
 export declare const deleteKey: (key: string) => Promise<boolean>;
+/**
+ * DEL multiple keys. Returns deleted count, or null if Redis is unavailable.
+ */
+export declare const del: (keys: string[]) => Promise<number | null>;
+/**
+ * EXISTS a key.
+ */
+export declare const exists: (key: string) => Promise<boolean | null>;
+/**
+ * EXPIRE a key in seconds.
+ */
+export declare const expire: (key: string, ttlSec: number) => Promise<boolean>;
+/**
+ * TTL for a key in seconds. Returns null if Redis is unavailable.
+ */
+export declare const ttl: (key: string) => Promise<number | null>;
 /**
  * Set a hash field value.
  */
@@ -26,6 +65,14 @@ export declare const setHashField: (key: string, field: string, value: string) =
  * Get a hash field value.
  */
 export declare const getHashField: (key: string, field: string) => Promise<string | null>;
+/**
+ * HMSET hash fields.
+ */
+export declare const hmset: (key: string, values: RedisHashStringValue) => Promise<boolean>;
+/**
+ * HMGET hash fields.
+ */
+export declare const hmget: (key: string, fields: string[]) => Promise<Record<string, string | null> | null>;
 /**
  * Store a hash field as JSON string.
  */
@@ -38,10 +85,42 @@ export declare const getHashJson: <T>(key: string, field: string) => Promise<T |
  * Get all hash fields.
  */
 export declare const getHashAll: (key: string) => Promise<Record<string, string> | null>;
+/**
+ * HEXISTS a hash field.
+ */
+export declare const hexists: (key: string, field: string) => Promise<boolean | null>;
+/**
+ * HKEYS for a hash.
+ */
+export declare const hkeys: (key: string) => Promise<string[] | null>;
+/**
+ * HLEN for a hash.
+ */
+export declare const hlen: (key: string) => Promise<number | null>;
 /**
  * Remove a hash field.
  */
 export declare const deleteHashField: (key: string, field: string) => Promise<boolean>;
+/**
+ * SADD members to a set. Returns count of newly added members, or null if Redis is unavailable.
+ */
+export declare const sadd: (key: string, members: string[]) => Promise<number | null>;
+/**
+ * SREM members from a set. Returns count of removed members, or null if Redis is unavailable.
+ */
+export declare const srem: (key: string, members: string[]) => Promise<number | null>;
+/**
+ * SISMEMBER for a set member.
+ */
+export declare const sismember: (key: string, member: string) => Promise<boolean | null>;
+/**
+ * SMEMBERS for a set.
+ */
+export declare const smembers: (key: string) => Promise<string[] | null>;
+/**
+ * SCARD for a set.
+ */
+export declare const scard: (key: string) => Promise<number | null>;
 type ListDirection = 'left' | 'right';
 /**
  * Push values to a list. Returns list length or null if Redis is unavailable.
@@ -59,5 +138,9 @@ export declare const rangeList: (key: string, start?: number, stop?: number) =>
  * Get list length.
  */
 export declare const listLength: (key: string) => Promise<number | null>;
+/**
+ * Execute a Redis pipeline and return the result array from exec().
+ */
+export declare const pipeline: <TResult>(build: RedisPipelineBuilder<TResult>) => Promise<TResult | null>;
 export {};
 //# sourceMappingURL=redis-structures.d.ts.map

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":"AAEA;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,OAAO,MAAM,EACb,SAAS,MAAM,KACd,OAAO,CAAC,OAAO,CAUjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAElE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAU,CAAC,EAC7B,KAAK,MAAM,EACX,OAAO,CAAC,EACR,SAAS,MAAM,KACd,OAAO,CAAC,OAAO,CAWjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAU,CAAC,EAAE,KAAK,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAa9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,OAAO,CAM5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAU,KAAK,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAM7F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAU,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAEpF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAU,CAAC,EACjC,KAAK,MAAM,EACX,OAAO,MAAM,EACb,OAAO,CAAC,KACP,OAAO,CAAC,OAAO,CAOjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAU,CAAC,EAAE,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAajF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAKnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAU,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAMjF,CAAC;AAEF,KAAK,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,QAAQ,GACnB,KAAK,MAAM,EACX,QAAQ,MAAM,EAAE,EAChB,YAAW,aAAuB,KACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAUvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAClB,KAAK,MAAM,EACX,YAAW,aAAuB,KACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAIvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,cAAS,EACT,aAAS,KACR,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAEzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAEnE,CAAC"}
+{"version":3,"file":"redis-structures.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/redis-structures.ts"],"names":[],"mappings":"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"}