zcw-shared 1.21.0 → 1.23.0

package/dist/functions/tree/filterTree.js

@@ -0,0 +1,21 @@
+export function filterTree(tree, predicate, options = {}) {
+    const { childrenKey = 'children' } = options;
+    const items = Array.isArray(tree) ? tree : [tree];
+    const filter = (nodes) => {
+        const result = [];
+        for (const node of nodes) {
+            if (predicate(node)) {
+                const newNode = { ...node };
+                const children = node[childrenKey];
+                if (children && Array.isArray(children) && children.length > 0) {
+                    const filteredChildren = filter(children);
+                    newNode[childrenKey] = filteredChildren;
+                }
+                result.push(newNode);
+            }
+        }
+        return result;
+    };
+    return filter(items);
+}
+//# sourceMappingURL=filterTree.js.map

package/dist/functions/tree/filterTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterTree.js","sourceRoot":"","sources":["../../../src/functions/tree/filterTree.ts"],"names":[],"mappings":"AAwCA,MAAM,UAAU,UAAU,CACxB,IAAa,EACb,SAA+B,EAC/B,UAA6B,EAAE;IAE/B,MAAM,EAAE,WAAW,GAAG,UAAU,EAAE,GAAG,OAAO,CAAA;IAE5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAEjD,MAAM,MAAM,GAAG,CAAC,KAAU,EAAO,EAAE;QACjC,MAAM,MAAM,GAAQ,EAAE,CAAA;QAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,MAAM,OAAO,GAAQ,EAAE,GAAG,IAAI,EAAE,CAAA;gBAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,CAAA;gBAClC,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/D,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;oBACzC,OAAO,CAAC,WAAW,CAAC,GAAG,gBAAgB,CAAA;gBACzC,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,OAAY,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}

package/dist/functions/tree/findNode.d.ts

@@ -0,0 +1,4 @@
+export interface FindNodeOptions {
+    childrenKey?: string;
+}
+export declare function findNode<T extends Record<string, any>>(tree: T | T[], predicate: (node: T) => boolean, options?: FindNodeOptions): T | null;

package/dist/functions/tree/findNode.js

@@ -0,0 +1,21 @@
+export function findNode(tree, predicate, options = {}) {
+    const { childrenKey = 'children' } = options;
+    const items = Array.isArray(tree) ? tree : [tree];
+    const search = (nodes) => {
+        for (const node of nodes) {
+            if (predicate(node)) {
+                return node;
+            }
+            const children = node[childrenKey];
+            if (children && Array.isArray(children) && children.length > 0) {
+                const found = search(children);
+                if (found) {
+                    return found;
+                }
+            }
+        }
+        return null;
+    };
+    return search(items);
+}
+//# sourceMappingURL=findNode.js.map

package/dist/functions/tree/findNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findNode.js","sourceRoot":"","sources":["../../../src/functions/tree/findNode.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,QAAQ,CACtB,IAAa,EACb,SAA+B,EAC/B,UAA2B,EAAE;IAE7B,MAAM,EAAE,WAAW,GAAG,UAAU,EAAE,GAAG,OAAO,CAAA;IAE5C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAEjD,MAAM,MAAM,GAAG,CAAC,KAAU,EAAY,EAAE;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAA;YACb,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,CAAA;YAClC,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;gBAC9B,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC"}

package/dist/functions/tree/flattenTree.d.ts

@@ -0,0 +1,6 @@
+export interface FlattenTreeOptions {
+    childrenKey?: string;
+    addLevel?: boolean;
+    levelKey?: string;
+}
+export declare function flattenTree<T extends Record<string, any>>(tree: T | T[], options?: FlattenTreeOptions): T[];

package/dist/functions/tree/flattenTree.js

@@ -0,0 +1,21 @@
+export function flattenTree(tree, options = {}) {
+    const { childrenKey = 'children', addLevel = true, levelKey = 'level' } = options;
+    const result = [];
+    const items = Array.isArray(tree) ? tree : [tree];
+    const flatten = (nodes, level = 0) => {
+        for (const node of nodes) {
+            const { [childrenKey]: children, ...rest } = node;
+            const item = { ...rest };
+            if (addLevel) {
+                item[levelKey] = level;
+            }
+            result.push(item);
+            if (children && Array.isArray(children) && children.length > 0) {
+                flatten(children, level + 1);
+            }
+        }
+    };
+    flatten(items);
+    return result;
+}
+//# sourceMappingURL=flattenTree.js.map

