exisjs 0.4.2 → 0.4.4

package/dist/server/controller-registrar.js

@@ -0,0 +1,351 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControllerRegistrar = void 0;
+class ControllerRegistrar {
+    constructor(app) {
+        this.app = app;
+    }
+    // ─── Class-Based Controllers Registration ──────────────────────────────────
+    registerControllers(controllers, basePath = '', prefixMiddlewares = []) {
+        return this._registerControllers(controllers, basePath, prefixMiddlewares);
+    }
+    _registerControllers(controllers, basePath = '', prefixMiddlewares = []) {
+        const ROUTE_REGISTRY = Symbol.for('exisjs:routes');
+        const CONTROLLER_PREFIX = Symbol.for('exisjs:controller_prefix');
+        const CONTROLLER_HOST = Symbol.for('exisjs:controller_host');
+        const MIDDLEWARE_REGISTRY = Symbol.for('exisjs:middlewares');
+        const ROUTE_METADATA = Symbol.for('exisjs:route_metadata');
+        const LIFECYCLE_METADATA = Symbol.for('exisjs:lifecycle_metadata');
+        const PARAM_METADATA = Symbol.for('exisjs:param_metadata');
+        for (const ControllerClass of controllers) {
+            const prefix = ControllerClass.prototype[CONTROLLER_PREFIX] || '';
+            const host = ControllerClass.prototype[CONTROLLER_HOST];
+            const routes = ControllerClass.prototype[ROUTE_REGISTRY] || [];
+            const classMiddlewares = [
+                ...(Array.isArray(ControllerClass.prototype[MIDDLEWARE_REGISTRY])
+                    ? ControllerClass.prototype[MIDDLEWARE_REGISTRY]
+                    : ControllerClass.prototype[MIDDLEWARE_REGISTRY]?._classMiddlewares ||
+                        []),
+            ];
+            const methodMiddlewares = (!Array.isArray(ControllerClass.prototype[MIDDLEWARE_REGISTRY])
+                ? ControllerClass.prototype[MIDDLEWARE_REGISTRY]
+                : {}) || {};
+            const routeMetadataMap = ControllerClass.prototype[ROUTE_METADATA] || {};
+            const lifecycleMetadataMap = ControllerClass.prototype[LIFECYCLE_METADATA] || {};
+            const paramMetadataMap = ControllerClass.prototype[PARAM_METADATA] || {};
+            for (const route of routes) {
+                const method = route.method.toLowerCase();
+                const executeCore = async (req, res, next, streamOrSocket) => {
+                    let instance = this.app.container.resolve(ControllerClass);
+                    if (!instance) {
+                        // Auto-instantiate if not provided via DI
+                        instance = new ControllerClass();
+                        this.app.container.provide(ControllerClass, { useValue: instance });
+                    }
+                    try {
+                        // 0. Enforce Route Permissions (Role Authorization)
+                        const routeMetadata = routeMetadataMap[route.handlerName] || {};
+                        const permissions = routeMetadata.permissions;
+                        if (permissions && permissions.length > 0) {
+                            const userPerms = req.user?.permissions || (req.user?.role ? [req.user.role] : []);
+                            const hasPermission = permissions.some((p) => userPerms.includes(p));
+                            if (!hasPermission) {
+                                if (res) {
+                                    res.status(403).json({
+                                        success: false,
+                                        error: {
+                                            code: 'FORBIDDEN',
+                                            message: 'Insufficient permissions to access this resource',
+                                        },
+                                    });
+                                }
+                                return;
+                            }
+                        }
+                        // 1. Run Guards
+                        const routeLifecycle = lifecycleMetadataMap[route.handlerName] || {};
+                        const guards = routeLifecycle.guards || [];
+                        for (const guard of guards) {
+                            let allowed = false;
+                            if (typeof guard === 'function') {
+                                if (guard.prototype &&
+                                    typeof guard.prototype.canActivate === 'function') {
+                                    let guardInstance = this.app.container.resolve(guard);
+                                    if (!guardInstance) {
+                                        guardInstance = new guard();
+                                    }
+                                    allowed = await guardInstance.canActivate(req);
+                                }
+                                else {
+                                    allowed = await guard(req);
+                                }
+                            }
+                            if (!allowed) {
+                                if (res) {
+                                    res.status(403).json({
+                                        success: false,
+                                        error: { code: 'FORBIDDEN', message: 'Forbidden by Guard' },
+                                    });
+                                }
+                                return;
+                            }
+                        }
+                        // 2. Resolve parameters
+                        const paramMetadata = paramMetadataMap[route.handlerName] || [];
+                        const args = [];
+                        if (paramMetadata.length === 0) {
+                            if (method === 'ws' || method === 'sse') {
+                                args.push(req, streamOrSocket);
+                            }
+                            else {
+                                args.push(req, res, next);
+                            }
+                        }
+                        else {
+                            for (const param of paramMetadata) {
+                                if (!param) {
+                                    args.push(undefined);
+                                    continue;
+                                }
+                                let rawArg;
+                                switch (param.type) {
+                                    case 'req':
+                                        rawArg = req;
+                                        break;
+                                    case 'res':
+                                        rawArg = res;
+                                        break;
+                                    case 'body':
+                                        if (req.body === undefined &&
+                                            ['POST', 'PUT', 'PATCH'].includes(req.method)) {
+                                            const contentType = req.headers['content-type'] || '';
+                                            if (contentType.includes('json')) {
+                                                await req.json().catch(() => {
+                                                    /* noop */
+                                                });
+                                            }
+                                            else if (contentType.includes('form')) {
+                                                await req.formData().catch(() => {
+                                                    /* noop */
+                                                });
+                                            }
+                                        }
+                                        rawArg = req.body;
+                                        break;
+                                    case 'param':
+                                        rawArg = param.name ? req.params[param.name] : req.params;
+                                        break;
+                                    case 'query':
+                                        rawArg = param.name ? req.query[param.name] : req.query;
+                                        break;
+                                    case 'header':
+                                        rawArg = param.name
+                                            ? req.headers[param.name.toLowerCase()]
+                                            : req.headers;
+                                        break;
+                                    case 'session':
+                                        rawArg = req.session;
+                                        break;
+                                    case 'next':
+                                        rawArg = next;
+                                        break;
+                                    case 'host':
+                                        rawArg = param.name
+                                            ? req.params[param.name]
+                                            : req.hostname;
+                                        break;
+                                    case 'socket':
+                                    case 'stream':
+                                        rawArg = streamOrSocket;
+                                        break;
+                                    case 'ip':
+                                        rawArg = req.ip;
+                                        break;
+                                    case 'uploadedFile':
+                                    case 'uploadedFiles':
+                                        if (req.body === undefined &&
+                                            ['POST', 'PUT', 'PATCH'].includes(req.method)) {
+                                            await req.formData().catch(() => {
+                                                /* noop */
+                                            });
+                                        }
+                                        if (req.files) {
+                                            const isMulti = param.type === 'uploadedFiles';
+                                            let files = [];
+                                            if (param.name) {
+                                                files = req.files.filter((f) => f.fieldname === param.name);
+                                            }
+                                            else {
+                                                files = req.files;
+                                            }
+                                            rawArg = isMulti ? files : files[0];
+                                        }
+                                        break;
+                                    default:
+                                        rawArg = undefined;
+                                }
+                                if (param.pipes && param.pipes.length > 0) {
+                                    for (const pipe of param.pipes) {
+                                        if (typeof pipe === 'function' &&
+                                            pipe.prototype?.transform) {
+                                            let pipeInstance = this.app.container.resolve(pipe);
+                                            if (!pipeInstance)
+                                                pipeInstance = new pipe();
+                                            rawArg = await pipeInstance.transform(rawArg, {
+                                                type: param.type,
+                                                name: param.name,
+                                            });
+                                        }
+                                        else if (typeof pipe === 'object' &&
+                                            typeof pipe.parse === 'function') {
+                                            rawArg = await pipe.parse(rawArg);
+                                        }
+                                        else if (typeof pipe === 'object' &&
+                                            typeof pipe.transform === 'function') {
+                                            rawArg = await pipe.transform(rawArg, {
+                                                type: param.type,
+                                                name: param.name,
+                                            });
+                                        }
+                                        else if (typeof pipe === 'function') {
+                                            rawArg = await pipe(rawArg);
+                                        }
+                                    }
+                                }
+                                args.push(rawArg);
+                            }
+                        }
+                        // 3. Execute Custom Interceptors
+                        const interceptors = routeLifecycle.interceptors || [];
+                        for (const interceptor of interceptors) {
+                            if (typeof interceptor === 'function') {
+                                if (interceptor.prototype &&
+                                    typeof interceptor.prototype.intercept === 'function') {
+                                    let interceptorInstance = this.app.container.resolve(interceptor);
+                                    if (!interceptorInstance) {
+                                        interceptorInstance = new interceptor();
+                                    }
+                                    await interceptorInstance.intercept(req, res);
+                                }
+                                else {
+                                    await interceptor(req, res);
+                                }
+                            }
+                        }
+                        // 4. Invoke the method
+                        const result = await instance[route.handlerName](...args);
+                        if (res && !res.headersSent) {
+                            const routeMeta = routeMetadataMap[route.handlerName] || {};
+                            if (routeMeta.redirect) {
+                                res.redirect(routeMeta.redirect.url, routeMeta.redirect.statusCode);
+                                return;
+                            }
+                            // Apply custom headers
+                            if (routeMeta.headers) {
+                                for (const [name, val] of Object.entries(routeMeta.headers)) {
+                                    res.setHeader(name, val);
+                                }
+                            }
+                            // Apply custom HTTP Code
+                            if (routeMeta.httpCode) {
+                                res.status(routeMeta.httpCode);
+                            }
+                            if (result !== undefined) {
+                                res.json(result);
+                            }
+                        }
+                    }
+                    catch (err) {
+                        let handled = false;
+                        const routeLifecycle = lifecycleMetadataMap[route.handlerName] || {};
+                        const filters = routeLifecycle.filters || [];
+                        for (const filter of filters) {
+                            if (typeof filter === 'function' && filter.prototype?.catch) {
+                                let filterInstance = this.app.container.resolve(filter);
+                                if (!filterInstance)
+                                    filterInstance = new filter();
+                                await filterInstance.catch(err, { req, res });
+                                handled = true;
+                                break;
+                            }
+                            else if (typeof filter === 'object' &&
+                                typeof filter.catch === 'function') {
+                                await filter.catch(err, { req, res });
+                                handled = true;
+                                break;
+                            }
+                        }
+                        if (!handled) {
+                            if (next)
+                                next(err);
+                            else
+                                console.error(`[Exis ${method.toUpperCase()} Error]`, err);
+                        }
+                    }
+                };
+                let finalHandler;
+                if (method === 'ws' || method === 'sse') {
+                    finalHandler = async (streamOrSocket, rawReq) => {
+                        await executeCore(rawReq, undefined, undefined, streamOrSocket);
+                    };
+                }
+                else {
+                    finalHandler = async (req, res, next) => {
+                        await executeCore(req, res, next);
+                    };
+                }
+                const fullPath = (basePath + prefix + route.path).replace(/\/+/g, '/') || '/';
+                const routeSpecificMiddlewares = methodMiddlewares[route.handlerName] || [];
+                const allMiddlewares = [
+                    ...prefixMiddlewares,
+                    ...classMiddlewares,
+                    ...routeSpecificMiddlewares,
+                ];
+                const routeMeta = routeMetadataMap[route.handlerName] || {};
+                const finalHost = routeMeta.hosts || host;
+                let schema = route.schema;
+                const paramMetadata = paramMetadataMap[route.handlerName] || [];
+                let extractedBodySchema = undefined;
+                let extractedQuerySchema = undefined;
+                for (const param of paramMetadata) {
+                    if (!param)
+                        continue;
+                    if (param.type === 'body') {
+                        const bodyPipe = param.pipes?.find((p) => p && typeof p.parse === 'function');
+                        if (bodyPipe)
+                            extractedBodySchema = bodyPipe;
+                    }
+                    if (param.type === 'query') {
+                        const queryPipe = param.pipes?.find((p) => p && typeof p.parse === 'function');
+                        if (queryPipe)
+                            extractedQuerySchema = queryPipe;
+                    }
+                }
+                const extractedResponseSchema = routeMeta.responseSchema;
+                if (schema ||
+                    finalHost ||
+                    extractedBodySchema ||
+                    extractedQuerySchema ||
+                    extractedResponseSchema) {
+                    schema = schema || {};
+                    if (finalHost)
+                        schema.host = finalHost;
+                    if (extractedBodySchema && !schema.body)
+                        schema.body = extractedBodySchema;
+                    if (extractedQuerySchema && !schema.query)
+                        schema.query = extractedQuerySchema;
+                    if (extractedResponseSchema && !schema.response)
+                        schema.response = extractedResponseSchema;
+                    this.app.router[method](fullPath, ...allMiddlewares, schema, finalHandler);
+                }
+                else {
+                    ;
+                    this.app.router[method](fullPath, ...allMiddlewares, finalHandler);
+                }
+            }
+        }
+        return this.app;
+    }
+}
+exports.ControllerRegistrar = ControllerRegistrar;
+//# sourceMappingURL=controller-registrar.js.map

