@taicode/common-server 3.7.12 → 3.8.0

package/output/app/shutdown.test.js

@@ -0,0 +1,149 @@
+import { describe, expect, it } from 'vitest';
+import { defineServer } from './define-server.js';
+import { SHUTDOWN_ORDER } from './shutdown.js';
+const P1_OPT_OUT = {
+    context: false,
+    response: false,
+    cors: false,
+    schema: false,
+    'rate-limit': false,
+    auth: false,
+    openapi: false,
+    database: false,
+};
+const DUMMY_ERRORS = {
+    UserError: class extends Error {
+    },
+    SystemError: class extends Error {
+    },
+};
+function createTestLog() {
+    const errors = [];
+    const log = {
+        debug: () => undefined,
+        info: () => undefined,
+        warn: () => undefined,
+        error: (obj) => {
+            errors.push(obj);
+        },
+    };
+    return { log, errors };
+}
+function createBaseOptions(overrides = {}) {
+    return {
+        serviceName: 'test',
+        title: 'Test',
+        description: 'Test service',
+        errors: DUMMY_ERRORS,
+        config: { loadConfig: () => ({ debug: false, port: 0 }) },
+        modules: { ...P1_OPT_OUT },
+        serverOptions: { port: 0, host: '127.0.0.1' },
+        signal: false,
+        createServices: () => ({}),
+        registerRouters: () => undefined,
+        ...overrides,
+    };
+}
+function createRecordingShutdownModule(record, throwOn) {
+    const createStep = (name) => () => {
+        record.push(name);
+        if (name === throwOn) {
+            throw new Error(`boom:${name}`);
+        }
+    };
+    const shutdown = {
+        stopProducers: createStep('stopProducers'),
+        unsubscribeConfig: createStep('unsubscribeConfig'),
+        disposeConfig: createStep('disposeConfig'),
+        disposeServices: createStep('disposeServices'),
+        disposeClients: createStep('disposeClients'),
+        disposeRedis: createStep('disposeRedis'),
+        disposeDb: createStep('disposeDb'),
+    };
+    return { name: 'env', shutdown };
+}
+describe('关闭 7 步', () => {
+    it('顺序写死、beforeShutdown 在最前', async () => {
+        const record = [];
+        const app = await defineServer(createBaseOptions({
+            modules: { ...P1_OPT_OUT, env: createRecordingShutdownModule(record) },
+            beforeShutdown: () => {
+                record.push('beforeShutdown');
+            },
+        }));
+        await app.close();
+        expect(record).toEqual(['beforeShutdown', ...SHUTDOWN_ORDER]);
+    });
+    it('单步抛错不阻断后续，且聚合上报（不吞第一个错误）', async () => {
+        const record = [];
+        const { log, errors } = createTestLog();
+        const app = await defineServer(createBaseOptions({
+            log,
+            modules: { ...P1_OPT_OUT, env: createRecordingShutdownModule(record, 'disposeConfig') },
+            beforeShutdown: () => {
+                record.push('beforeShutdown');
+                throw new Error('boom:beforeShutdown');
+            },
+        }));
+        await app.close();
+        // disposeConfig 抛错后，4~7 步仍然执行
+        expect(record).toEqual(['beforeShutdown', ...SHUTDOWN_ORDER]);
+        expect(errors).toHaveLength(1);
+        const aggregated = errors[0];
+        expect(aggregated.count).toBe(2);
+        expect(aggregated.errors).toHaveLength(2);
+    });
+    it('shutdown 选项整体覆盖默认关闭流程', async () => {
+        const record = [];
+        const app = await defineServer(createBaseOptions({
+            modules: { ...P1_OPT_OUT, env: createRecordingShutdownModule(record) },
+            beforeShutdown: () => {
+                record.push('beforeShutdown');
+            },
+            shutdown: () => {
+                record.push('custom');
+            },
+        }));
+        await app.close();
+        expect(record).toEqual(['custom']);
+    });
+    it('模块 hooks.beforeShutdown 生效（调用方选项优先）', async () => {
+        const record = [];
+        const module = {
+            name: 'env',
+            hooks: {
+                beforeShutdown: () => {
+                    record.push('module-before');
+                },
+            },
+            shutdown: {
+                stopProducers: () => {
+                    record.push('stopProducers');
+                },
+            },
+        };
+        const app = await defineServer(createBaseOptions({ modules: { ...P1_OPT_OUT, env: module } }));
+        await app.close();
+        expect(record).toEqual(['module-before', 'stopProducers']);
+    });
+    it('默认 disposeServices 用 Promise.allSettled 释放 services（单服务抛错不影响其它）', async () => {
+        let disposed = 0;
+        const app = await defineServer(createBaseOptions({
+            createServices: () => ({
+                a: {
+                    dispose: () => {
+                        disposed += 1;
+                    },
+                },
+                b: {
+                    dispose: () => {
+                        disposed += 1;
+                        throw new Error('service dispose failed');
+                    },
+                },
+            }),
+        }));
+        await app.close();
+        expect(disposed).toBe(2);
+    });
+});

