@windrun-huaiin/backend-core 11.0.3 → 13.0.0

package/dist/lib/index.js

@@ -6,6 +6,13 @@ var fingerprintConfig = require('./fingerprint-config.js');
 var creditInit = require('./credit-init.js');
 var stripeConfig = require('./stripe-config.js');
 var authUtils = require('./auth-utils.js');
+var upstashConfig = require('./upstash-config.js');
+var redisLock = require('./upstash/redis-lock.js');
+var redisLike = require('./upstash/redis-like.js');
+var redisFavorite = require('./upstash/redis-favorite.js');
+var redisCounter = require('./upstash/redis-counter.js');
+var redisStructures = require('./upstash/redis-structures.js');
+var qstash = require('./upstash/qstash.js');
 
 
 
@@ -33,3 +40,42 @@ exports.ApiAuthUtils = authUtils.ApiAuthUtils;
 exports.getAuthenticatedUser = authUtils.getAuthenticatedUser;
 exports.requireAuth = authUtils.requireAuth;
 exports.requireAuthWithUser = authUtils.requireAuthWithUser;
+exports.getQstash = upstashConfig.getQstash;
+exports.getRedis = upstashConfig.getRedis;
+exports.acquireLock = redisLock.acquireLock;
+exports.releaseLock = redisLock.releaseLock;
+exports.withLock = redisLock.withLock;
+exports.getTargetLikeCount = redisLike.getTargetLikeCount;
+exports.getUserLikedTargets = redisLike.getUserLikedTargets;
+exports.isTargetLiked = redisLike.isTargetLiked;
+exports.likeTarget = redisLike.likeTarget;
+exports.unlikeTarget = redisLike.unlikeTarget;
+exports.addFavorite = redisFavorite.addFavorite;
+exports.getFavoriteCount = redisFavorite.getFavoriteCount;
+exports.getUserFavorites = redisFavorite.getUserFavorites;
+exports.isFavorited = redisFavorite.isFavorited;
+exports.removeFavorite = redisFavorite.removeFavorite;
+exports.getCounter = redisCounter.getCounter;
+exports.getUniqueCounter = redisCounter.getUniqueCounter;
+exports.incrCounter = redisCounter.incrCounter;
+exports.incrUniqueCounter = redisCounter.incrUniqueCounter;
+exports.deleteHashField = redisStructures.deleteHashField;
+exports.deleteKey = redisStructures.deleteKey;
+exports.getHashAll = redisStructures.getHashAll;
+exports.getHashField = redisStructures.getHashField;
+exports.getHashJson = redisStructures.getHashJson;
+exports.getJson = redisStructures.getJson;
+exports.getString = redisStructures.getString;
+exports.listLength = redisStructures.listLength;
+exports.popList = redisStructures.popList;
+exports.pushList = redisStructures.pushList;
+exports.rangeList = redisStructures.rangeList;
+exports.setHashField = redisStructures.setHashField;
+exports.setHashJson = redisStructures.setHashJson;
+exports.setJson = redisStructures.setJson;
+exports.setString = redisStructures.setString;
+exports.cancelSchedule = qstash.cancelSchedule;
+exports.publishDelayedMessage = qstash.publishDelayedMessage;
+exports.publishMessage = qstash.publishMessage;
+exports.scheduleMessage = qstash.scheduleMessage;
+exports.verifyQstashSignature = qstash.verifyQstashSignature;

package/dist/lib/index.mjs

@@ -4,3 +4,10 @@ export { fingerprintConfig } from './fingerprint-config.mjs';
 export { creditsConfig, freeAmount, freeExpiredDays, freeRegisterAmount, oneTimeExpiredDays } from './credit-init.mjs';
 export { ActiveSubscriptionExistsError, cancelSubscription, createCheckoutSession, createCustomerPortalSession, createOrGetCustomer, fetchPaymentId, stripe, updateSubscription, validateStripeWebhook } from './stripe-config.mjs';
 export { ApiAuthUtils, getAuthenticatedUser, requireAuth, requireAuthWithUser } from './auth-utils.mjs';