package/dist/server/controller-registrar.js.map

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

package/dist/server/plugin-manager.d.ts

@@ -0,0 +1,26 @@
+import type { App } from './app';
+import type { ExisPlugin, ExisPluginInstance, HookReady, HookClose, HookRequest, HookResponse, HookError, HookRoute } from '../types';
+export declare class PluginManager {
+    private app;
+    private registeredPlugins;
+    hooks: {
+        ready: HookReady[];
+        close: HookClose[];
+        request: HookRequest[];
+        response: HookResponse[];
+        error: HookError[];
+        route: HookRoute[];
+    };
+    onStartHook?: (app: App) => void | Promise<void>;
+    onCloseHook?: (app: App) => void | Promise<void>;
+    constructor(app: App);
+    onReady(cb: HookReady): App;
+    onClose(cb: HookClose): App;
+    onRequest(cb: HookRequest): App;
+    onResponse(cb: HookResponse): App;
+    onError(cb: HookError): App;
+    onRoute(cb: HookRoute): App;
+    hasPlugin(name: string): boolean;
+    register<TOptions = Record<string, unknown>>(pluginOrInstance: ExisPlugin<TOptions> | ExisPluginInstance, legacyOptions?: TOptions): Promise<App>;
+}
+//# sourceMappingURL=plugin-manager.d.ts.map