package/output/app/signal.d.ts

@@ -0,0 +1,12 @@
+import type { FastifyInstance } from 'fastify';
+import type { LoggerLike } from './types.js';
+/**
+ * 内置信号处理（design §4.1 第 15 步尾部）。
+ *
+ * `SIGTERM` / `SIGINT` / `uncaughtException` / `unhandledRejection` ⇒ `app.close()`（触发 onClose
+ * 的关闭 7 步）⇒ `process.exit(0/1)`。可通过 `signal: false` 整体关掉（测试 / 嵌入场景）。
+ *
+ * @returns detach 函数（移除本次注册的监听器）
+ */
+export declare function attachSignalHandlers(app: FastifyInstance, log: LoggerLike): () => void;
+//# sourceMappingURL=signal.d.ts.map

package/output/app/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../source/app/signal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,IAAI,CA2CtF"}

package/output/app/signal.js

@@ -0,0 +1,45 @@
+/**
+ * 内置信号处理（design §4.1 第 15 步尾部）。
+ *
+ * `SIGTERM` / `SIGINT` / `uncaughtException` / `unhandledRejection` ⇒ `app.close()`（触发 onClose
+ * 的关闭 7 步）⇒ `process.exit(0/1)`。可通过 `signal: false` 整体关掉（测试 / 嵌入场景）。
+ *
+ * @returns detach 函数（移除本次注册的监听器）
+ */
+export function attachSignalHandlers(app, log) {
+    let closing = false;
+    const shutdown = (signal, code) => {
+        if (closing) {
+            return;
+        }
+        closing = true;
+        log.info({ signal }, '[server] received shutdown signal');
+        app.close().then(() => {
+            log.info({ signal }, '[server] shutdown complete');
+            process.exit(code);
+        }, (error) => {
+            log.error({ error }, '[server] error during shutdown');
+            process.exit(1);
+        });
+    };
+    const onSigterm = () => shutdown('SIGTERM', 0);
+    const onSigint = () => shutdown('SIGINT', 0);
+    const onUncaught = (error) => {
+        log.error({ error }, '[server] uncaught exception');
+        shutdown('uncaughtException', 1);
+    };
+    const onRejection = (reason) => {
+        log.error({ reason }, '[server] unhandled rejection');
+        shutdown('unhandledRejection', 1);
+    };
+    process.on('SIGTERM', onSigterm);
+    process.on('SIGINT', onSigint);
+    process.on('uncaughtException', onUncaught);
+    process.on('unhandledRejection', onRejection);
+    return () => {
+        process.off('SIGTERM', onSigterm);
+        process.off('SIGINT', onSigint);
+        process.off('uncaughtException', onUncaught);
+        process.off('unhandledRejection', onRejection);
+    };
+}

package/output/app/steps.d.ts

