@cmtlyt/lingshu-toolkit 0.4.0 → 0.5.0

package/dist/shared/logger/index.d.ts

@@ -1,5 +1,10 @@
 type Logger = {
     [K in keyof Omit<Console, 'table'> as Console[K] extends (...args: any[]) => any ? K : never]: Console[K] extends (...args: [any, ...infer AS]) => infer R ? (fnName: string, ...args: AS) => R : never;
 };
+declare global {
+    var $$lingshu$$: {
+        disableLogger: boolean;
+    };
+}
 export declare const logger: Logger;
 export {};

package/dist/shared/logger/index.js

@@ -1,5 +1,6 @@
 const logger = new Proxy(console, {
     get (target, prop, receiver) {
+        if ((globalThis.$$lingshu$$ || {}).disableLogger) return ()=>void 0;
         const oldLog = Reflect.get(target, prop, receiver).bind(console);
         return (fnName, ...args)=>{
             oldLog(`[@cmtlyt/lingshu-toolkit#${fnName}]:`, ...args);

package/dist/shared/try-call/index.d.ts

@@ -0,0 +1,22 @@
+type TryCallResultValue<R, E> = Awaited<[E] extends [never] ? R : R | E>;
+type TryCallResult<R, E> = [R] extends [never] ? E : R extends PromiseLike<infer P> ? Promise<TryCallResultValue<P, E>> : TryCallResultValue<R, E>;
+type TryCallFinalArgs<R, E> = TryCallResultValue<R, E> | Error;
+/**
+ * 包装一个拦截错误的函数
+ *
+ * @platform web, node, webworker
+ *
+ * @param cb 回调函数
+ * @param onError 错误处理函数
+ */
+export declare function tryCallFunc<A extends any[], R, E = never>(cb: (...args: A) => R, onError?: ((err: any) => E) | null, onFinal?: (result: TryCallFinalArgs<R, E>) => void): (...args: A) => TryCallResult<R, E>;
+/**
+ * 尝试调用函数
+ *
+ * @platform web, node, webworker
+ *
+ * @param cb 回调函数
+ * @param onError 错误处理函数
+ */
+export declare function tryCall<R, E = never>(this: any, cb: () => R, onError?: ((err: any) => E) | null, onFinal?: (result: TryCallFinalArgs<R, E>) => void): TryCallResult<R, E>;
+export {};

package/dist/shared/try-call/index.js

@@ -0,0 +1,59 @@
+import { throwType } from "../throw-error/index.js";
+import { isFunction, isPromiseLike } from "../utils/verify.js";
+const EMPTY = Symbol('EMPTY');
+function tryCallFunc(cb, onError, onFinal) {
+    if (!isFunction(cb)) throwType('tryCallFunc', 'callback is not a function');
+    const catchFn = (self, ctx, error)=>{
+        if (isFunction(onError)) try {
+            ctx.errorResult = Reflect.apply(onError, self, [
+                error
+            ]);
+        } catch (err) {
+            ctx.error = err;
+        }
+        else ctx.error = error;
+        return ctx.errorResult;
+    };
+    const finallyFn = (self, ctx, result)=>{
+        try {
+            if (ctx.error !== EMPTY) throw ctx.error;
+        } finally{
+            if (isFunction(onFinal)) if (ctx.errorResult !== EMPTY) Reflect.apply(onFinal, self, [
+                ctx.errorResult
+            ]);
+            else if (ctx.error !== EMPTY) Reflect.apply(onFinal, self, [
+                ctx.error
+            ]);
+            else Reflect.apply(onFinal, self, [
+                result
+            ]);
+        }
+    };
+    return function(...args) {
+        const ctx = {
+            oriResult: EMPTY,
+            errorResult: EMPTY,
+            error: EMPTY
+        };
+        const asyncFn = async ()=>{
+            try {
+                ctx.oriResult = Reflect.apply(cb, this, args);
+                return ctx.oriResult;
+            } catch (error) {
+                return catchFn(this, ctx, error);
+            }
+        };
+        const fnPromise = asyncFn().catch((error)=>catchFn(this, ctx, error));
+        if (isPromiseLike(ctx.oriResult)) return fnPromise.then((result)=>{
+            finallyFn(this, ctx, result);
+            return result;
+        });
+        finallyFn(this, ctx, ctx.oriResult);
+        return ctx.oriResult !== EMPTY ? ctx.oriResult : ctx.errorResult;
+    };
+}
+function tryCall(cb, onError, onFinal) {
+    if (!isFunction(cb)) throwType('tryCall', 'callback is not a function');
+    return tryCallFunc(cb, onError, onFinal).call(this);
+}
+export { tryCall, tryCallFunc };

package/dist/shared/try-call/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/types/base.d.ts

@@ -7,5 +7,7 @@ export type Printify<T> = T extends any[] ? T : [T] extends [never] ? T : {
     [K in keyof T]: T[K];
 };
 export type PickRequired<T, K extends keyof T> = Printify<Omit<T, K> & Required<Pick<T, K>>>;
+export type Func<A extends any[], R = any> = (...args: A) => R;
 export type AnyFunc = (...args: any[]) => any;
 export type UnULCase<T extends string> = T extends `${infer F}${infer R}` ? `${Uppercase<F> | Lowercase<F>}${UnULCase<R>}` : Uppercase<T> | Lowercase<T>;
+export type Cast<X, Y> = X extends Y ? X : Y;

package/dist/shared/types/pack.d.ts

@@ -3,7 +3,7 @@ export type Pack<T> = {
     [__PACK__]: T;
 };
 export type Unpack<T extends Pack<any>> = T extends Pack<infer U> ? U : never;
-export type SafeUnpack<T extends Pack<any>> = T extends Pack<infer U> ? U : T;
+export type SafeUnpack<T> = T extends Pack<infer U> ? U : T;
 export type IsPack<T> = Pack<any> extends T ? true : false;
 export type HasPack<T> = (T extends any[] ? HasPack<T[number]> : IsPack<T>) extends false ? false : true;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmtlyt/lingshu-toolkit",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "main": "./dist/shared.js",
   "module": "./dist/shared.js",
@@ -53,11 +53,13 @@
     "@vitest/browser-playwright": "4.0.18",
     "@vitest/coverage-v8": "4.0.18",
     "@vitest/ui": "4.0.18",
+    "changelogithub": "^14.0.0",
     "cross-env": "^10.1.0",
     "esno": "^4.8.0",
     "husky": "^9.1.7",
     "jsdom": "^27.4.0",
     "lint-staged": "^16.2.7",
+    "msw": "^2.12.14",
     "playwright": "^1.58.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
@@ -78,7 +80,8 @@
       "version": ">=22.12.0"
     },
     "packageManager": {
-      "name": "pnpm"
+      "name": "pnpm",
+      "version": ">=10.2.0"
     }
   },
   "publishConfig": {