package/dist/server/plugin-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../src/server/plugin-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAGlB,SAAS,EACT,SAAS,EACT,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACV,MAAM,UAAU,CAAA;AAEjB,qBAAa,aAAa;IAeZ,OAAO,CAAC,GAAG;IAdvB,OAAO,CAAC,iBAAiB,CAAyC;IAE3D,KAAK;eACG,SAAS,EAAE;eACX,SAAS,EAAE;iBACT,WAAW,EAAE;kBACZ,YAAY,EAAE;eACjB,SAAS,EAAE;eACX,SAAS,EAAE;MACzB;IAEM,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;gBAEnC,GAAG,EAAE,GAAG;IAG5B,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,GAAG;IAK3B,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,GAAG;IAK3B,SAAS,CAAC,EAAE,EAAE,WAAW,GAAG,GAAG;IAK/B,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,GAAG;IAKjC,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,GAAG;IAK3B,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,GAAG;IAOpB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,gBAAgB,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,kBAAkB,EAC3D,aAAa,CAAC,EAAE,QAAQ,GACvB,OAAO,CAAC,GAAG,CAAC;CAqHhB"}

package/dist/server/plugin-manager.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginManager = void 0;
+const router_1 = require("../router/router");
+class PluginManager {
+    constructor(app) {
+        this.app = app;
+        this.registeredPlugins = new Map();
+        this.hooks = {
+            ready: [],
+            close: [],
+            request: [],
+            response: [],
+            error: [],
+            route: [],
+        };
+    }
+    // ─── Lifecycle Hooks Registration ───────────────────────────────────────────
+    onReady(cb) {
+        this.hooks.ready.push(cb);
+        return this.app;
+    }
+    onClose(cb) {
+        this.hooks.close.push(cb);
+        return this.app;
+    }
+    onRequest(cb) {
+        this.hooks.request.push(cb);
+        return this.app;
+    }
+    onResponse(cb) {
+        this.hooks.response.push(cb);
+        return this.app;
+    }
+    onError(cb) {
+        this.hooks.error.push(cb);
+        return this.app;
+    }
+    onRoute(cb) {
+        this.hooks.route.push(cb);
+        return this.app;
+    }
+    // ─── Plugin System ──────────────────────────────────────────────────────────
+    hasPlugin(name) {
+        return this.registeredPlugins.has(name);
+    }
+    async register(pluginOrInstance, legacyOptions) {
+        let plugin;
+        let options;
+        if ('plugin' in pluginOrInstance && !('register' in pluginOrInstance)) {
+            plugin = pluginOrInstance.plugin;
+            options = pluginOrInstance.options;
+        }
+        else {
+            plugin = pluginOrInstance;
+            options = legacyOptions;
+        }
+        if (this.registeredPlugins.has(plugin.name)) {
+            throw new Error(`Plugin '${plugin.name}' is already registered`);
+        }
+        if (plugin.dependencies) {
+            for (const dep of plugin.dependencies) {
+                if (!this.registeredPlugins.has(dep)) {
+                    throw new Error(`Plugin '${plugin.name}' requires dependency '${dep}' which is not registered`);
+                }
+            }
+        }
+        let targetApp = this.app;
+        let pluginRouter;
+        if (plugin.encapsulate !== false) {
+            pluginRouter = new router_1.Router();
+            // Create a proxy that intercepts route and middleware registrations
+            targetApp = new Proxy(this.app, {
+                get(target, prop, receiver) {
+                    if ([
+                        'get',
+                        'post',
+                        'put',
+                        'patch',
+                        'delete',
+                        'httpOptions',
+                        'head',
+                        'all',
+                        'ws',
+                        'query',
+                        'connect',
+                        'trace',
+                    ].includes(prop)) {
+                        return (path, ...handlers) => {
+                            const routerMethod = prop === 'httpOptions' ? 'options' : prop;
+                            pluginRouter[routerMethod](path, ...handlers);
+                            return receiver;
+                        };
+                    }
+                    if (prop === 'use') {
+                        return (...handlers) => {
+                            for (const h of handlers) {
+                                if (h.length === 4) {
+                                    // error handlers stay global for now, or we could scope them
+                                    target.use(h);
+                                }
+                                else {
+                                    pluginRouter.use(h);
+                                }
+                            }
+                            return receiver;
+                        };
+                    }
+                    // Encapsulate lifecycle hooks by converting them to scoped middleware!
+                    if (['onRequest', 'onResponse'].includes(prop)) {
+                        return (cb) => {
+                            if (prop === 'onRequest') {
+                                pluginRouter.use(async (req, res, next) => {
+                                    try {
+                                        await cb(req, res);
+                                        next();
+                                    }
+                                    catch (err) {
+                                        next(err);
+                                    }
+                                });
+                            }
+                            else if (prop === 'onResponse') {
+                                pluginRouter.use((req, res, next) => {
+                                    res.raw.on('finish', () => {
+                                        cb(req, res).catch(() => {
+                                            /* ignore */
+                                        });
+                                    });
+                                    next();
+                                });
+                            }
+                            return receiver;
+                        };
+                    }
+                    const value = Reflect.get(target, prop, receiver);
+                    return typeof value === 'function' ? value.bind(target) : value;
+                },
+            });
+        }
+        await plugin.register(targetApp, options);
+        if (pluginRouter) {
+            this.app.mount('/', pluginRouter);
+        }
+        this.registeredPlugins.set(plugin.name, plugin);
+        return this.app;
+    }
+}
+exports.PluginManager = PluginManager;
+//# sourceMappingURL=plugin-manager.js.map