@@ -0,0 +1,17 @@
+import type { ServerMode } from './types.js';
+/**
+ * 固定 15 步（design §4.1）——**顺序写死在数组里**。
+ *
+ * 模块只能往这些「既定槽位」里填实现，不得新增步骤、不得重排、不得改变 §4.1 的依赖偏序。
+ */
+export declare const STEP_ORDER: readonly ["createFastify", "setupCompilers", "database.createClient", "createRedis", "initGlobalConfig", "initClients", "registerCorePlugins", "createServices", "initServices", "backgroundWorkers", "registerRouters", "onClose", "ready", "afterReady", "listen"];
+export type StepName = (typeof STEP_ORDER)[number];
+/**
+ * 各模式跳过的步骤（design §4.1 / §4.3）。
+ *
+ * - `test`：关后台 worker 与 ready 后动作（第 10 / 14 步）。
+ * - `openapi-build`：跳过 [5,6,9,10,14,15] 与一切连库/连 Redis 的动作，但仍保留 [3,4]（10-3：
+ *   P1 沿用四家现状「不跳过第 3/4 步」，跳过错步留 P2），并保留 [7,8,11] 以保证 `app.swagger()` 完整。
+ */
+export declare const SKIP_BY_MODE: Record<ServerMode, readonly StepName[]>;
+//# sourceMappingURL=steps.d.ts.map

package/output/app/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../source/app/steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;GAIG;AACH,eAAO,MAAM,UAAU,sQAgBb,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,QAAQ,EAAE,CAWhE,CAAA"}

package/output/app/steps.js

@@ -0,0 +1,41 @@
+/**
+ * 固定 15 步（design §4.1）——**顺序写死在数组里**。
+ *
+ * 模块只能往这些「既定槽位」里填实现，不得新增步骤、不得重排、不得改变 §4.1 的依赖偏序。
+ */
+export const STEP_ORDER = [
+    'createFastify',
+    'setupCompilers',
+    'database.createClient',
+    'createRedis',
+    'initGlobalConfig',
+    'initClients',
+    'registerCorePlugins',
+    'createServices',
+    'initServices',
+    'backgroundWorkers',
+    'registerRouters',
+    'onClose',
+    'ready',
+    'afterReady',
+    'listen',
+];
+/**
+ * 各模式跳过的步骤（design §4.1 / §4.3）。
+ *
+ * - `test`：关后台 worker 与 ready 后动作（第 10 / 14 步）。
+ * - `openapi-build`：跳过 [5,6,9,10,14,15] 与一切连库/连 Redis 的动作，但仍保留 [3,4]（10-3：
+ *   P1 沿用四家现状「不跳过第 3/4 步」，跳过错步留 P2），并保留 [7,8,11] 以保证 `app.swagger()` 完整。
+ */
+export const SKIP_BY_MODE = {
+    production: [],
+    test: ['backgroundWorkers', 'afterReady'],
+    'openapi-build': [
+        'initGlobalConfig',
+        'initClients',
+        'initServices',
+        'backgroundWorkers',
+        'afterReady',
+        'listen',
+    ],
+};

package/output/app/types.d.ts