+export { getQstash, getRedis } 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 { deleteHashField, deleteKey, getHashAll, getHashField, getHashJson, getJson, getString, listLength, popList, pushList, rangeList, setHashField, setHashJson, setJson, setString } from './upstash/redis-structures.mjs';
+export { cancelSchedule, publishDelayedMessage, publishMessage, scheduleMessage, verifyQstashSignature } from './upstash/qstash.mjs';

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

@@ -0,0 +1,7 @@
+export * from './redis-lock';
+export * from './redis-like';
+export * from './redis-favorite';
+export * from './redis-counter';
+export * from './redis-structures';
+export * from './qstash';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC"}

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

@@ -0,0 +1,36 @@
+export type PublishBody = Record<string, unknown> | string | number | boolean | null;
+export interface PublishMessageOptions {
+    url: string;
+    body: PublishBody;
+}
+/**
+ * Publish a message. Returns message id or null if QStash is unavailable.
+ */
+export declare const publishMessage: (options: PublishMessageOptions) => Promise<string | null>;
+/**
+ * Publish a delayed message. Returns message id or null if QStash is unavailable.
+ */
+export declare const publishDelayedMessage: (options: PublishMessageOptions & {
+    delaySec: number;
+}) => Promise<string | null>;
+export interface ScheduleMessageOptions extends PublishMessageOptions {
+    cron: string;
+}
+/**
+ * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
+ */
+export declare const scheduleMessage: (options: ScheduleMessageOptions) => Promise<string | null>;
+/**
+ * Cancel a scheduled message. Returns false if QStash is unavailable.
+ */
+export declare const cancelSchedule: (scheduleId: string) => Promise<boolean>;
+export interface VerifyQstashOptions {
+    signature: string;
+    body: string;
+    url: string;
+}
+/**
+ * Verify QStash signature. Throws on failure in non-dev environments.
+ */
+export declare const verifyQstashSignature: (options: VerifyQstashOptions) => Promise<boolean>;
+//# sourceMappingURL=qstash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qstash.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/qstash.ts"],"names":[],"mappings":"AAkCA,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,CAW1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,qBAAqB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KACpD,OAAO,CAAC,MAAM,GAAG,IAAI,CAYvB,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,CAoB5F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,OAAO,CAgBxE,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

