@windrun-huaiin/backend-core 12.0.0 → 13.0.0

package/dist/node_modules/.pnpm/neverthrow@7.2.0/node_modules/neverthrow/dist/index.es.mjs

@@ -0,0 +1,415 @@
+const defaultErrorConfig = {
+    withStackTrace: false,
+};
+// Custom error object
+// Context / discussion: https://github.com/supermacro/neverthrow/pull/215
+const createNeverThrowError = (message, result, config = defaultErrorConfig) => {
+    const data = result.isOk()
+        ? { type: 'Ok', value: result.value }
+        : { type: 'Err', value: result.error };
+    const maybeStack = config.withStackTrace ? new Error().stack : undefined;
+    return {
+        data,
+        message,
+        stack: maybeStack,
+    };
+};
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+/* global Reflect, Promise */
+
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, [])).next());
+    });
+}
+
+function __values(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+}
+
+function __await(v) {
+    return this instanceof __await ? (this.v = v, this) : new __await(v);
+}
+
+function __asyncGenerator(thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+}
+
+function __asyncDelegator(o) {
+    var i, p;
+    return i = {}, verb("next"), verb("throw", function (e) { throw e; }), verb("return"), i[Symbol.iterator] = function () { return this; }, i;
+    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === "return" } : f ? f(v) : v; } : f; }
+}
+
+function __asyncValues(o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+}
+
+class ResultAsync {
+    constructor(res) {
+        this._promise = res;
+    }
+    static fromSafePromise(promise) {
+        const newPromise = promise.then((value) => new Ok(value));
+        return new ResultAsync(newPromise);
+    }
+    static fromPromise(promise, errorFn) {
+        const newPromise = promise
+            .then((value) => new Ok(value))
+            .catch((e) => new Err(errorFn(e)));
+        return new ResultAsync(newPromise);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static fromThrowable(fn, errorFn) {
+        return (...args) => {
+            return new ResultAsync((() => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    return new Ok(yield fn(...args));
+                }
+                catch (error) {
+                    return new Err(errorFn ? errorFn(error) : error);
+                }
+            }))());
+        };
+    }
+    static combine(asyncResultList) {
+        return combineResultAsyncList(asyncResultList);
+    }
+    static combineWithAllErrors(asyncResultList) {
+        return combineResultAsyncListWithAllErrors(asyncResultList);
+    }
+    map(f) {
+        return new ResultAsync(this._promise.then((res) => __awaiter(this, void 0, void 0, function* () {
+            if (res.isErr()) {
+                return new Err(res.error);
+            }
+            return new Ok(yield f(res.value));
+        })));
+    }
+    andThrough(f) {
+        return new ResultAsync(this._promise.then((res) => __awaiter(this, void 0, void 0, function* () {
+            if (res.isErr()) {
+                return new Err(res.error);
+            }
+            const newRes = yield f(res.value);
+            if (newRes.isErr()) {
+                return new Err(newRes.error);
+            }
+            return new Ok(res.value);
+        })));
+    }
+    andTee(f) {
+        return new ResultAsync(this._promise.then((res) => __awaiter(this, void 0, void 0, function* () {
+            if (res.isErr()) {
+                return new Err(res.error);
+            }
+            try {
+                yield f(res.value);
+            }
+            catch (e) {
+                // Tee does not care about the error
+            }
+            return new Ok(res.value);
+        })));
+    }
+    mapErr(f) {
+        return new ResultAsync(this._promise.then((res) => __awaiter(this, void 0, void 0, function* () {
+            if (res.isOk()) {
+                return new Ok(res.value);
+            }
+            return new Err(yield f(res.error));
+        })));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    andThen(f) {
+        return new ResultAsync(this._promise.then((res) => {
+            if (res.isErr()) {
+                return new Err(res.error);
+            }
+            const newValue = f(res.value);
+            return newValue instanceof ResultAsync ? newValue._promise : newValue;
+        }));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    orElse(f) {
+        return new ResultAsync(this._promise.then((res) => __awaiter(this, void 0, void 0, function* () {
+            if (res.isErr()) {
+                return f(res.error);
+            }
+            return new Ok(res.value);
+        })));
+    }
+    match(ok, _err) {
+        return this._promise.then((res) => res.match(ok, _err));
+    }
+    unwrapOr(t) {
+        return this._promise.then((res) => res.unwrapOr(t));
+    }
+    /**
+     * Emulates Rust's `?` operator in `safeTry`'s body. See also `safeTry`.
+     */
+    safeUnwrap() {
+        return __asyncGenerator(this, arguments, function* safeUnwrap_1() {
+            return yield __await(yield __await(yield* __asyncDelegator(__asyncValues(yield __await(this._promise.then((res) => res.safeUnwrap()))))));
+        });
+    }
+    // Makes ResultAsync implement PromiseLike<Result>
+    then(successCallback, failureCallback) {
+        return this._promise.then(successCallback, failureCallback);
+    }
+}
+const errAsync = (err) => new ResultAsync(Promise.resolve(new Err(err)));
+
+/**
+ * Short circuits on the FIRST Err value that we find
+ */
+const combineResultList = (resultList) => {
+    let acc = ok([]);
+    for (const result of resultList) {
+        if (result.isErr()) {
+            acc = err(result.error);
+            break;
+        }
+        else {
+            acc.map((list) => list.push(result.value));
+        }
+    }
+    return acc;
+};
+/* This is the typesafe version of Promise.all
+ *
+ * Takes a list of ResultAsync<T, E> and success if all inner results are Ok values
+ * or fails if one (or more) of the inner results are Err values
+ */
+const combineResultAsyncList = (asyncResultList) => ResultAsync.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultList);
+/**
+ * Give a list of all the errors we find
+ */
+const combineResultListWithAllErrors = (resultList) => {
+    let acc = ok([]);
+    for (const result of resultList) {
+        if (result.isErr() && acc.isErr()) {
+            acc.error.push(result.error);
+        }
+        else if (result.isErr() && acc.isOk()) {
+            acc = err([result.error]);
+        }
+        else if (result.isOk() && acc.isOk()) {
+            acc.value.push(result.value);
+        }
+        // do nothing when result.isOk() && acc.isErr()
+    }
+    return acc;
+};
+const combineResultAsyncListWithAllErrors = (asyncResultList) => ResultAsync.fromSafePromise(Promise.all(asyncResultList)).andThen(combineResultListWithAllErrors);
+
+// eslint-disable-next-line @typescript-eslint/no-namespace
+var Result;
+(function (Result) {
+    /**
+     * Wraps a function with a try catch, creating a new function with the same
+     * arguments but returning `Ok` if successful, `Err` if the function throws
+     *
+     * @param fn function to wrap with ok on success or err on failure
+     * @param errorFn when an error is thrown, this will wrap the error result if provided
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function fromThrowable(fn, errorFn) {
+        return (...args) => {
+            try {
+                const result = fn(...args);
+                return ok(result);
+            }
+            catch (e) {
+                return err(errorFn ? errorFn(e) : e);
+            }
+        };
+    }
+    Result.fromThrowable = fromThrowable;
+    function combine(resultList) {
+        return combineResultList(resultList);
+    }
+    Result.combine = combine;
+    function combineWithAllErrors(resultList) {
+        return combineResultListWithAllErrors(resultList);
+    }
+    Result.combineWithAllErrors = combineWithAllErrors;
+})(Result || (Result = {}));
+const ok = (value) => new Ok(value);
+function err(err) {
+    return new Err(err);
+}
+class Ok {
+    constructor(value) {
+        this.value = value;
+    }
+    isOk() {
+        return true;
+    }
+    isErr() {
+        return !this.isOk();
+    }
+    map(f) {
+        return ok(f(this.value));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    mapErr(_f) {
+        return ok(this.value);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    andThen(f) {
+        return f(this.value);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    andThrough(f) {
+        return f(this.value).map((_value) => this.value);
+    }
+    andTee(f) {
+        try {
+            f(this.value);
+        }
+        catch (e) {
+            // Tee doesn't care about the error
+        }
+        return ok(this.value);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    orElse(_f) {
+        return ok(this.value);
+    }
+    asyncAndThen(f) {
+        return f(this.value);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    asyncAndThrough(f) {
+        return f(this.value).map(() => this.value);
+    }
+    asyncMap(f) {
+        return ResultAsync.fromSafePromise(f(this.value));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    unwrapOr(_v) {
+        return this.value;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    match(ok, _err) {
+        return ok(this.value);
+    }
+    safeUnwrap() {
+        const value = this.value;
+        /* eslint-disable-next-line require-yield */
+        return (function* () {
+            return value;
+        })();
+    }
+    _unsafeUnwrap(_) {
+        return this.value;
+    }
+    _unsafeUnwrapErr(config) {
+        throw createNeverThrowError('Called `_unsafeUnwrapErr` on an Ok', this, config);
+    }
+}
+class Err {
+    constructor(error) {
+        this.error = error;
+    }
+    isOk() {
+        return false;
+    }
+    isErr() {
+        return !this.isOk();
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    map(_f) {
+        return err(this.error);
+    }
+    mapErr(f) {
+        return err(f(this.error));
+    }
+    andThrough(_f) {
+        return err(this.error);
+    }
+    andTee(_f) {
+        return err(this.error);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    andThen(_f) {
+        return err(this.error);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
+    orElse(f) {
+        return f(this.error);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    asyncAndThen(_f) {
+        return errAsync(this.error);
+    }
+    asyncAndThrough(_f) {
+        return errAsync(this.error);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    asyncMap(_f) {
+        return errAsync(this.error);
+    }
+    unwrapOr(v) {
+        return v;
+    }
+    match(_ok, err) {
+        return err(this.error);
+    }
+    safeUnwrap() {
+        const error = this.error;
+        return (function* () {
+            yield err(error);
+            throw new Error('Do not use this generator out of `safeTry`');
+        })();
+    }
+    _unsafeUnwrap(config) {
+        throw createNeverThrowError('Called `_unsafeUnwrap` on an Err', this, config);
+    }
+    _unsafeUnwrapErr(_) {
+        return this.error;
+    }
+}
+Result.fromThrowable;
+
+export { Err, Ok, Result, ResultAsync, err, errAsync, ok };

package/dist/node_modules/.pnpm/uncrypto@0.1.3/node_modules/uncrypto/dist/crypto.web.js

@@ -0,0 +1,6 @@
+'use strict';
+
+const webCrypto = globalThis.crypto;
+const subtle = webCrypto.subtle;
+
+exports.subtle = subtle;

package/dist/node_modules/.pnpm/uncrypto@0.1.3/node_modules/uncrypto/dist/crypto.web.mjs

@@ -0,0 +1,4 @@
+const webCrypto = globalThis.crypto;
+const subtle = webCrypto.subtle;
+
+export { subtle };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "12.0.0",
+  "version": "13.0.0",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -84,15 +84,18 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@clerk/nextjs": "^6.19.4",
+    "@clerk/nextjs": "^6.39.0",
     "@prisma/client": "^6.17.1",
-    "next": "16.0.10",
+    "@upstash/redis": "^1.34.0",
+    "@upstash/qstash": "^2.7.0",
+    "@upstash/lock": "^0.2.1",
+    "next": "16.1.6",
     "prisma": "^6.17.1",
     "stripe": "20.0.0",
-    "svix": "^1.81.0",
-    "zod": "^4.1.12",
-    "@windrun-huaiin/third-ui": "^12.0.0",
-    "@windrun-huaiin/lib": "^12.0.0"
+    "svix": "^1.86.0",
+    "zod": "^4.3.6",
+    "@windrun-huaiin/lib": "^13.0.0",
+    "@windrun-huaiin/third-ui": "^13.0.0"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",
@@ -100,16 +103,16 @@
     "@rollup/plugin-node-resolve": "16.0.1",
     "@rollup/plugin-typescript": "12.1.4",
     "rollup": "4.46.2",
-    "@types/node": "22.17.2",
+    "@types/node": "^25.3.2",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
-    "@clerk/nextjs": "^6.19.4",
+    "@clerk/nextjs": "^6.39.0",
     "@prisma/client": "^6.17.1",
-    "next": "16.0.10",
+    "next": "16.1.6",
     "prisma": "^6.17.1",
     "stripe": "20.0.0",
-    "svix": "^1.81.0"
+    "svix": "^1.86.0"
   },
   "publishConfig": {
     "access": "public"

package/src/lib/index.ts

@@ -4,3 +4,5 @@ export * from './fingerprint-config';
 export * from './credit-init';
 export * from './stripe-config';
 export * from './auth-utils';
+export * from './upstash-config';
+export * from './upstash';

package/src/lib/upstash/index.ts

@@ -0,0 +1,6 @@
+export * from './redis-lock';
+export * from './redis-like';
+export * from './redis-favorite';
+export * from './redis-counter';
+export * from './redis-structures';
+export * from './qstash';

package/src/lib/upstash/qstash.ts

@@ -0,0 +1,157 @@
+import { Receiver } from '@upstash/qstash';
+import { getQstash } from '../upstash-config';
+
+let cachedReceiver: Receiver | null = null;
+let receiverInitAttempted = false;
+
+const isTruthy = (value: string | undefined): boolean =>
+  value === '1' || value === 'true' || value === 'TRUE';
+
+const shouldSkipVerify = (): boolean =>
+  process.env.NODE_ENV === 'development' && isTruthy(process.env.SKIP_UPSTASH_QSTASH_VERIFY);
+
+const getReceiver = (): Receiver | null => {
+  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;
+};
+
+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 const publishMessage = async (options: PublishMessageOptions): Promise<string | null> => {
+  const client = getQstash();
+  if (!client) {
+    return null;
+  }
+
+  const result = await (client as any).publishJSON({
+    url: options.url,
+    body: options.body,
+  });
+  return typeof result === 'string' ? result : result?.messageId ?? null;
+};
+
+/**
+ * Publish a delayed message. Returns message id or null if QStash is unavailable.
+ */
+export const publishDelayedMessage = async (
+  options: PublishMessageOptions & { delaySec: number }
+): Promise<string | null> => {
+  const client = getQstash();
+  if (!client) {
+    return null;
+  }
+
+  const result = await (client as any).publishJSON({
+    url: options.url,
+    body: options.body,
+    delay: options.delaySec,
+  });
+  return typeof result === 'string' ? result : result?.messageId ?? null;
+};
+
+export interface ScheduleMessageOptions extends PublishMessageOptions {
+  cron: string;
+}
+
+/**
+ * Schedule a recurring message. Returns schedule id or null if QStash is unavailable.
+ */
+export const scheduleMessage = async (options: ScheduleMessageOptions): Promise<string | null> => {
+  const client = getQstash();
+  if (!client) {
+    return null;
+  }
+
+  const anyClient = client as any;
+  const result =
+    (await anyClient.schedules?.create?.({
+      url: options.url,
+      body: options.body,
+      cron: options.cron,
+    })) ??
+    (await anyClient.publishJSON?.({
+      url: options.url,
+      body: options.body,
+      cron: options.cron,
+    }));
+
+  return typeof result === 'string' ? result : result?.scheduleId ?? result?.id ?? null;
+};
+
+/**
+ * Cancel a scheduled message. Returns false if QStash is unavailable.
+ */
+export const cancelSchedule = async (scheduleId: string): Promise<boolean> => {
+  const client = getQstash();
+  if (!client) {
+    return false;
+  }
+
+  const anyClient = client as any;
+  if (anyClient.schedules?.delete) {
+    await anyClient.schedules.delete(scheduleId);
+    return true;
+  }
+  if (anyClient.schedules?.remove) {
+    await anyClient.schedules.remove(scheduleId);
+    return true;
+  }
+  return false;
+};
+
+export interface VerifyQstashOptions {
+  signature: string;
+  body: string;
+  url: string;
+}
+
+/**
+ * Verify QStash signature. Throws on failure in non-dev environments.
+ */
+export const verifyQstashSignature = async (options: VerifyQstashOptions): Promise<boolean> => {
+  if (shouldSkipVerify()) {
+    return true;
+  }
+
+  const receiver = getReceiver();
+  if (!receiver) {
+    throw new Error('QStash signing keys are missing');
+  }
+
+  const verifier = (receiver as any).verify ?? (receiver as any).verifySignature;
+  if (!verifier) {
+    throw new Error('QStash receiver verify method is unavailable');
+  }
+
+  await verifier.call(receiver, {
+    signature: options.signature,
+    body: options.body,
+    url: options.url,
+  });
+  return true;
+};