@@ -0,0 +1,149 @@
+import type { Disposer } from '@taicode/common-base';
+import type { FastifyInstance, FastifyPluginAsync } from 'fastify';
+import type { ModuleAssembly } from './module.js';
+import type { ShutdownStepName } from './shutdown.js';
+import type { StepName } from './steps.js';
+/** 原生 Fastify 实例，原样返回（不包 `fastify-plugin`、不返回包装对象） */
+export type ServerInstance = FastifyInstance;
+export type ServerMode = 'production' | 'test' | 'openapi-build';
+/** 错误工厂：由各服务 `errors.ts` 的 `define()` 产出（`class extends Error`） */
+export type ErrorFactory = new (...args: never[]) => Error;
+export interface ErrorFactories {
+    UserError: ErrorFactory;
+    SystemError: ErrorFactory;
+}
+/** 运行时配置快照（对应各仓导出的 `config` 常量） */
+export interface RuntimeConfig {
+    debug: boolean;
+    port: number;
+}
+/**
+ * 配置模块端口（design §4.2）。`loadConfig` 必填；依赖数据层的服务才需要 `loadPostgresConfig`。
+ *
+ * 骨架不替调用方加载 env —— 请先自行调用 `loadEnvFiles()`（详见 `./env.js`）。
+ */
+export interface ConfigModule {
+    loadConfig: () => RuntimeConfig;
+    loadPostgresConfig?: () => unknown | Promise<unknown>;
+    resolveRedisUrl?: () => string | undefined;
+    resolveCachePrefix?: () => string | undefined;
+}
+/** 骨架只按 `(obj, msg)` 形态打日志；`app.log` 与 `@taicode/common-base` 的 `Logger` 都满足 */
+export interface LoggerLike {
+    debug: (obj: unknown, msg?: string) => void;
+    info: (obj: unknown, msg?: string) => void;
+    warn: (obj: unknown, msg?: string) => void;
+    error: (obj: unknown, msg?: string) => void;
+}
+/**
+ * 骨架**不操作** Redis 命令，只持有并在关闭时透传 dispose；
+ * 因此保持开放类型，各仓注入自己的客户端（如 node-redis）不受约束。
+ */
+export type RedisLike = unknown;
+export interface RedisHandle {
+    client: RedisLike;
+    dispose: () => Promise<void>;
+}
+export type DisposeFunction = () => unknown;
+export type UnsubscribeFunction = () => unknown;
+export interface GlobalConfigOptions {
+    redisUrl?: string;
+    channelPrefix?: string;
+}
+/** 贯穿步骤 5/6/8 的依赖上下文 */
+export interface DbContext<Db = unknown> {
+    db: Db;
+    redis?: RedisLike;
+    globalConfig: unknown;
+}
+export interface ServicesContext<S = unknown> {
+    services: S;
+}
+export interface InitContext<Db = unknown, S = unknown> extends DbContext<Db> {
+    services: S;
+}
+export interface WorkersContext<Db = unknown, S = unknown> extends DbContext<Db> {
+    services: S;
+    disposer: Disposer;
+}
+export interface ReadyContext<S = unknown> {
+    app: FastifyInstance;
+    services: S;
+}
+export interface ServerOptions {
+    port: number;
+    host?: string;
+}
+export type ResolveMessage = (type: string, context: unknown, explicit?: string) => string | undefined;
+export type MapStatus = (type: string) => number | null;
+/** 骨架内部持有的运行时句柄（配置 / 关闭流程用） */
+export interface RuntimeState {
+    app?: FastifyInstance;
+    db?: unknown;
+    redis?: RedisHandle;
+    globalConfig?: unknown;
+    services?: unknown;
+    disposer: Disposer;
+    unsubscribe?: UnsubscribeFunction;
+    disposeConfig?: DisposeFunction;
+}
+/** 每个步骤执行时拿到的上下文（`log` 在 `createFastify` 之后默认降级/升级为 `app.log`） */
+export interface StepContext {
+    options: DefineServerOptions;
+    state: RuntimeState;
+    log: LoggerLike;
+}
+export type StepRunner = (ctx: StepContext) => unknown | Promise<unknown>;
+export type StepImplementations = Record<StepName, StepRunner>;
+export type ShutdownRunner = (ctx: StepContext) => unknown | Promise<unknown>;
+export type ShutdownImplementations = Record<ShutdownStepName, ShutdownRunner>;
+/** 模块可贡献的生命周期 hook（design §4.2） */
+export interface ServerHooks {
+    beforeShutdown?: () => unknown | Promise<unknown>;
+    shutdown?: (signal: string) => unknown | Promise<unknown>;
+    disposeServices?: (ctx: ServicesContext) => unknown | Promise<unknown>;
+    disposeClients?: () => unknown | Promise<unknown>;
+}
+/**
+ * `defineServer()` 入参（design §3.4）。
+ *
+ * `Db` 由 `modules.database`（`database` 模块的 `createClient` 返回类型）**推断**（决策 10-2），
+ * 因此调用方**不需要**在 `createServices` 里写 `as PrismaClient` 强转。
+ */
+export interface DefineServerOptions<Db = unknown, S = unknown> {
+    serviceName: string;
+    title: string;
+    description: string;
+    version?: string;
+    mode?: ServerMode;
+    serverOptions?: ServerOptions;
+    serverUrl?: string | (() => string | null);
+    openapiVersion?: string;
+    docPath?: string;
+    log?: LoggerLike;
+    signal?: boolean;
+    errors: ErrorFactories;
+    messages?: Record<string, string>;
+    resolveMessage?: ResolveMessage;
+    mapStatus?: MapStatus;
+    modules?: ModuleAssembly<Db>;
+    config: ConfigModule;
+    setupCompilers?: (app: FastifyInstance) => void;
+    createRedis?: (config: ConfigModule) => RedisHandle | undefined;
+    initGlobalConfig?: (db: Db, opts: GlobalConfigOptions) => void | DisposeFunction;
+    onGlobalConfigChange?: (globalConfig: unknown) => void;
+    initClients?: (ctx: DbContext<Db>) => Promise<void | UnsubscribeFunction>;
+    extraPlugins?: FastifyPluginAsync[];
+    createServices: (ctx: DbContext<Db>) => S;
+    initServices?: (ctx: ServicesContext<S>) => Promise<void>;
+    backgroundWorkers?: (ctx: WorkersContext<Db, S>) => Promise<void>;
+    registerRouters: (app: FastifyInstance, ctx: ServicesContext<S>) => Promise<void> | void;
+    afterInit?: (ctx: InitContext<Db, S>) => Promise<DisposeFunction | void>;
+    afterReady?: (ctx: ReadyContext<S>) => Promise<void>;
+    beforeShutdown?: () => Promise<void> | void;
+    disposeServices?: (ctx: ServicesContext<S>) => Promise<void> | void;
+    disposeClients?: () => Promise<void> | void;
+    /** 覆盖默认关闭流程（design §3.4 / §5） */
+    shutdown?: (signal: string) => Promise<void> | void;
+}
+//# sourceMappingURL=types.d.ts.map