@@ -0,0 +1,130 @@
+'use strict';
+
+var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
+var chunkRQPZUJXG = require('../../node_modules/.pnpm/@upstash_qstash@2.8.4/node_modules/@upstash/qstash/chunk-RQPZUJXG.js');
+var upstashConfig = require('../upstash-config.js');
+
+let cachedReceiver = null;
+let receiverInitAttempted = false;
+const isTruthy = (value) => value === '1' || value === 'true' || value === 'TRUE';
+const shouldSkipVerify = () => process.env.NODE_ENV === 'development' && isTruthy(process.env.SKIP_UPSTASH_QSTASH_VERIFY);
+const getReceiver = () => {
+    if (cachedReceiver) {
+        return cachedReceiver;
+    }
+    if (receiverInitAttempted) {
+        return null;
+    }
+    receiverInitAttempted = true;
+    const currentSigningKey = process.env.QSTASH_CURRENT_SIGNING_KEY;
+    const nextSigningKey = process.env.QSTASH_NEXT_SIGNING_KEY;
+    if (!currentSigningKey || !nextSigningKey) {
+        return null;
+    }
+    cachedReceiver = new chunkRQPZUJXG.Receiver({
+        currentSigningKey,
+        nextSigningKey,
+    });
+    return cachedReceiver;
+};
+/**
+ * Publish a message. Returns message id or null if QStash is unavailable.
+ */
+const publishMessage = (options) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const client = upstashConfig.getQstash();
+    if (!client) {
+        return null;
+    }
+    const result = yield client.publishJSON({
+        url: options.url,
+        body: options.body,
+    });
+    return typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null;
+});
+/**
+ * Publish a delayed message. Returns message id or null if QStash is unavailable.
+ */
+const publishDelayedMessage = (options) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const client = upstashConfig.getQstash();
+    if (!client) {
+        return null;
+    }
+    const result = yield client.publishJSON({
+        url: options.url,
+        body: options.body,
+        delay: options.delaySec,
+    });
+    return typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null;
+});
+/**
+ * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
+ */
+const scheduleMessage = (options) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e, _f;
+    const client = upstashConfig.getQstash();
+    if (!client) {
+        return null;
+    }
+    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,
+        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,
+        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;
+});
+/**
+ * Cancel a scheduled message. Returns false if QStash is unavailable.
+ */
+const cancelSchedule = (scheduleId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const client = upstashConfig.getQstash();
+    if (!client) {
+        return false;
+    }
+    const anyClient = client;
+    if ((_a = anyClient.schedules) === null || _a === void 0 ? void 0 : _a.delete) {
+        yield anyClient.schedules.delete(scheduleId);
+        return true;
+    }
+    if ((_b = anyClient.schedules) === null || _b === void 0 ? void 0 : _b.remove) {
+        yield anyClient.schedules.remove(scheduleId);
+        return true;
+    }
+    return false;
+});
+/**
+ * Verify QStash signature. Throws on failure in non-dev environments.
+ */
+const verifyQstashSignature = (options) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    if (shouldSkipVerify()) {
+        return true;
+    }
+    const receiver = getReceiver();
+    if (!receiver) {
+        throw new Error('QStash signing keys are missing');
+    }
+    const verifier = (_a = receiver.verify) !== null && _a !== void 0 ? _a : receiver.verifySignature;
+    if (!verifier) {
+        throw new Error('QStash receiver verify method is unavailable');
+    }
+    yield verifier.call(receiver, {
+        signature: options.signature,
+        body: options.body,
+        url: options.url,
+    });
+    return true;
+});
+
+exports.cancelSchedule = cancelSchedule;
+exports.publishDelayedMessage = publishDelayedMessage;
+exports.publishMessage = publishMessage;
+exports.scheduleMessage = scheduleMessage;
+exports.verifyQstashSignature = verifyQstashSignature;

package/dist/lib/upstash/qstash.mjs