package/dist/functions/tree/flattenTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenTree.js","sourceRoot":"","sources":["../../../src/functions/tree/flattenTree.ts"],"names":[],"mappings":"AAqCA,MAAM,UAAU,WAAW,CACzB,IAAa,EACb,UAA8B,EAAE;IAEhC,MAAM,EACJ,WAAW,GAAG,UAAU,EACxB,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,OAAO,EACnB,GAAG,OAAO,CAAA;IAEX,MAAM,MAAM,GAAQ,EAAE,CAAA;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAEjD,MAAM,OAAO,GAAG,CAAC,KAAU,EAAE,QAAgB,CAAC,EAAE,EAAE;QAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;YAEjD,MAAM,IAAI,GAAQ,EAAE,GAAG,IAAI,EAAE,CAAA;YAC7B,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAA;YACxB,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,IAAS,CAAC,CAAA;YAEtB,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,OAAO,CAAC,KAAK,CAAC,CAAA;IAEd,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/functions/url/buildQueryString.d.ts

@@ -0,0 +1,5 @@
+export interface BuildQueryStringOptions {
+    prefix?: boolean;
+    skipNull?: boolean;
+}
+export declare function buildQueryString(params: Record<string, any>, options?: BuildQueryStringOptions): string;

package/dist/functions/url/buildQueryString.js

@@ -0,0 +1,15 @@
+export function buildQueryString(params, options = {}) {
+    const { prefix = false, skipNull = true } = options;
+    const pairs = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (skipNull && (value === null || value === undefined)) {
+            continue;
+        }
+        const encodedKey = encodeURIComponent(key);
+        const encodedValue = encodeURIComponent(String(value));
+        pairs.push(`${encodedKey}=${encodedValue}`);
+    }
+    const queryString = pairs.join('&');
+    return prefix && queryString ? `?${queryString}` : queryString;
+}
+//# sourceMappingURL=buildQueryString.js.map

package/dist/functions/url/buildQueryString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildQueryString.js","sourceRoot":"","sources":["../../../src/functions/url/buildQueryString.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,gBAAgB,CAC9B,MAA2B,EAC3B,UAAmC,EAAE;IAErC,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;IAEnD,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,QAAQ,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,EAAE,CAAC;YACxD,SAAQ;QACV,CAAC;QAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;QAC1C,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACtD,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,IAAI,YAAY,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACnC,OAAO,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAA;AAChE,CAAC"}

package/dist/functions/url/parseUrl.d.ts

@@ -0,0 +1,11 @@
+export interface ParsedUrl {
+    protocol: string;
+    host: string;
+    hostname: string;
+    port: string;
+    pathname: string;
+    search: string;
+    query: Record<string, string>;
+    hash: string;
+}
+export declare function parseUrl(url: string): ParsedUrl;

package/dist/functions/url/parseUrl.js