package/dist/server/plugin-manager.js.map

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

package/dist/server/queue-manager.d.ts

@@ -0,0 +1,18 @@
+import type { App } from './app';
+import { ExisQueue } from '../queue/client';
+import { ExisWorker } from '../queue/worker';
+import { CronScheduler } from '../cron/scheduler';
+import type { JobOptions } from '../queue/types';
+import type { ExisConfig } from '../types';
+export declare class QueueManager {
+    private app;
+    _queueClient: ExisQueue | null;
+    _queueWorker: ExisWorker | null;
+    _cronScheduler: CronScheduler | null;
+    _pendingQueueJobs: import('../queue/types').JobDefinition<unknown>[];
+    constructor(app: App);
+    queue<T = unknown>(name: string, handler: import('../queue/types').JobHandler<T>, options?: Omit<import('../queue/types').JobDefinition<T>, 'name' | 'handler'>): void;
+    enqueue<T = unknown>(name: string, payload: T, opts?: JobOptions): Promise<string>;
+    _initQueue(qConfig: NonNullable<ExisConfig['queue']>): void;
+}
+//# sourceMappingURL=queue-manager.d.ts.map

package/dist/server/queue-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-manager.d.ts","sourceRoot":"","sources":["../../src/server/queue-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,qBAAa,YAAY;IAOX,OAAO,CAAC,GAAG;IANhB,YAAY,EAAE,SAAS,GAAG,IAAI,CAAO;IACrC,YAAY,EAAE,UAAU,GAAG,IAAI,CAAO;IACtC,cAAc,EAAE,aAAa,GAAG,IAAI,CAAO;IAC3C,iBAAiB,EAAE,OAAO,gBAAgB,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CACvE;gBAEgB,GAAG,EAAE,GAAG;IAErB,KAAK,CAAC,CAAC,GAAG,OAAO,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC,EAC/C,OAAO,CAAC,EAAE,IAAI,CACZ,OAAO,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC,EACzC,MAAM,GAAG,SAAS,CACnB;IAoBU,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,EACV,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,CAAC;IASX,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;CAsB5D"}