@@ -0,0 +1,124 @@
+import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
+import { Receiver } from '../../node_modules/.pnpm/@upstash_qstash@2.8.4/node_modules/@upstash/qstash/chunk-RQPZUJXG.mjs';
+import { getQstash } from '../upstash-config.mjs';
+
+let cachedReceiver = null;
+let receiverInitAttempted = false;
+const isTruthy = (value) => value === '1' || value === 'true' || value === 'TRUE';
+const shouldSkipVerify = () => process.env.NODE_ENV === 'development' && isTruthy(process.env.SKIP_UPSTASH_QSTASH_VERIFY);
+const getReceiver = () => {
+    if (cachedReceiver) {
+        return cachedReceiver;
+    }
+    if (receiverInitAttempted) {
+        return null;
+    }
+    receiverInitAttempted = true;
+    const currentSigningKey = process.env.QSTASH_CURRENT_SIGNING_KEY;
+    const nextSigningKey = process.env.QSTASH_NEXT_SIGNING_KEY;
+    if (!currentSigningKey || !nextSigningKey) {
+        return null;
+    }
+    cachedReceiver = new Receiver({
+        currentSigningKey,
+        nextSigningKey,
+    });
+    return cachedReceiver;
+};
+/**
+ * Publish a message. Returns message id or null if QStash is unavailable.
+ */
+const publishMessage = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const client = getQstash();
+    if (!client) {
+        return null;
+    }
+    const result = yield client.publishJSON({
+        url: options.url,
+        body: options.body,
+    });
+    return typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null;
+});
+/**
+ * Publish a delayed message. Returns message id or null if QStash is unavailable.
+ */
+const publishDelayedMessage = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const client = getQstash();
+    if (!client) {
+        return null;
+    }
+    const result = yield client.publishJSON({
+        url: options.url,
+        body: options.body,
+        delay: options.delaySec,
+    });
+    return typeof result === 'string' ? result : (_a = result === null || result === void 0 ? void 0 : result.messageId) !== null && _a !== void 0 ? _a : null;
+});
+/**
+ * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
+ */
+const scheduleMessage = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e, _f;
+    const client = getQstash();
+    if (!client) {
+        return null;
+    }
+    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,
+        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,
+        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;
+});
+/**
+ * Cancel a scheduled message. Returns false if QStash is unavailable.
+ */
+const cancelSchedule = (scheduleId) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const client = getQstash();
+    if (!client) {
+        return false;
+    }
+    const anyClient = client;
+    if ((_a = anyClient.schedules) === null || _a === void 0 ? void 0 : _a.delete) {
+        yield anyClient.schedules.delete(scheduleId);
+        return true;
+    }
+    if ((_b = anyClient.schedules) === null || _b === void 0 ? void 0 : _b.remove) {
+        yield anyClient.schedules.remove(scheduleId);
+        return true;
+    }
+    return false;
+});
+/**
+ * Verify QStash signature. Throws on failure in non-dev environments.
+ */
+const verifyQstashSignature = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    if (shouldSkipVerify()) {
+        return true;
+    }
+    const receiver = getReceiver();
+    if (!receiver) {
+        throw new Error('QStash signing keys are missing');
+    }
+    const verifier = (_a = receiver.verify) !== null && _a !== void 0 ? _a : receiver.verifySignature;
+    if (!verifier) {
+        throw new Error('QStash receiver verify method is unavailable');
+    }
+    yield verifier.call(receiver, {
+        signature: options.signature,
+        body: options.body,
+        url: options.url,
+    });
+    return true;
+});
+
+export { cancelSchedule, publishDelayedMessage, publishMessage, scheduleMessage, verifyQstashSignature };

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

@@ -0,0 +1,17 @@
+/**
+ * Increment a counter (e.g. views, forwards). Returns null if Redis is unavailable.
+ */
+export declare const incrCounter: (key: string, delta?: number) => Promise<number | null>;
+/**
+ * Get a counter value. Returns null if Redis is unavailable.
+ */
+export declare const getCounter: (key: string) => Promise<number | null>;
+/**
+ * Increment a unique counter via SET (e.g. unique views). Returns null if Redis is unavailable.
+ */
+export declare const incrUniqueCounter: (setKey: string, memberId: string) => Promise<number | null>;
+/**
+ * Get unique counter value (SET cardinality). Returns null if Redis is unavailable.
+ */
+export declare const getUniqueCounter: (setKey: string) => Promise<number | null>;
+//# sourceMappingURL=redis-counter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-counter.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/redis-counter.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,EAAE,cAAS,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAM/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAOnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAU,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAW/F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAM5E,CAAC"}

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

@@ -0,0 +1,55 @@
+'use strict';
+
+var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
+var upstashConfig = require('../upstash-config.js');
+
+/**
+ * Increment a counter (e.g. views, forwards). Returns null if Redis is unavailable.
+ */
+const incrCounter = (key_1, ...args_1) => tslib_es6.__awaiter(void 0, [key_1, ...args_1], void 0, function* (key, delta = 1) {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    return redis.incrby(key, delta);
+});
+/**
+ * Get a counter value. Returns null if Redis is unavailable.
+ */
+const getCounter = (key) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    const value = yield redis.get(key);
+    return value !== null && value !== void 0 ? value : 0;
+});
+/**
+ * Increment a unique counter via SET (e.g. unique views). Returns null if Redis is unavailable.
+ */
+const incrUniqueCounter = (setKey, memberId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    const added = yield redis.sadd(setKey, memberId);
+    if (added === 1) {
+        return redis.scard(setKey);
+    }
+    return redis.scard(setKey);
+});
+/**
+ * Get unique counter value (SET cardinality). Returns null if Redis is unavailable.
+ */
+const getUniqueCounter = (setKey) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    return redis.scard(setKey);
+});
+
+exports.getCounter = getCounter;
+exports.getUniqueCounter = getUniqueCounter;
+exports.incrCounter = incrCounter;
+exports.incrUniqueCounter = incrUniqueCounter;

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