package/output/app/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../source/app/types.ts"],"names":[],"mappings":"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"}

package/output/app/types.js

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

package/output/rate-limiter/rate-limiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../source/rate-limiter/rate-limiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAA;AAGrH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAgB;gBAEjB,OAAO,GAAE,kBAAuB;IAItC,UAAU,CACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC;IAoCrB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI9D;;OAEG;IACG,eAAe,CACnB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC;CAe5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7E"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../source/rate-limiter/rate-limiter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAA;AAErH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAgB;gBAEjB,OAAO,GAAE,kBAAuB;IAItC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAoC1E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI9D;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAezF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7E"}

package/output/redis-cache/redis-cache.d.ts

@@ -130,9 +130,10 @@ export declare class RedisCache {
  * - 连接超时受限，避免 Redis 不可达时启动流程被拖住；
  * - 重连采用固定上限的退避，避免无意义的密集重试。
  */
-export declare function createRedisClient(options: {
+export interface CreateRedisClientOptions {
     url: string;
     logPrefix?: string;
     connectTimeoutMs?: number;
-}): RedisClientType;
+}
+export declare function createRedisClient(options: CreateRedisClientOptions): RedisClientType;
 //# sourceMappingURL=redis-cache.d.ts.map

package/output/redis-cache/redis-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-cache.d.ts","sourceRoot":"","sources":["../../source/redis-cache/redis-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,uBAAuB;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,EAAE,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAA;CACjC;AAaD;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IAEvC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAEhC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAE/D,OAAO,CAAC,gBAAgB,CAAI;gBAEhB,OAAO,EAAE,iBAAiB;IA6BtC,uBAAuB;IACvB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,sBAAsB;IACtB,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,wCAAwC;IACxC,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC,0BAA0B;IACnB,UAAU,IAAI,IAAI;IAOzB;;;;;OAKG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAQP,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAItC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C;;;;;;OAMG;IACU,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB5D;;;;;;OAMG;IACU,QAAQ,CAAC,CAAC,EACrB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,CAAC;IA6Bb;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAIhB,8CAA8C;YAChC,aAAa;YAmBb,aAAa;IAY3B,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,QAAQ;CAOjB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,eAAe,CAkBlB"}
+{"version":3,"file":"redis-cache.d.ts","sourceRoot":"","sources":["../../source/redis-cache/redis-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,uBAAuB;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,EAAE,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAA;CACjC;AAaD;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IAEvC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAEhC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAE/D,OAAO,CAAC,gBAAgB,CAAI;gBAEhB,OAAO,EAAE,iBAAiB;IA6BtC,uBAAuB;IACvB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,sBAAsB;IACtB,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,wCAAwC;IACxC,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC,0BAA0B;IACnB,UAAU,IAAI,IAAI;IAOzB;;;;;OAKG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAQP,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAItC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C;;;;;;OAMG;IACU,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB5D;;;;;;OAMG;IACU,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BhG;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAIhB,8CAA8C;YAChC,aAAa;YAmBb,aAAa;IAY3B,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,QAAQ;CAOjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,CAkBpF"}

package/output/redis-cache/redis-cache.js

@@ -264,13 +264,6 @@ export class RedisCache {
         logger.error(`[${this.getLogPrefix()}] ${operation} failed, cache degraded to pass-through:`, key, error);
     }
 }
-/**
- * 创建 Redis 客户端。
- *
- * 与 RedisQueueCommon 保持同样的连接策略，但补了两点：
- * - 连接超时受限，避免 Redis 不可达时启动流程被拖住；
- * - 重连采用固定上限的退避，避免无意义的密集重试。
- */
 export function createRedisClient(options) {
     const logPrefix = options.logPrefix ?? 'Redis';
     const client = createClient({

package/output/redis-queue/redis-queue-batch-consumer.d.ts

@@ -1,5 +1,5 @@
 import { RedisQueueCommon } from './redis-queue-common.js';
-import type { BatchConsumerConfig, QueueStats, RedisQueueRegistry } from './types.js';
+import type { AnyRegistry, BatchConsumerConfig, QueueStats, RedisQueueRegistry } from './types.js';
 /**
  * Redis 批量队列消费者
  *
@@ -47,7 +47,7 @@ import type { BatchConsumerConfig, QueueStats, RedisQueueRegistry } from './type
  * consumer.disconnect()
  * ```
  */
-export declare class RedisQueueBatchConsumer<R extends Record<string, any> = RedisQueueRegistry, K extends keyof R & string = keyof R & string> extends RedisQueueCommon {
+export declare class RedisQueueBatchConsumer<R extends AnyRegistry = RedisQueueRegistry, K extends keyof R & string = keyof R & string> extends RedisQueueCommon {
     private consumerRunning;
     private consumerInterval;
     private recoveryInterval;

package/output/redis-queue/redis-queue-batch-consumer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-queue-batch-consumer.d.ts","sourceRoot":"","sources":["../../source/redis-queue/redis-queue-batch-consumer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAA0B,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE7G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,uBAAuB,CAClC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,kBAAkB,EAClD,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAC7C,SAAQ,gBAAgB;IACxB,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,kBAAkB,CAA2B;IAErD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAOtB;gBAEW,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAuB1D,SAAS,CAAC,YAAY,IAAI,MAAM;IAIhC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;OAEG;YACW,YAAY;IA2G1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAyErB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAevC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CAMjC"}
+{"version":3,"file":"redis-queue-batch-consumer.d.ts","sourceRoot":"","sources":["../../source/redis-queue/redis-queue-batch-consumer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAA0B,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE1H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,uBAAuB,CAClC,CAAC,SAAS,WAAW,GAAG,kBAAkB,EAC1C,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAC7C,SAAQ,gBAAgB;IACxB,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,kBAAkB,CAA2B;IAErD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAOtB;gBAEW,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAuB1D,SAAS,CAAC,YAAY,IAAI,MAAM;IAIhC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;OAEG;YACW,YAAY;IA2G1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAyErB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAevC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;CAMjC"}

package/output/redis-queue/redis-queue-batch-consumer.js

@@ -1,5 +1,4 @@
-import { catchIt } from '@taicode/common-base';
-import { logger } from '@taicode/common-base';
+import { catchIt, logger } from '@taicode/common-base';
 import { RedisQueueCommon } from './redis-queue-common.js';
 /**
  * Redis 批量队列消费者
@@ -99,7 +98,7 @@ export class RedisQueueBatchConsumer extends RedisQueueCommon {
         if (this.processingPromises.size > 0) {
             logger.info(`[RedisQueueBatchConsumer] Waiting for ${this.processingPromises.size} batches to complete...`);
             await Promise.allSettled(this.processingPromises);
-            logger.info(`[RedisQueueBatchConsumer] All batches completed`);
+            logger.info('[RedisQueueBatchConsumer] All batches completed');
         }
         // 最后断开 Redis 连接
         super.disconnect();
@@ -116,7 +115,7 @@ export class RedisQueueBatchConsumer extends RedisQueueCommon {
                 const tasks = await Promise.all(taskIds.map(id => this.getTask(id)));
                 const validTasks = tasks.filter((task) => task !== null);
                 if (validTasks.length === 0) {
-                    logger.warn(`[RedisQueueBatchConsumer] No valid tasks found in batch`);
+                    logger.warn('[RedisQueueBatchConsumer] No valid tasks found in batch');
                     return;
                 }
                 // 过滤出有效的待处理任务
@@ -151,7 +150,7 @@ export class RedisQueueBatchConsumer extends RedisQueueCommon {
                     logger.info(`[RedisQueueBatchConsumer] Batch completed: ${updatedCount} tasks`);
                 }
                 catch (error) {
-                    logger.error(`[RedisQueueBatchConsumer] Batch failed:`, error);
+                    logger.error('[RedisQueueBatchConsumer] Batch failed:', error);
                     // 批量重试或失败
                     for (const task of tasksToProcess) {
                         if (task.retryCount < task.maxRetries) {
@@ -294,7 +293,7 @@ export class RedisQueueBatchConsumer extends RedisQueueCommon {
                 if (taskIds.length > 0) {
                     // 处理这批任务（不等待完成）
                     this.processBatch(taskIds).catch(error => {
-                        logger.error(`[RedisQueueBatchConsumer] Unhandled error in processBatch:`, error);
+                        logger.error('[RedisQueueBatchConsumer] Unhandled error in processBatch:', error);
                     });
                 }
             }

package/output/redis-queue/redis-queue-batch-consumer.test.d.ts

@@ -15,7 +15,7 @@ type TestTaskData = {
         value: number;
     };
     example?: string;
-    data?: any;
+    data?: unknown;
 };
 declare module './types.js' {
     interface RedisQueueRegistry {

package/output/redis-queue/redis-queue-batch-consumer.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-queue-batch-consumer.test.d.ts","sourceRoot":"","sources":["../../source/redis-queue/redis-queue-batch-consumer.test.ts"],"names":[],"mappings":"AAQA,KAAK,YAAY,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,GAAG,CAAA;CACX,CAAA;AAGD,OAAO,QAAQ,YAAY,CAAC;IAC1B,UAAU,kBAAkB;QAC1B,CAAC,GAAG,EAAE,cAAc,MAAM,EAAE,GAAG,YAAY,CAAA;KAC5C;CACF"}
+{"version":3,"file":"redis-queue-batch-consumer.test.d.ts","sourceRoot":"","sources":["../../source/redis-queue/redis-queue-batch-consumer.test.ts"],"names":[],"mappings":"AAQA,KAAK,YAAY,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAGD,OAAO,QAAQ,YAAY,CAAC;IAC1B,UAAU,kBAAkB;QAC1B,CAAC,GAAG,EAAE,cAAc,MAAM,EAAE,GAAG,YAAY,CAAA;KAC5C;CACF"}

package/output/redis-queue/redis-queue-batch-consumer.test.js

@@ -145,9 +145,7 @@ describe('RedisQueueBatchConsumer', () => {
     });
     describe('重试机制', () => {
         it('失败的批次应该重试', async () => {
-            let attemptCount = 0;
             const { provider, consumer } = createQueue(async () => {
-                attemptCount++;
                 throw new Error('Batch failed');
             }, { batchSize: 2, maxRetries: 1 });
             await provider.connect();
@@ -292,7 +290,7 @@ describe('RedisQueueBatchConsumer', () => {
     describe('超时恢复', () => {
         it('超时的任务应该直接标记为失败', { timeout: 15000 }, async () => {
             let processCount = 0;
-            const { provider, consumer } = createQueue(async (dataList) => {
+            const { provider, consumer } = createQueue(async () => {
                 processCount++;
                 // 模拟处理卡住，永远不完成 (但超时机制会检测到)
                 await new Promise(resolve => setTimeout(resolve, 20000));

package/output/redis-queue/redis-queue-common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-queue-common.d.ts","sourceRoot":"","sources":["../../source/redis-queue/redis-queue-common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAY,IAAI,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEhF;;;GAGG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAO;IAC9C,SAAS,CAAC,eAAe,EAAE,OAAO,CAAQ;IAE1C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACnC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACpC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAGvC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IACtC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IACvC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAC1C,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;gBAE7B,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,sBAA2B;IAwCjE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM;IAEzC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAalB;;OAEG;cACa,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAW7D;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAUlD;;OAEG;cACa,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChG;;;OAGG;cACa,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqD1G;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAevG;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAUhC;;;;;;;OAOG;cACa,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA4E/G"}
+{"version":3,"file":"redis-queue-common.d.ts","sourceRoot":"","sources":["../../source/redis-queue/redis-queue-common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEtE;;;GAGG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAO;IAC9C,SAAS,CAAC,eAAe,EAAE,OAAO,CAAQ;IAE1C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACnC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACpC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAGvC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IACtC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IACvC,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAC1C,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;gBAE7B,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,sBAA2B;IAwCjE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM;IAEzC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAalB;;OAEG;cACa,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAW7D;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAUlD;;OAEG;cACa,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChG;;;OAGG;cACa,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqD1G;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAevG;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAUhC;;;;;;;OAOG;cACa,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA4E/G"}

package/output/redis-queue/redis-queue-common.test.d.ts

@@ -1,18 +1,22 @@
+type TestQueueData = {
+    id?: string;
+    [key: string]: unknown;
+};
 declare module './types.js' {
     interface RedisQueueRegistry {
-        'test-queue': Record<string, any>;
-        'test-queue-error': Record<string, any>;
-        'short': Record<string, any>;
-        'valid-key': Record<string, any>;
-        'test-default': Record<string, any>;
-        'test-custom': Record<string, any>;
-        '': Record<string, any>;
-        'my-queue': Record<string, any>;
-        'test-error': Record<string, any>;
-        'test-bad': Record<string, any>;
-        'queue-one': Record<string, any>;
-        'queue-two': Record<string, any>;
-        [key: `test:reconnect:${number}`]: Record<string, any>;
+        'test-queue': TestQueueData;
+        'test-queue-error': TestQueueData;
+        'short': TestQueueData;
+        'valid-key': TestQueueData;
+        'test-default': TestQueueData;
+        'test-custom': TestQueueData;
+        '': TestQueueData;
+        'my-queue': TestQueueData;
+        'test-error': TestQueueData;
+        'test-bad': TestQueueData;
+        'queue-one': TestQueueData;
+        'queue-two': TestQueueData;
+        [key: `test:reconnect:${number}`]: TestQueueData;
     }
 }
 export {};