package/dist/server/queue-manager.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueueManager = void 0;
+const client_1 = require("../queue/client");
+const worker_1 = require("../queue/worker");
+const scheduler_1 = require("../cron/scheduler");
+class QueueManager {
+    constructor(app) {
+        this.app = app;
+        this._queueClient = null;
+        this._queueWorker = null;
+        this._cronScheduler = null;
+        this._pendingQueueJobs = [];
+    }
+    queue(name, handler, options) {
+        if (!this._queueWorker) {
+            if (this.app.options.queue?.enableWorkers === false) {
+                return;
+            }
+            this._pendingQueueJobs.push({
+                name,
+                handler: handler,
+                ...options,
+            });
+            return;
+        }
+        this._queueWorker.registerJob({
+            name,
+            handler: handler,
+            ...options,
+        });
+    }
+    async enqueue(name, payload, opts) {
+        if (!this._queueClient) {
+            throw new Error('Queue is not initialized. Please configure ExisConfig.queue first.');
+        }
+        return this._queueClient.enqueue(name, payload, opts);
+    }
+    _initQueue(qConfig) {
+        if (!this._queueClient) {
+            this._queueClient = new client_1.ExisQueue(qConfig);
+        }
+        const enableWorkers = qConfig.enableWorkers ?? true;
+        if (enableWorkers && !this._queueWorker) {
+            this._queueWorker = new worker_1.ExisWorker(qConfig, this.app.log, this._queueClient.getDriver());
+            this._queueWorker.start();
+            const redisClient = this._queueWorker.redis || null;
+            this._cronScheduler = new scheduler_1.CronScheduler(this._queueWorker, redisClient, this.app.log);
+            this._cronScheduler.start();
+        }
+    }
+}
+exports.QueueManager = QueueManager;
+//# sourceMappingURL=queue-manager.js.map

