@windrun-huaiin/backend-core 12.0.0 → 14.0.0

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

@@ -0,0 +1,60 @@
+'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 likeTargetKey = (targetId) => `like:target:${targetId}`;
+const likeUserKey = (userId) => `like:user:${userId}`;
+/**
+ * Like a target. Returns true if the like was added, false if it already existed, null if Redis is unavailable.
+ */
+const likeTarget = (targetId, userId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const added = yield redis.sadd(likeTargetKey(targetId), userId);
+        if (added === 1) {
+            yield redis.sadd(likeUserKey(userId), targetId);
+            return true;
+        }
+        return false;
+    }));
+});
+/**
+ * Unlike a target. Returns true if removed, false if it didn't exist, null if Redis is unavailable.
+ */
+const unlikeTarget = (targetId, userId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const removed = yield redis.srem(likeTargetKey(targetId), userId);
+        if (removed === 1) {
+            yield redis.srem(likeUserKey(userId), targetId);
+            return true;
+        }
+        return false;
+    }));
+});
+/**
+ * Check whether a user liked a target. Returns null if Redis is unavailable.
+ */
+const isTargetLiked = (targetId, userId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const result = yield redis.sismember(likeTargetKey(targetId), userId);
+        return result === 1;
+    }));
+});
+/**
+ * Get like count for a target (unique by user). Returns null if Redis is unavailable.
+ */
+const getTargetLikeCount = (targetId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => redis.scard(likeTargetKey(targetId)));
+});
+/**
+ * Get target ids liked by a user. Returns null if Redis is unavailable.
+ */
+const getUserLikedTargets = (userId) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => redis.smembers(likeUserKey(userId)));
+});
+
+exports.getTargetLikeCount = getTargetLikeCount;
+exports.getUserLikedTargets = getUserLikedTargets;
+exports.isTargetLiked = isTargetLiked;
+exports.likeTarget = likeTarget;
+exports.unlikeTarget = unlikeTarget;

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

@@ -0,0 +1,54 @@
+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 { withRedis } from '../upstash-config.mjs';
+
+const likeTargetKey = (targetId) => `like:target:${targetId}`;
+const likeUserKey = (userId) => `like:user:${userId}`;
+/**
+ * Like a target. Returns true if the like was added, false if it already existed, null if Redis is unavailable.
+ */
+const likeTarget = (targetId, userId) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const added = yield redis.sadd(likeTargetKey(targetId), userId);
+        if (added === 1) {
+            yield redis.sadd(likeUserKey(userId), targetId);
+            return true;
+        }
+        return false;
+    }));
+});
+/**
+ * Unlike a target. Returns true if removed, false if it didn't exist, null if Redis is unavailable.
+ */
+const unlikeTarget = (targetId, userId) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const removed = yield redis.srem(likeTargetKey(targetId), userId);
+        if (removed === 1) {
+            yield redis.srem(likeUserKey(userId), targetId);
+            return true;
+        }
+        return false;
+    }));
+});
+/**
+ * Check whether a user liked a target. Returns null if Redis is unavailable.
+ */
+const isTargetLiked = (targetId, userId) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const result = yield redis.sismember(likeTargetKey(targetId), userId);
+        return result === 1;
+    }));
+});
+/**
+ * Get like count for a target (unique by user). Returns null if Redis is unavailable.
+ */
+const getTargetLikeCount = (targetId) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => redis.scard(likeTargetKey(targetId)));
+});
+/**
+ * Get target ids liked by a user. Returns null if Redis is unavailable.
+ */
+const getUserLikedTargets = (userId) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => redis.smembers(likeUserKey(userId)));
+});
+
+export { getTargetLikeCount, getUserLikedTargets, isTargetLiked, likeTarget, unlikeTarget };

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