@@ -0,0 +1,50 @@
+import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
+import { getRedis } from '../upstash-config.mjs';
+
+/**
+ * Increment a counter (e.g. views, forwards). Returns null if Redis is unavailable.
+ */
+const incrCounter = (key_1, ...args_1) => __awaiter(void 0, [key_1, ...args_1], void 0, function* (key, delta = 1) {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    return redis.incrby(key, delta);
+});
+/**
+ * Get a counter value. Returns null if Redis is unavailable.
+ */
+const getCounter = (key) => __awaiter(void 0, void 0, void 0, function* () {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    const value = yield redis.get(key);
+    return value !== null && value !== void 0 ? value : 0;
+});
+/**
+ * Increment a unique counter via SET (e.g. unique views). Returns null if Redis is unavailable.
+ */
+const incrUniqueCounter = (setKey, memberId) => __awaiter(void 0, void 0, void 0, function* () {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    const added = yield redis.sadd(setKey, memberId);
+    if (added === 1) {
+        return redis.scard(setKey);
+    }
+    return redis.scard(setKey);
+});
+/**
+ * Get unique counter value (SET cardinality). Returns null if Redis is unavailable.
+ */
+const getUniqueCounter = (setKey) => __awaiter(void 0, void 0, void 0, function* () {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    return redis.scard(setKey);
+});
+
+export { getCounter, getUniqueCounter, incrCounter, incrUniqueCounter };

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

@@ -0,0 +1,21 @@
+/**
+ * Favorite a target. Returns true if added, false if already favorited, null if Redis is unavailable.
+ */
+export declare const addFavorite: (targetId: string, userId: string) => Promise<boolean | null>;
+/**
+ * Remove a favorite. Returns true if removed, false if not found, null if Redis is unavailable.
+ */
+export declare const removeFavorite: (targetId: string, userId: string) => Promise<boolean | null>;
+/**
+ * Check whether a user has favorited a target. Returns null if Redis is unavailable.
+ */
+export declare const isFavorited: (targetId: string, userId: string) => Promise<boolean | null>;
+/**
+ * Get favorite count for a target. Returns null if Redis is unavailable.
+ */
+export declare const getFavoriteCount: (targetId: string) => Promise<number | null>;
+/**
+ * Get target ids favorited by a user. Returns null if Redis is unavailable.
+ */
+export declare const getUserFavorites: (userId: string) => Promise<string[] | null>;
+//# sourceMappingURL=redis-favorite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-favorite.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/redis-favorite.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,WAAW,GAAU,UAAU,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAY1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,UAAU,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAY7F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAU,UAAU,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAQ1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAO9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAO9E,CAAC"}

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