package/dist/server/queue-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-manager.js","sourceRoot":"","sources":["../../src/server/queue-manager.ts"],"names":[],"mappings":";;;AACA,4CAA2C;AAC3C,4CAA4C;AAC5C,iDAAiD;AAIjD,MAAa,YAAY;IAOvB,YAAoB,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;QANrB,iBAAY,GAAqB,IAAI,CAAA;QACrC,iBAAY,GAAsB,IAAI,CAAA;QACtC,mBAAc,GAAyB,IAAI,CAAA;QAC3C,sBAAiB,GACtB,EAAE,CAAA;IAE2B,CAAC;IAEzB,KAAK,CACV,IAAY,EACZ,OAA+C,EAC/C,OAGC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,KAAK,KAAK,EAAE,CAAC;gBACpD,OAAM;YACR,CAAC;YACD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBAC1B,IAAI;gBACJ,OAAO,EAAE,OAAuD;gBAChE,GAAG,OAAO;aACJ,CAAC,CAAA;YACT,OAAM;QACR,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC;YAC5B,IAAI;YACJ,OAAO,EAAE,OAAuD;YAChE,GAAG,OAAO;SACJ,CAAC,CAAA;IACX,CAAC;IAEM,KAAK,CAAC,OAAO,CAClB,IAAY,EACZ,OAAU,EACV,IAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QACH,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IACvD,CAAC;IAEM,UAAU,CAAC,OAAyC;QACzD,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAI,kBAAS,CAAC,OAAO,CAAC,CAAA;QAC5C,CAAC;QACD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAA;QACnD,IAAI,aAAa,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,IAAI,CAAC,YAAY,GAAG,IAAI,mBAAU,CAChC,OAAO,EACP,IAAI,CAAC,GAAG,CAAC,GAAG,EACZ,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAC9B,CAAA;YACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;YAEzB,MAAM,WAAW,GAAI,IAAI,CAAC,YAAoB,CAAC,KAAK,IAAI,IAAI,CAAA;YAC5D,IAAI,CAAC,cAAc,GAAG,IAAI,yBAAa,CACrC,IAAI,CAAC,YAAY,EACjB,WAAW,EACX,IAAI,CAAC,GAAG,CAAC,GAAG,CACb,CAAA;YACD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;QAC7B,CAAC;IACH,CAAC;CACF;AAtED,oCAsEC"}