@@ -0,0 +1,13 @@
+/**
+ * Acquire a distributed lock. Returns the lock token or null when unavailable.
+ */
+export declare const acquireLock: (key: string, ttlMs: number) => Promise<string | null>;
+/**
+ * Release a distributed lock. Returns false when the lock client is unavailable.
+ */
+export declare const releaseLock: (key: string, token: string) => Promise<boolean>;
+/**
+ * Run a function under a distributed lock. Returns null when the lock is unavailable.
+ */
+export declare const withLock: <T>(key: string, ttlMs: number, fn: () => Promise<T> | T) => Promise<T | null>;
+//# sourceMappingURL=redis-lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-lock.d.ts","sourceRoot":"","sources":["../../../src/lib/upstash/redis-lock.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAMnF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,OAAO,CAM7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAU,CAAC,EAC9B,KAAK,MAAM,EACX,OAAO,MAAM,EACb,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KACvB,OAAO,CAAC,CAAC,GAAG,IAAI,CAWlB,CAAC"}

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

@@ -0,0 +1,59 @@
+'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 unlockScript = `
+if redis.call("get", KEYS[1]) == ARGV[1] then
+  return redis.call("del", KEYS[1])
+else
+  return 0
+end
+`;
+const generateToken = () => {
+    try {
+        return crypto.randomUUID();
+    }
+    catch (_a) {
+        return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    }
+};
+/**
+ * Acquire a distributed lock. Returns the lock token or null when unavailable.
+ */
+const acquireLock = (key, ttlMs) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const token = generateToken();
+        const result = yield redis.set(key, token, { nx: true, px: ttlMs });
+        return result === 'OK' ? token : null;
+    }));
+});
+/**
+ * Release a distributed lock. Returns false when the lock client is unavailable.
+ */
+const releaseLock = (key, token) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const result = yield upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const released = yield redis.eval(unlockScript, [key], [token]);
+        return Number(released) === 1;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Run a function under a distributed lock. Returns null when the lock is unavailable.
+ */
+const withLock = (key, ttlMs, fn) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const token = yield acquireLock(key, ttlMs);
+    if (!token) {
+        return null;
+    }
+    try {
+        return yield fn();
+    }
+    finally {
+        yield releaseLock(key, token);
+    }
+});
+
+exports.acquireLock = acquireLock;
+exports.releaseLock = releaseLock;
+exports.withLock = withLock;

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

@@ -0,0 +1,55 @@
+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 { withRedis } from '../upstash-config.mjs';
+
+const unlockScript = `
+if redis.call("get", KEYS[1]) == ARGV[1] then
+  return redis.call("del", KEYS[1])
+else
+  return 0
+end
+`;
+const generateToken = () => {
+    try {
+        return crypto.randomUUID();
+    }
+    catch (_a) {
+        return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    }
+};
+/**
+ * Acquire a distributed lock. Returns the lock token or null when unavailable.
+ */
+const acquireLock = (key, ttlMs) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const token = generateToken();
+        const result = yield redis.set(key, token, { nx: true, px: ttlMs });
+        return result === 'OK' ? token : null;
+    }));
+});
+/**
+ * Release a distributed lock. Returns false when the lock client is unavailable.
+ */
+const releaseLock = (key, token) => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const released = yield redis.eval(unlockScript, [key], [token]);
+        return Number(released) === 1;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Run a function under a distributed lock. Returns null when the lock is unavailable.
+ */
+const withLock = (key, ttlMs, fn) => __awaiter(void 0, void 0, void 0, function* () {
+    const token = yield acquireLock(key, ttlMs);
+    if (!token) {
+        return null;
+    }
+    try {
+        return yield fn();
+    }
+    finally {
+        yield releaseLock(key, token);
+    }
+});
+
+export { acquireLock, releaseLock, withLock };

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

@@ -0,0 +1,63 @@
+/**
+ * Set a plain string value with optional TTL (seconds).
+ */
+export declare const setString: (key: string, value: string, ttlSec?: number) => Promise<boolean>;
+/**
+ * Get a plain string value. Returns null if Redis is unavailable or key missing.
+ */
+export declare const getString: (key: string) => Promise<string | null>;
+/**
+ * Store an object as JSON string with optional TTL (seconds).
+ */
+export declare const setJson: <T>(key: string, value: T, ttlSec?: number) => Promise<boolean>;
+/**
+ * Get an object stored as JSON string. Returns null if missing or invalid JSON.
+ */
+export declare const getJson: <T>(key: string) => Promise<T | null>;
+/**
+ * Delete a key. Returns false if Redis is unavailable.
+ */
+export declare const deleteKey: (key: string) => Promise<boolean>;
+/**
+ * Set a hash field value.
+ */
+export declare const setHashField: (key: string, field: string, value: string) => Promise<boolean>;
+/**
+ * Get a hash field value.
+ */
+export declare const getHashField: (key: string, field: string) => Promise<string | null>;
+/**
+ * Store a hash field as JSON string.
+ */
+export declare const setHashJson: <T>(key: string, field: string, value: T) => Promise<boolean>;
+/**
+ * Get a hash field stored as JSON string.
+ */
+export declare const getHashJson: <T>(key: string, field: string) => Promise<T | null>;
+/**
+ * Get all hash fields.
+ */
+export declare const getHashAll: (key: string) => Promise<Record<string, string> | null>;
+/**
+ * Remove a hash field.
+ */
+export declare const deleteHashField: (key: string, field: string) => Promise<boolean>;
+type ListDirection = 'left' | 'right';
+/**
+ * Push values to a list. Returns list length or null if Redis is unavailable.
+ */
+export declare const pushList: (key: string, values: string[], direction?: ListDirection) => Promise<number | null>;
+/**
+ * Pop a value from a list.
+ */
+export declare const popList: (key: string, direction?: ListDirection) => Promise<string | null>;
+/**
+ * Get a range from a list.
+ */
+export declare const rangeList: (key: string, start?: number, stop?: number) => Promise<string[] | null>;
+/**
+ * Get list length.
+ */
+export declare const listLength: (key: string) => Promise<number | null>;
+export {};
+//# sourceMappingURL=redis-structures.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,175 @@
+'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');
+
+/**
+ * Set a plain string value with optional TTL (seconds).
+ */
+const setString = (key, value, ttlSec) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        if (ttlSec && ttlSec > 0) {
+            yield redis.set(key, value, { ex: ttlSec });
+            return true;
+        }
+        yield redis.set(key, value);
+        return true;
+    })).then((result) => result !== null && result !== void 0 ? result : false);
+});
+/**
+ * Get a plain string value. Returns null if Redis is unavailable or key missing.
+ */
+const getString = (key) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => redis.get(key));
+});
+/**
+ * Store an object as JSON string with optional TTL (seconds).
+ */
+const setJson = (key, value, ttlSec) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const payload = JSON.stringify(value);
+        if (ttlSec && ttlSec > 0) {
+            yield redis.set(key, payload, { ex: ttlSec });
+            return true;
+        }
+        yield redis.set(key, payload);
+        return true;
+    })).then((result) => result !== null && result !== void 0 ? result : false);
+});
+/**
+ * Get an object stored as JSON string. Returns null if missing or invalid JSON.
+ */
+const getJson = (key) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__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;
+        }
+    }));
+});
+/**
+ * Delete a key. Returns false if Redis is unavailable.
+ */
+const deleteKey = (key) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const result = yield upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const deleted = yield redis.del(key);
+        return deleted > 0;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Set a hash field value.
+ */
+const setHashField = (key, field, value) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const result = yield upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const changed = yield redis.hset(key, { [field]: value });
+        return changed > 0;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Get a hash field value.
+ */
+const getHashField = (key, field) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => redis.hget(key, field));
+});
+/**
+ * Store a hash field as JSON string.
+ */
+const setHashJson = (key, field, value) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const result = yield upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const payload = JSON.stringify(value);
+        const changed = yield redis.hset(key, { [field]: payload });
+        return changed > 0;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Get a hash field stored as JSON string.
+ */
+const getHashJson = (key, field) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const payload = yield redis.hget(key, field);
+        if (!payload) {
+            return null;
+        }
+        try {
+            return JSON.parse(payload);
+        }
+        catch (_a) {
+            return null;
+        }
+    }));
+});
+/**
+ * Get all hash fields.
+ */
+const getHashAll = (key) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const result = yield redis.hgetall(key);
+        return result !== null && result !== void 0 ? result : {};
+    }));
+});
+/**
+ * Remove a hash field.
+ */
+const deleteHashField = (key, field) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    const result = yield upstashConfig.withRedis((redis) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+        const removed = yield redis.hdel(key, field);
+        return removed > 0;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Push values to a list. Returns list length or null if Redis is unavailable.
+ */
+const pushList = (key_1, values_1, ...args_1) => tslib_es6.__awaiter(void 0, [key_1, values_1, ...args_1], void 0, function* (key, values, direction = 'right') {
+    return upstashConfig.withRedis((redis) => {
+        if (values.length === 0) {
+            return redis.llen(key);
+        }
+        return direction === 'left'
+            ? redis.lpush(key, ...values)
+            : redis.rpush(key, ...values);
+    });
+});
+/**
+ * Pop a value from a list.
+ */
+const popList = (key_1, ...args_1) => tslib_es6.__awaiter(void 0, [key_1, ...args_1], void 0, function* (key, direction = 'right') {
+    return upstashConfig.withRedis((redis) => direction === 'left' ? redis.lpop(key) : redis.rpop(key));
+});
+/**
+ * Get a range from a list.
+ */
+const rangeList = (key_1, ...args_1) => tslib_es6.__awaiter(void 0, [key_1, ...args_1], void 0, function* (key, start = 0, stop = -1) {
+    return upstashConfig.withRedis((redis) => redis.lrange(key, start, stop));
+});
+/**
+ * Get list length.
+ */
+const listLength = (key) => tslib_es6.__awaiter(void 0, void 0, void 0, function* () {
+    return upstashConfig.withRedis((redis) => redis.llen(key));
+});
+
+exports.deleteHashField = deleteHashField;
+exports.deleteKey = deleteKey;
+exports.getHashAll = getHashAll;
+exports.getHashField = getHashField;
+exports.getHashJson = getHashJson;
+exports.getJson = getJson;
+exports.getString = getString;
+exports.listLength = listLength;
+exports.popList = popList;
+exports.pushList = pushList;
+exports.rangeList = rangeList;
+exports.setHashField = setHashField;
+exports.setHashJson = setHashJson;
+exports.setJson = setJson;
+exports.setString = setString;

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

@@ -0,0 +1,159 @@
+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 { withRedis } from '../upstash-config.mjs';
+
+/**
+ * Set a plain string value with optional TTL (seconds).
+ */
+const setString = (key, value, ttlSec) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        if (ttlSec && ttlSec > 0) {
+            yield redis.set(key, value, { ex: ttlSec });
+            return true;
+        }
+        yield redis.set(key, value);
+        return true;
+    })).then((result) => result !== null && result !== void 0 ? result : false);
+});
+/**
+ * Get a plain string value. Returns null if Redis is unavailable or key missing.
+ */
+const getString = (key) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => redis.get(key));
+});
+/**
+ * Store an object as JSON string with optional TTL (seconds).
+ */
+const setJson = (key, value, ttlSec) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const payload = JSON.stringify(value);
+        if (ttlSec && ttlSec > 0) {
+            yield redis.set(key, payload, { ex: ttlSec });
+            return true;
+        }
+        yield redis.set(key, payload);
+        return true;
+    })).then((result) => result !== null && result !== void 0 ? result : false);
+});
+/**
+ * Get an object stored as JSON string. Returns null if missing or invalid JSON.
+ */
+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;
+        }
+    }));
+});
+/**
+ * Delete a key. Returns false if Redis is unavailable.
+ */
+const deleteKey = (key) => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const deleted = yield redis.del(key);
+        return deleted > 0;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Set a hash field value.
+ */
+const setHashField = (key, field, value) => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const changed = yield redis.hset(key, { [field]: value });
+        return changed > 0;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Get a hash field value.
+ */
+const getHashField = (key, field) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => redis.hget(key, field));
+});
+/**
+ * Store a hash field as JSON string.
+ */
+const setHashJson = (key, field, value) => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const payload = JSON.stringify(value);
+        const changed = yield redis.hset(key, { [field]: payload });
+        return changed > 0;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Get a hash field stored as JSON string.
+ */
+const getHashJson = (key, field) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const payload = yield redis.hget(key, field);
+        if (!payload) {
+            return null;
+        }
+        try {
+            return JSON.parse(payload);
+        }
+        catch (_a) {
+            return null;
+        }
+    }));
+});
+/**
+ * Get all hash fields.
+ */
+const getHashAll = (key) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const result = yield redis.hgetall(key);
+        return result !== null && result !== void 0 ? result : {};
+    }));
+});
+/**
+ * Remove a hash field.
+ */
+const deleteHashField = (key, field) => __awaiter(void 0, void 0, void 0, function* () {
+    const result = yield withRedis((redis) => __awaiter(void 0, void 0, void 0, function* () {
+        const removed = yield redis.hdel(key, field);
+        return removed > 0;
+    }));
+    return result !== null && result !== void 0 ? result : false;
+});
+/**
+ * Push values to a list. Returns list length or null if Redis is unavailable.
+ */
+const pushList = (key_1, values_1, ...args_1) => __awaiter(void 0, [key_1, values_1, ...args_1], void 0, function* (key, values, direction = 'right') {
+    return withRedis((redis) => {
+        if (values.length === 0) {
+            return redis.llen(key);
+        }
+        return direction === 'left'
+            ? redis.lpush(key, ...values)
+            : redis.rpush(key, ...values);
+    });
+});
+/**
+ * Pop a value from a list.
+ */
+const popList = (key_1, ...args_1) => __awaiter(void 0, [key_1, ...args_1], void 0, function* (key, direction = 'right') {
+    return withRedis((redis) => direction === 'left' ? redis.lpop(key) : redis.rpop(key));
+});
+/**
+ * Get a range from a list.
+ */
+const rangeList = (key_1, ...args_1) => __awaiter(void 0, [key_1, ...args_1], void 0, function* (key, start = 0, stop = -1) {
+    return withRedis((redis) => redis.lrange(key, start, stop));
+});
+/**
+ * Get list length.
+ */
+const listLength = (key) => __awaiter(void 0, void 0, void 0, function* () {
+    return withRedis((redis) => redis.llen(key));
+});
+
+export { deleteHashField, deleteKey, getHashAll, getHashField, getHashJson, getJson, getString, listLength, popList, pushList, rangeList, setHashField, setHashJson, setJson, setString };

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

@@ -0,0 +1,19 @@
+import { Redis } from '@upstash/redis';
+import { Client as QstashClient } from '@upstash/qstash';
+/**
+ * Get the Upstash Redis client. Returns null when required env vars are missing/invalid.
+ *
+ * Singleton semantics:
+ * - read-through cached instance only
+ */
+export declare const getRedis: () => Redis | null;
+/**
+ * Get the Upstash QStash client. Returns null when required env vars are missing.
+ *
+ * Singleton semantics:
+ * - read-through cached instance only
+ */
+export declare const getQstash: () => QstashClient | null;
+export declare const withRedis: <T>(fn: (redis: Redis) => Promise<T> | T) => Promise<T | null>;
+export declare const withQstash: <T>(fn: (qstash: QstashClient) => Promise<T> | T) => Promise<T | null>;
+//# sourceMappingURL=upstash-config.d.ts.map

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

@@ -0,0 +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;AAoIzD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,QAAO,KAAK,GAAG,IAEnC,CAAC;AAsDF;;;;;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"}