@@ -0,0 +1,74 @@
+'use strict';
+
+var tslib_es6 = require('../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.js');
+var upstashConfig = require('../upstash-config.js');
+
+const favoriteTargetKey = (targetId) => `favorite:target:${targetId}`;
+const favoriteUserKey = (userId) => `favorite:user:${userId}`;
+/**
+ * Favorite a target. Returns true if added, false if already favorited, null if Redis is unavailable.
+ */
+const addFavorite = (targetId, userId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    const added = yield redis.sadd(favoriteTargetKey(targetId), userId);
+    if (added === 1) {
+        yield redis.sadd(favoriteUserKey(userId), targetId);
+        return true;
+    }
+    return false;
+});
+/**
+ * Remove a favorite. Returns true if removed, false if not found, null if Redis is unavailable.
+ */
+const removeFavorite = (targetId, userId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    const removed = yield redis.srem(favoriteTargetKey(targetId), userId);
+    if (removed === 1) {
+        yield redis.srem(favoriteUserKey(userId), targetId);
+        return true;
+    }
+    return false;
+});
+/**
+ * Check whether a user has favorited a target. Returns null if Redis is unavailable.
+ */
+const isFavorited = (targetId, userId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    const result = yield redis.sismember(favoriteTargetKey(targetId), userId);
+    return result === 1;
+});
+/**
+ * Get favorite count for a target. Returns null if Redis is unavailable.
+ */
+const getFavoriteCount = (targetId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    return redis.scard(favoriteTargetKey(targetId));
+});
+/**
+ * Get target ids favorited by a user. Returns null if Redis is unavailable.
+ */
+const getUserFavorites = (userId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const redis = upstashConfig.getRedis();
+    if (!redis) {
+        return null;
+    }
+    return redis.smembers(favoriteUserKey(userId));
+});
+
+exports.addFavorite = addFavorite;
+exports.getFavoriteCount = getFavoriteCount;
+exports.getUserFavorites = getUserFavorites;
+exports.isFavorited = isFavorited;
+exports.removeFavorite = removeFavorite;

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

@@ -0,0 +1,68 @@
+import { __awaiter } from '../../node_modules/.pnpm/@rollup_plugin-typescript@12.1.4_rollup@4.46.2_tslib@2.8.1_typescript@5.9.3/node_modules/tslib/tslib.es6.mjs';
+import { getRedis } from '../upstash-config.mjs';
+
+const favoriteTargetKey = (targetId) => `favorite:target:${targetId}`;
+const favoriteUserKey = (userId) => `favorite:user:${userId}`;
+/**
+ * Favorite a target. Returns true if added, false if already favorited, null if Redis is unavailable.
+ */
+const addFavorite = (targetId, userId) => __awaiter(void 0, void 0, void 0, function* () {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    const added = yield redis.sadd(favoriteTargetKey(targetId), userId);
+    if (added === 1) {
+        yield redis.sadd(favoriteUserKey(userId), targetId);
+        return true;
+    }
+    return false;
+});
+/**
+ * Remove a favorite. Returns true if removed, false if not found, null if Redis is unavailable.
+ */
+const removeFavorite = (targetId, userId) => __awaiter(void 0, void 0, void 0, function* () {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    const removed = yield redis.srem(favoriteTargetKey(targetId), userId);
+    if (removed === 1) {
+        yield redis.srem(favoriteUserKey(userId), targetId);
+        return true;
+    }
+    return false;
+});
+/**
+ * Check whether a user has favorited a target. Returns null if Redis is unavailable.
+ */
+const isFavorited = (targetId, userId) => __awaiter(void 0, void 0, void 0, function* () {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    const result = yield redis.sismember(favoriteTargetKey(targetId), userId);
+    return result === 1;
+});
+/**
+ * Get favorite count for a target. Returns null if Redis is unavailable.
+ */
+const getFavoriteCount = (targetId) => __awaiter(void 0, void 0, void 0, function* () {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    return redis.scard(favoriteTargetKey(targetId));
+});
+/**
+ * Get target ids favorited by a user. Returns null if Redis is unavailable.
+ */
+const getUserFavorites = (userId) => __awaiter(void 0, void 0, void 0, function* () {
+    const redis = getRedis();
+    if (!redis) {
+        return null;
+    }
+    return redis.smembers(favoriteUserKey(userId));
+});
+
+export { addFavorite, getFavoriteCount, getUserFavorites, isFavorited, removeFavorite };