@@ -0,0 +1,34 @@
+export function parseUrl(url) {
+    const urlPattern = /^(([^:/?#]+):)?(\/\/([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/;
+    const match = url.match(urlPattern);
+    if (!match) {
+        throw new Error('Invalid URL');
+    }
+    const protocol = match[2] ? `${match[2]}:` : '';
+    const host = match[4] || '';
+    const pathname = match[5] || '/';
+    const search = match[6] || '';
+    const hash = match[8] ? `#${match[9]}` : '';
+    const hostParts = host.split(':');
+    const hostname = hostParts[0];
+    const port = hostParts[1] || '';
+    const query = {};
+    if (match[7]) {
+        const pairs = match[7].split('&');
+        for (const pair of pairs) {
+            const [key, value] = pair.split('=');
+            query[decodeURIComponent(key)] = decodeURIComponent(value || '');
+        }
+    }
+    return {
+        protocol,
+        host,
+        hostname,
+        port,
+        pathname,
+        search,
+        query,
+        hash
+    };
+}
+//# sourceMappingURL=parseUrl.js.map

package/dist/functions/url/parseUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseUrl.js","sourceRoot":"","sources":["../../../src/functions/url/parseUrl.ts"],"names":[],"mappings":"AAgCA,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,UAAU,GAAG,6DAA6D,CAAA;IAChF,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAG3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IAC7B,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAG/B,MAAM,KAAK,GAA2B,EAAE,CAAA;IACxC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACpC,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,MAAM;QACN,KAAK;QACL,IAAI;KACL,CAAA;AACH,CAAC"}

package/dist/functions/utils/cachedAsync.d.ts

@@ -0,0 +1,27 @@
+import { LRUCache } from './LRUCache';
+export interface CachedAsyncOptions {
+    keyGenerator?: (...args: any[]) => string;
+    ttl?: number;
+    maxSize?: number;
+    cache?: LRUCache<string, any>;
+    cacheErrors?: boolean;
+    debug?: boolean;
+    console?: {
+        log: (...args: any[]) => void;
+        warn: (...args: any[]) => void;
+    };
+}
+export interface CachedAsyncFunction<T extends (...args: any[]) => Promise<any>> {
+    (...args: Parameters<T>): ReturnType<T>;
+    clear: () => void;
+    delete: (...args: Parameters<T>) => void;
+    has: (...args: Parameters<T>) => boolean;
+    getStats: () => {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+}
+export declare function cachedAsync<T extends (...args: any[]) => Promise<any>>(fn: T, options?: CachedAsyncOptions): CachedAsyncFunction<T>;
+export declare function createCachedAsyncWithCache(cache: LRUCache<string, any>): <T extends (...args: any[]) => Promise<any>>(fn: T, options?: Omit<CachedAsyncOptions, "cache">) => CachedAsyncFunction<T>;

package/dist/functions/utils/cachedAsync.js

@@ -0,0 +1,123 @@
+import { LRUCache } from './LRUCache';
+function defaultKeyGenerator(...args) {
+    try {
+        return JSON.stringify(args);
+    }
+    catch (error) {
+        return args.map(arg => String(arg)).join('_');
+    }
+}
+export function cachedAsync(fn, options = {}) {
+    const { keyGenerator = defaultKeyGenerator, ttl = 0, maxSize = 500, cache: customCache, cacheErrors = false, debug = false, console: customConsole } = options;
+    const cache = customCache || new LRUCache({
+        capacity: maxSize,
+        debug,
+        console: customConsole
+    });
+    const pendingRequests = new Map();
+    let hits = 0;
+    let misses = 0;
+    const log = (message) => {
+        if (debug && customConsole) {
+            customConsole.log(`[CachedAsync] ${message}`);
+        }
+    };
+    const warn = (message) => {
+        if (debug && customConsole) {
+            customConsole.warn(`[CachedAsync] ${message}`);
+        }
+    };
+    function isExpired(entry) {
+        if (!entry.expiresAt) {
+            return false;
+        }
+        return Date.now() > entry.expiresAt;
+    }
+    async function cachedFunction(...args) {
+        const cacheKey = keyGenerator(...args);
+        const cachedEntry = cache.get(cacheKey);
+        if (cachedEntry && !isExpired(cachedEntry)) {
+            hits++;
+            log(`Cache HIT for key: ${cacheKey}`);
+            if (cachedEntry.isError) {
+                throw cachedEntry.value;
+            }
+            return cachedEntry.value;
+        }
+        if (cachedEntry && isExpired(cachedEntry)) {
+            cache.delete(cacheKey);
+            log(`Cache EXPIRED for key: ${cacheKey}`);
+        }
+        misses++;
+        log(`Cache MISS for key: ${cacheKey}`);
+        const pendingRequest = pendingRequests.get(cacheKey);
+        if (pendingRequest) {
+            log(`Reusing pending request for key: ${cacheKey}`);
+            return pendingRequest;
+        }
+        const promise = fn(...args)
+            .then((result) => {
+            const entry = {
+                value: result,
+                expiresAt: ttl > 0 ? Date.now() + ttl : undefined,
+                isError: false
+            };
+            cache.put(cacheKey, entry);
+            log(`Cache SET for key: ${cacheKey}`);
+            pendingRequests.delete(cacheKey);
+            return result;
+        })
+            .catch((error) => {
+            pendingRequests.delete(cacheKey);
+            if (cacheErrors) {
+                const entry = {
+                    value: error,
+                    expiresAt: ttl > 0 ? Date.now() + ttl : undefined,
+                    isError: true
+                };
+                cache.put(cacheKey, entry);
+                log(`Cache SET ERROR for key: ${cacheKey}`);
+            }
+            else {
+                log(`Error not cached for key: ${cacheKey}`);
+            }
+            throw error;
+        });
+        pendingRequests.set(cacheKey, promise);
+        return promise;
+    }
+    cachedFunction.clear = () => {
+        cache.clear();
+        pendingRequests.clear();
+        hits = 0;
+        misses = 0;
+        log('All cache cleared');
+    };
+    cachedFunction.delete = (...args) => {
+        const cacheKey = keyGenerator(...args);
+        cache.delete(cacheKey);
+        pendingRequests.delete(cacheKey);
+        log(`Cache deleted for key: ${cacheKey}`);
+    };
+    cachedFunction.has = (...args) => {
+        const cacheKey = keyGenerator(...args);
+        const entry = cache.get(cacheKey);
+        return entry !== undefined && !isExpired(entry);
+    };
+    cachedFunction.getStats = () => {
+        const totalRequests = hits + misses;
+        return {
+            size: cache.size,
+            hits,
+            misses,
+            hitRate: totalRequests > 0 ? hits / totalRequests : 0
+        };
+    };
+    return cachedFunction;
+}
+export function createCachedAsyncWithCache(cache) {
+    return function (fn, options = {}) {
+        return cachedAsync(fn, { ...options, cache });
+    };
+}
+//# sourceMappingURL=cachedAsync.js.map

package/dist/functions/utils/cachedAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cachedAsync.js","sourceRoot":"","sources":["../../../src/functions/utils/cachedAsync.ts"],"names":[],"mappings":"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"}

package/dist/functions/utils/errorManager.d.ts

@@ -0,0 +1,63 @@
+import type { CreateReactive } from '../../../types/reactive';
+export interface ErrorCode {
+    code: string;
+    message: Record<string, string>;
+    httpStatus?: number;
+    level?: 'info' | 'warning' | 'error' | 'fatal';
+    metadata?: Record<string, any>;
+}
+export interface ErrorCategory {
+    name: string;
+    prefix: string;
+    errors: ErrorCode[];
+}
+export interface ErrorManagerConfig {
+    defaultLocale: string;
+    fallbackLocale?: string;
+    categories: ErrorCategory[];
+}
+export interface ErrorManagerDeps {
+    createReactive: CreateReactive;
+    log: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+}
+export declare class BusinessError extends Error {
+    readonly code: string;
+    readonly httpStatus: number;
+    readonly level: 'info' | 'warning' | 'error' | 'fatal';
+    readonly metadata: Record<string, any>;
+    readonly params?: Record<string, any>;
+    constructor(code: string, message: string, options?: {
+        httpStatus?: number;
+        level?: 'info' | 'warning' | 'error' | 'fatal';
+        metadata?: Record<string, any>;
+        params?: Record<string, any>;
+    });
+    toJSON(): {
+        name: string;
+        code: string;
+        message: string;
+        httpStatus: number;
+        level: "error" | "info" | "warning" | "fatal";
+        metadata: Record<string, any>;
+        params: Record<string, any> | undefined;
+    };
+}
+export interface ErrorManagerInstance {
+    locale: string;
+    getMessage: (code: string, params?: Record<string, any>) => string;
+    createError: (code: string, params?: Record<string, any>) => BusinessError;
+    throwError: (code: string, params?: Record<string, any>) => never;
+    hasError: (code: string) => boolean;
+    getErrorDefinition: (code: string) => ErrorCode | undefined;
+    getAllErrors: () => ErrorCode[];
+    getCategoryErrors: (prefix: string) => ErrorCode[];
+    getCategories: () => ErrorCategory[];
+    setLocale: (locale: string) => void;
+    addError: (categoryPrefix: string, error: ErrorCode) => void;
+    addCategory: (category: ErrorCategory) => void;
+    subscribe: (listener: () => void) => () => void;
+    dispose: () => void;
+}
+export declare function createErrorManager(config: ErrorManagerConfig, deps: ErrorManagerDeps): ErrorManagerInstance;
+export declare function defineErrorCodes<T extends Record<string, string>>(codes: T): T;

package/dist/functions/utils/errorManager.js

@@ -0,0 +1,199 @@
+export class BusinessError extends Error {
+    code;
+    httpStatus;
+    level;
+    metadata;
+    params;
+    constructor(code, message, options) {
+        super(message);
+        this.name = 'BusinessError';
+        this.code = code;
+        this.httpStatus = options?.httpStatus ?? 500;
+        this.level = options?.level ?? 'error';
+        this.metadata = options?.metadata ?? {};
+        this.params = options?.params;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            httpStatus: this.httpStatus,
+            level: this.level,
+            metadata: this.metadata,
+            params: this.params
+        };
+    }
+}
+export function createErrorManager(config, deps) {
+    if (!config.defaultLocale) {
+        throw new Error('defaultLocale is required');
+    }
+    if (!config.categories || config.categories.length === 0) {
+        throw new Error('categories is required and cannot be empty');
+    }
+    const errorMap = new Map();
+    const categoryMap = new Map();
+    config.categories.forEach(category => {
+        categoryMap.set(category.prefix, category);
+        category.errors.forEach(error => {
+            errorMap.set(error.code, error);
+        });
+    });
+    const state = {
+        locale: config.defaultLocale,
+        fallbackLocale: config.fallbackLocale || config.defaultLocale,
+        categories: config.categories
+    };
+    const reactiveState = deps.createReactive(state, {
+        subscribers: new Set(),
+        notify: () => {
+        },
+        subscribe: (listener) => {
+            reactiveState.subscribers.add(listener);
+            return () => reactiveState.subscribers.delete(listener);
+        },
+        dispose: () => reactiveState.subscribers.clear(),
+        createProxy: (target, reactiveDeps) => new Proxy(target, {
+            get(target, property) {
+                if (property === 'subscribe' || property === 'notify' ||
+                    property === 'dispose' || property === 'subscribers') {
+                    return reactiveDeps[property];
+                }
+                return target[property];
+            },
+            set(target, property, value) {
+                ;
+                target[property] = value;
+                if (property === 'locale') {
+                    reactiveDeps.notify();
+                    deps.log(`语言已切换到: ${value}`);
+                }
+                return true;
+            },
+            deleteProperty(target, property) {
+                if (property in target) {
+                    delete target[property];
+                    reactiveDeps.notify();
+                    return true;
+                }
+                return false;
+            }
+        }),
+        getChangePath: (target, property) => [String(property)]
+    });
+    function replaceParams(message, params) {
+        if (!params) {
+            return message;
+        }
+        return message.replace(/\{(\w+)\}/g, (match, key) => {
+            return params[key] !== undefined ? String(params[key]) : match;
+        });
+    }
+    function getMessage(code, params) {
+        const errorDef = errorMap.get(code);
+        if (!errorDef) {
+            deps.warn(`Error code "${code}" not found`);
+            return code;
+        }
+        let message = errorDef.message[reactiveState.locale];
+        if (!message && reactiveState.fallbackLocale !== reactiveState.locale) {
+            message = errorDef.message[reactiveState.fallbackLocale];
+        }
+        if (!message) {
+            deps.warn(`Message for error code "${code}" not found in locale "${reactiveState.locale}"`);
+            return code;
+        }
+        return replaceParams(message, params);
+    }
+    function createError(code, params) {
+        const errorDef = errorMap.get(code);
+        if (!errorDef) {
+            deps.warn(`Error code "${code}" not found`);
+            return new BusinessError(code, code, {
+                httpStatus: 500,
+                level: 'error'
+            });
+        }
+        const message = getMessage(code, params);
+        return new BusinessError(code, message, {
+            httpStatus: errorDef.httpStatus,
+            level: errorDef.level,
+            metadata: errorDef.metadata,
+            params
+        });
+    }
+    function throwError(code, params) {
+        throw createError(code, params);
+    }
+    function hasError(code) {
+        return errorMap.has(code);
+    }
+    function getErrorDefinition(code) {
+        return errorMap.get(code);
+    }
+    function getAllErrors() {
+        return Array.from(errorMap.values());
+    }
+    function getCategoryErrors(prefix) {
+        const category = categoryMap.get(prefix);
+        return category ? category.errors : [];
+    }
+    function getCategories() {
+        return reactiveState.categories;
+    }
+    function setLocale(locale) {
+        reactiveState.locale = locale;
+    }
+    function addError(categoryPrefix, error) {
+        const category = categoryMap.get(categoryPrefix);
+        if (!category) {
+            deps.warn(`Category "${categoryPrefix}" not found`);
+            return;
+        }
+        if (errorMap.has(error.code)) {
+            deps.warn(`Error code "${error.code}" already exists`);
+            return;
+        }
+        category.errors.push(error);
+        errorMap.set(error.code, error);
+        deps.log(`已添加错误码: ${error.code}`);
+    }
+    function addCategory(category) {
+        if (categoryMap.has(category.prefix)) {
+            deps.warn(`Category "${category.prefix}" already exists`);
+            return;
+        }
+        reactiveState.categories.push(category);
+        categoryMap.set(category.prefix, category);
+        category.errors.forEach(error => {
+            errorMap.set(error.code, error);
+        });
+        deps.log(`已添加错误分类: ${category.name} (${category.prefix})`);
+    }
+    return {
+        get locale() {
+            return reactiveState.locale;
+        },
+        set locale(value) {
+            setLocale(value);
+        },
+        getMessage,
+        createError,
+        throwError,
+        hasError,
+        getErrorDefinition,
+        getAllErrors,
+        getCategoryErrors,
+        getCategories,
+        setLocale,
+        addError,
+        addCategory,
+        subscribe: reactiveState.subscribe,
+        dispose: reactiveState.dispose
+    };
+}
+export function defineErrorCodes(codes) {
+    return codes;
+}
+//# sourceMappingURL=errorManager.js.map

package/dist/functions/utils/errorManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorManager.js","sourceRoot":"","sources":["../../../src/functions/utils/errorManager.ts"],"names":[],"mappings":"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"}

package/dist/functions/utils/useAltool.d.ts

@@ -0,0 +1,39 @@
+import type { ChildProcess } from '../../../references/node.d';
+import type { AltoolAuth, AltoolAppType, AltoolOutputFormat, AltoolBaseResult, AltoolUploadOptions, AltoolValidateOptions, AltoolValidateResult, AltoolAppInfoOptions, AppInfo } from '../../../types/altool.d';
+export interface AltoolConfig {
+    altoolPath: string;
+    defaultAuth?: AltoolAuth;
+    defaultAppType?: AltoolAppType;
+    defaultOutputFormat?: AltoolOutputFormat;
+    exec: ChildProcess['exec'];
+}
+export interface AltoolState {
+    initialized: boolean;
+    available: boolean;
+    version: string | null;
+    loading: boolean;
+    error: string | null;
+    lastResult: AltoolBaseResult | null;
+}
+export interface AltoolActions {
+    initialize: () => Promise<void>;
+    upload: (options: Omit<AltoolUploadOptions, 'auth'> & {
+        auth?: AltoolAuth;
+    }) => Promise<string>;
+    validate: (options: Omit<AltoolValidateOptions, 'auth'> & {
+        auth?: AltoolAuth;
+    }) => Promise<AltoolValidateResult>;
+    getInfo: (options: Omit<AltoolAppInfoOptions, 'auth'> & {
+        auth?: AltoolAuth;
+    }) => Promise<AppInfo[]>;
+    reset: () => void;
+    clearError: () => void;
+}
+export declare function useAltool(config: AltoolConfig): {
+    state: AltoolState;
+    isReady: () => boolean;
+    hasError: () => boolean;
+    canOperate: () => boolean;
+    actions: AltoolActions;
+    subscribe: (listener: () => void) => () => void;
+};