exisjs 0.1.2

package/dist/queue/drivers/RedisDriver.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisQueueDriver = void 0;
+class RedisQueueDriver {
+    constructor(redis, prefix = 'exis:queue') {
+        this.redis = redis;
+        this.prefix = prefix;
+    }
+    async enqueue(name, payload, maxQueue) {
+        const zsetKey = `${this.prefix}:${name}:pending`;
+        const hashKey = `${this.prefix}:${name}:payloads`;
+        const payloadStr = JSON.stringify(payload);
+        const score = Date.now() + (payload.opts?.delay || 0);
+        if (maxQueue !== undefined) {
+            const luaScript = `
+        local len = redis.call("ZCARD", KEYS[1])
+        if len >= tonumber(ARGV[1]) then
+          return -1
+        end
+        redis.call("ZADD", KEYS[1], ARGV[2], ARGV[3])
+        redis.call("HSET", KEYS[2], ARGV[3], ARGV[4])
+        return 1
+      `;
+            const result = await this.redis.eval(luaScript, 2, zsetKey, hashKey, maxQueue, score, payload.id, payloadStr);
+            if (result === -1) {
+                throw new Error(`Queue backpressure activated: maximum queue size (${maxQueue}) reached for job ${name}.`);
+            }
+        }
+        else {
+            const luaScript = `
+        redis.call("ZADD", KEYS[1], ARGV[1], ARGV[2])
+        redis.call("HSET", KEYS[2], ARGV[2], ARGV[3])
+        return 1
+      `;
+            await this.redis.eval(luaScript, 2, zsetKey, hashKey, score, payload.id, payloadStr);
+        }
+        return payload.id;
+    }
+    async poll(jobs) {
+        const now = Date.now();
+        for (const name of jobs.keys()) {
+            const pendingKey = `${this.prefix}:${name}:pending`;
+            const processingKey = `${this.prefix}:${name}:processing`;
+            const hashKey = `${this.prefix}:${name}:payloads`;
+            const jobDef = jobs.get(name);
+            const visibilityTimeout = jobDef?.defaultOptions?.visibilityTimeout ?? 30000;
+            const luaScript = `
+        local jobs = redis.call("ZRANGEBYSCORE", KEYS[1], "-inf", ARGV[1], "LIMIT", 0, 1)
+        if #jobs > 0 then
+          local id = jobs[1]
+          redis.call("ZREM", KEYS[1], id)
+          redis.call("ZADD", KEYS[2], ARGV[2], id)
+          local payload = redis.call("HGET", KEYS[3], id)
+          return { id, payload }
+        end
+        return nil
+      `;
+            const res = (await this.redis.eval(luaScript, 3, pendingKey, processingKey, hashKey, now, now + visibilityTimeout));
+            if (res && res[0] && res[1]) {
+                return {
+                    queueKey: pendingKey,
+                    jobId: res[0],
+                    payloadStr: res[1],
+                };
+            }
+        }
+        return null;
+    }
+    async acknowledge(jobName, jobId) {
+        const processingKey = `${this.prefix}:${jobName}:processing`;
+        const hashKey = `${this.prefix}:${jobName}:payloads`;
+        await this.redis
+            .pipeline()
+            .zrem(processingKey, jobId)
+            .hdel(hashKey, jobId)
+            .exec();
+    }
+    async fail(jobDef, jobId, payload, maxAttempts) {
+        const processingKey = `${this.prefix}:${jobDef.name}:processing`;
+        const pendingKey = `${this.prefix}:${jobDef.name}:pending`;
+        const hashKey = `${this.prefix}:${jobDef.name}:payloads`;
+        if (payload.attemptsMade < maxAttempts) {
+            const delay = payload.opts?.backoff?.delay ?? 0;
+            const nextRun = Date.now() + delay;
+            await this.redis
+                .pipeline()
+                .hset(hashKey, jobId, JSON.stringify(payload))
+                .zrem(processingKey, jobId)
+                .zadd(pendingKey, nextRun, jobId)
+                .exec();
+        }
+        else {
+            await this.redis
+                .pipeline()
+                .zrem(processingKey, jobId)
+                .hdel(hashKey, jobId)
+                .exec();
+        }
+    }
+    async sweep(jobs) {
+        for (const name of jobs.keys()) {
+            const processingKey = `${this.prefix}:${name}:processing`;
+            const pendingKey = `${this.prefix}:${name}:pending`;
+            const luaScript = `
+        local expired = redis.call("ZRANGEBYSCORE", KEYS[1], "-inf", ARGV[1])
+        for i, id in ipairs(expired) do
+          redis.call("ZREM", KEYS[1], id)
+          redis.call("ZADD", KEYS[2], ARGV[1], id)
+        end
+        return #expired
+      `;
+            await this.redis.eval(luaScript, 2, processingKey, pendingKey, Date.now());
+        }
+    }
+    async close() {
+        await this.redis.quit();
+    }
+}
+exports.RedisQueueDriver = RedisQueueDriver;
+//# sourceMappingURL=RedisDriver.js.map

package/dist/queue/drivers/RedisDriver.js.map

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

package/dist/queue/index.d.ts

@@ -0,0 +1,12 @@
+export * from './types';
+export { ExisQueue } from './client';
+export { ExisWorker } from './worker';
+export declare function defineJob<Schema extends {
+    parse: (val: any) => any;
+}, T = Schema extends {
+    parse: (val: any) => infer U;
+} ? U : unknown>(def: Omit<import('./types').JobDefinition<T>, 'schema'> & {
+    schema: Schema;
+}): import('./types').JobDefinition<T>;
+export declare function defineJob<T = unknown>(def: import('./types').JobDefinition<T>): import('./types').JobDefinition<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErC,wBAAgB,SAAS,CACvB,MAAM,SAAS;IAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAA;CAAE,EAC3C,CAAC,GAAG,MAAM,SAAS;IAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,OAAO,EAEjE,GAAG,EAAE,IAAI,CAAC,OAAO,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3E,OAAO,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;AACrC,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EACnC,GAAG,EAAE,OAAO,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GACtC,OAAO,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA"}

package/dist/queue/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExisWorker = exports.ExisQueue = void 0;
+exports.defineJob = defineJob;
+__exportStar(require("./types"), exports);
+var client_1 = require("./client");
+Object.defineProperty(exports, "ExisQueue", { enumerable: true, get: function () { return client_1.ExisQueue; } });
+var worker_1 = require("./worker");
+Object.defineProperty(exports, "ExisWorker", { enumerable: true, get: function () { return worker_1.ExisWorker; } });
+function defineJob(def) {
+    return def;
+}
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAaA,8BAEC;AAfD,0CAAuB;AACvB,mCAAoC;AAA3B,mGAAA,SAAS,OAAA;AAClB,mCAAqC;AAA5B,oGAAA,UAAU,OAAA;AAWnB,SAAgB,SAAS,CAAC,GAAQ;IAChC,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/queue/types.d.ts

@@ -0,0 +1,51 @@
+import type Redis from 'ioredis';
+export interface QueueConfig {
+    driver?: 'redis' | 'memory' | 'database';
+    redisUrl?: string;
+    redis?: Redis;
+    concurrency?: number;
+    maxConcurrent?: number;
+    maxQueue?: number;
+    enableWorkers?: boolean;
+    prefix?: string;
+}
+export interface JobOptions {
+    attempts?: number;
+    delay?: number;
+    visibilityTimeout?: number;
+    backoff?: {
+        type: 'exponential' | 'fixed';
+        delay: number;
+    };
+}
+export interface JobPayload<T = unknown> {
+    id: string;
+    name: string;
+    data: T;
+    attemptsMade: number;
+    opts?: JobOptions;
+}
+export type JobHandler<T = unknown> = (job: JobPayload<T>) => Promise<void> | void;
+export interface JobDefinition<T = unknown> {
+    name: string;
+    handler?: JobHandler<T>;
+    filePath?: string;
+    cron?: string;
+    schema?: {
+        parse: (val: unknown) => T;
+    };
+    defaultOptions?: JobOptions;
+}
+export interface QueueDriver {
+    enqueue(name: string, payload: JobPayload, maxQueue?: number): Promise<string>;
+    poll(jobs: Map<string, JobDefinition>): Promise<{
+        queueKey: string;
+        jobId: string;
+        payloadStr: string;
+    } | null>;
+    acknowledge(jobName: string, jobId: string): Promise<void>;
+    fail(jobDef: JobDefinition, jobId: string, payload: JobPayload, maxAttempts: number): Promise<void>;
+    sweep(jobs: Map<string, JobDefinition>): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/queue/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/queue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAEhC,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,aAAa,GAAG,OAAO,CAAA;QAC7B,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,CAAC,CAAA;IACP,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,CACpC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,KACf,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAA;KAAE,CAAA;IACvC,cAAc,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9E,IAAI,CACF,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAC/B,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC1E,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,IAAI,CACF,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/queue/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/queue/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/queue/types.ts"],"names":[],"mappings":""}

package/dist/queue/worker.d.ts

@@ -0,0 +1,18 @@
+import type { QueueConfig, JobDefinition, QueueDriver } from './types';
+export declare class ExisWorker {
+    private driver;
+    private jobs;
+    private isRunning;
+    private logger;
+    private concurrency;
+    private activeWorkers;
+    private threadPool;
+    constructor(config: QueueConfig, logger?: any, driverOverride?: QueueDriver | null);
+    registerJob(jobDef: JobDefinition): void;
+    start(): Promise<void>;
+    private startSweeper;
+    private poll;
+    private processJob;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/queue/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/queue/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EAEb,WAAW,EACZ,MAAM,SAAS,CAAA;AAOhB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,UAAU,CAA0B;gBAG1C,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,GAAG,EACZ,cAAc,CAAC,EAAE,WAAW,GAAG,IAAI;IAiCrC,WAAW,CAAC,MAAM,EAAE,aAAa;IAI3B,KAAK;IAiBX,OAAO,CAAC,YAAY;YAaN,IAAI;YA4CJ,UAAU;IA4ClB,IAAI;CAWX"}

package/dist/queue/worker.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExisWorker = void 0;
+const logger_1 = require("../utils/logger");
+const pool_1 = require("../threads/pool");
+const MemoryDriver_1 = require("./drivers/MemoryDriver");
+const RedisDriver_1 = require("./drivers/RedisDriver");
+class ExisWorker {
+    constructor(config, logger, driverOverride) {
+        this.driver = null;
+        this.jobs = new Map();
+        this.isRunning = false;
+        this.activeWorkers = 0;
+        this.threadPool = null;
+        this.concurrency = config.maxConcurrent || config.concurrency || 1;
+        this.logger = logger || (0, logger_1.createSilentLogger)();
+        const prefix = config.prefix || 'exis:queue';
+        const driverType = config.driver || (config.redis || config.redisUrl ? 'redis' : null);
+        if (driverOverride) {
+            this.driver = driverOverride;
+        }
+        else if (driverType === 'redis') {
+            if (config.redis) {
+                this.driver = new RedisDriver_1.RedisQueueDriver(config.redis.duplicate(), prefix);
+            }
+            else if (config.redisUrl) {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const IORedis = require('ioredis');
+                this.driver = new RedisDriver_1.RedisQueueDriver(new IORedis(config.redisUrl, { maxRetriesPerRequest: null }), prefix);
+            }
+            else {
+                throw new Error('Redis driver requires redisUrl or redis client instance');
+            }
+        }
+        else if (driverType === 'memory') {
+            this.driver = new MemoryDriver_1.MemoryQueueDriver();
+        }
+        else if (driverType === 'database') {
+            throw new Error('Database driver is not yet implemented');
+        }
+    }
+    registerJob(jobDef) {
+        this.jobs.set(jobDef.name, jobDef);
+    }
+    async start() {
+        if (!this.driver)
+            return;
+        if (this.jobs.size === 0)
+            return;
+        this.isRunning = true;
+        this.logger.info(`Queue worker started with concurrency ${this.concurrency} (Thread Pool enabled)`);
+        this.threadPool = new pool_1.ThreadPool(this.concurrency);
+        this.startSweeper();
+        for (let i = 0; i < this.concurrency; i++) {
+            this.poll();
+        }
+    }
+    startSweeper() {
+        if (!this.isRunning || !this.driver)
+            return;
+        setTimeout(async () => {
+            try {
+                await this.driver.sweep(this.jobs);
+            }
+            catch (err) {
+                this.logger.error({ err }, 'Sweeper error');
+            }
+            finally {
+                this.startSweeper();
+            }
+        }, 10000).unref();
+    }
+    async poll() {
+        if (!this.isRunning || !this.driver)
+            return;
+        this.activeWorkers++;
+        try {
+            const res = await this.driver.poll(this.jobs);
+            if (res) {
+                const { jobId, payloadStr } = res;
+                // The queueKey contains the job name somewhere, but actually we can just look it up
+                // wait, we can just parse the payload!
+                let payload = null;
+                try {
+                    payload = JSON.parse(payloadStr);
+                }
+                catch {
+                    // ignore parse error
+                }
+                if (payload && payload.name) {
+                    const jobDef = this.jobs.get(payload.name);
+                    if (jobDef) {
+                        await this.processJob(jobDef, jobId, payloadStr);
+                    }
+                    else {
+                        this.logger.error(`Job popped but no definition found for '${payload.name}'. The job has been discarded.`);
+                    }
+                }
+            }
+            else {
+                await new Promise((r) => setTimeout(r, 1000));
+            }
+        }
+        catch (err) {
+            if (err.name !== 'MaxRetriesPerRequestError') {
+                this.logger.debug({ err: err.message }, 'Worker poll error');
+            }
+            await new Promise((r) => setTimeout(r, 3000)); // backoff on connection error
+        }
+        finally {
+            this.activeWorkers--;
+            if (this.isRunning) {
+                setImmediate(() => this.poll());
+            }
+        }
+    }
+    async processJob(jobDef, jobId, payloadStr) {
+        let payload = null;
+        try {
+            payload = JSON.parse(payloadStr);
+            payload.attemptsMade = (payload.attemptsMade || 0) + 1;
+            if (jobDef.schema) {
+                payload.data = jobDef.schema.parse(payload.data);
+            }
+            this.logger.debug(`Processing job ${payload.name}:${payload.id} in Thread Pool`);
+            if (jobDef.handler) {
+                await jobDef.handler(payload);
+            }
+            else if (jobDef.filePath && this.threadPool) {
+                await this.threadPool.runJob(jobDef.filePath, payload);
+            }
+            else {
+                throw new Error(`Job ${jobDef.name} has no handler or filePath!`);
+            }
+            this.logger.info(`Completed job ${payload.name}:${payload.id}`);
+            if (this.driver) {
+                await this.driver.acknowledge(jobDef.name, jobId);
+            }
+        }
+        catch (err) {
+            this.logger.error({ err, job: payload }, `Failed job ${jobDef.name}`);
+            if (this.driver && payload) {
+                await this.driver.fail(jobDef, jobId, payload, payload.opts?.attempts ?? jobDef.defaultOptions?.attempts ?? 1);
+            }
+        }
+    }
+    async stop() {
+        this.isRunning = false;
+        if (this.threadPool) {
+            await this.threadPool.close();
+            this.threadPool = null;
+        }
+        if (this.driver) {
+            await this.driver.close();
+            this.driver = null;
+        }
+    }
+}
+exports.ExisWorker = ExisWorker;
+//# sourceMappingURL=worker.js.map

package/dist/queue/worker.js.map

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

package/dist/response/index.d.ts

@@ -0,0 +1,16 @@
+export type SuccessResponse<T> = {
+    success: true;
+    message?: string;
+    data: T;
+};
+export type ErrorResponse = {
+    success: false;
+    error: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+};
+export declare function success<T>(data: T, message?: string): SuccessResponse<T>;
+export declare function error(message: string, code?: string, details?: unknown): ErrorResponse;
+//# sourceMappingURL=index.d.ts.map

package/dist/response/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/response/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,OAAO,EAAE,IAAI,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,CAAC,CAAA;CACR,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAA;CACF,CAAA;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAIxE;AAED,wBAAgB,KAAK,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,GAChB,aAAa,CAKf"}

package/dist/response/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.success = success;
+exports.error = error;
+function success(data, message) {
+    const res = { success: true, data };
+    if (message !== undefined)
+        res.message = message;
+    return res;
+}
+function error(message, code, details) {
+    const res = { success: false, error: { message } };
+    if (code !== undefined)
+        res.error.code = code;
+    if (details !== undefined)
+        res.error.details = details;
+    return res;
+}
+//# sourceMappingURL=index.js.map

package/dist/response/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/response/index.ts"],"names":[],"mappings":";;AAeA,0BAIC;AAED,sBASC;AAfD,SAAgB,OAAO,CAAI,IAAO,EAAE,OAAgB;IAClD,MAAM,GAAG,GAAuB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACvD,IAAI,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;IAChD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAgB,KAAK,CACnB,OAAe,EACf,IAAa,EACb,OAAiB;IAEjB,MAAM,GAAG,GAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,CAAA;IACjE,IAAI,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;IAC7C,IAAI,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAA;IACtD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/router/gateway.d.ts

@@ -0,0 +1,64 @@
+import type { Handler, CorsConfig } from '../types';
+import type { ProviderDefinition } from '../di/container';
+export interface GatewayConfig {
+    /**
+     * Middleware to apply to all routes in this directory and subdirectories.
+     * Replaces the old router.use() globally for a folder.
+     */
+    middleware?: Handler[];
+    /**
+     * CORS configuration applied to all routes in this directory and subdirectories.
+     */
+    cors?: CorsConfig | boolean;
+    /**
+     * Default headers applied to all responses from routes in this directory.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Plugins to automatically register when this gateway is loaded.
+     */
+    plugins?: (import('../types').ExisPluginInstance | import('../types').ExisPlugin)[];
+    /**
+     * Module imports (other plugins or modules to load before this gateway).
+     * These are automatically deduplicated so singletons are only initialized once.
+     */
+    imports?: (import('../types').ExisPluginInstance | import('../types').ExisPlugin)[];
+    /**
+     * Providers to register into the Dependency Injection container.
+     */
+    providers?: [string, ProviderDefinition<any>][];
+    /**
+     * Exclude specific routes or patterns from this gateway's middleware, guards, and filters.
+     */
+    exclude?: (string | {
+        path: string;
+        methods?: import('../types').HttpMethod[];
+    })[];
+    /**
+     * Exception filters to apply to all routes in this directory and subdirectories.
+     */
+    filters?: any[];
+    /**
+     * Authorization guards to apply to all routes in this directory and subdirectories.
+     */
+    guards?: any[];
+    /**
+     * Response interceptors to apply to all routes in this directory and subdirectories.
+     */
+    interceptors?: any[];
+    /**
+     * Folder-scoped request timeout (in milliseconds).
+     * Can be a static number or a dynamic function evaluated per-request.
+     */
+    timeout?: number | ((req: import('../types').Request<any, any, any>) => number | undefined);
+    /**
+     * Cascading metadata (e.g., OpenAPI tags, roles) applied to all routes in this directory.
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * Defines a gateway that acts as the ultimate gatekeeper, controlling all traffic
+ * flowing into its subdirectories.
+ */
+export declare function defineGateway(config: GatewayConfig): GatewayConfig;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/router/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/router/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,EAAE,CAAA;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAA;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;OAEG;IACH,OAAO,CAAC,EAAE,CACN,OAAO,UAAU,EAAE,kBAAkB,GACrC,OAAO,UAAU,EAAE,UAAU,CAChC,EAAE,CAAA;IAEH;;;OAGG;IACH,OAAO,CAAC,EAAE,CACN,OAAO,UAAU,EAAE,kBAAkB,GACrC,OAAO,UAAU,EAAE,UAAU,CAChC,EAAE,CAAA;IAEH;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAA;IAE/C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,UAAU,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,EAAE,CAAA;IAElF;;OAEG;IACH,OAAO,CAAC,EAAE,GAAG,EAAE,CAAA;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;IAEd;;OAEG;IACH,YAAY,CAAC,EAAE,GAAG,EAAE,CAAA;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC,CAAA;IAE3F;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC/B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAElE"}

package/dist/router/gateway.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineGateway = defineGateway;
+/**
+ * Defines a gateway that acts as the ultimate gatekeeper, controlling all traffic
+ * flowing into its subdirectories.
+ */
+function defineGateway(config) {
+    return config;
+}
+//# sourceMappingURL=gateway.js.map

package/dist/router/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/router/gateway.ts"],"names":[],"mappings":";;AA8EA,sCAEC;AAND;;;GAGG;AACH,SAAgB,aAAa,CAAC,MAAqB;IACjD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/router/radix.d.ts

@@ -0,0 +1,42 @@
+import type { Route, RouteMatch } from '../types';
+declare const enum NodeKind {
+    STATIC = 0,
+    PARAM = 1,
+    WILDCARD = 2
+}
+declare class RadixNode {
+    kind: NodeKind;
+    part: string;
+    routeGET: Route | Route[] | null;
+    routePOST: Route | Route[] | null;
+    routeALL: Route | Route[] | null;
+    routeOther: Record<string, Route | Route[]> | null;
+    private _addRouteToArray;
+    staticChildren: RadixNode[] | null;
+    staticChildKeys: string[] | null;
+    paramChild: RadixNode | null;
+    paramName: string;
+    wildcardChild: RadixNode | null;
+    wildcardName: string;
+    setRoute(method: string, route: Route): void;
+    getRoute(method: string, host?: string): {
+        route: Route;
+        hostParams?: Record<string, string>;
+    } | null;
+    findStaticChild(segment: string): RadixNode | null;
+    addStaticChild(segment: string, child: RadixNode): void;
+}
+export declare class RadixTree {
+    root: RadixNode;
+    private cache;
+    private cacheSize;
+    private maxCacheSize;
+    insert(method: string, path: string, route: Route): void;
+    search(method: string, path: string, host?: string): RouteMatch | null;
+    private _addToCache;
+    private _staticWalk;
+    private _linearWalk;
+    private _backtrackSearch;
+}
+export { RadixNode };
+//# sourceMappingURL=radix.d.ts.map

package/dist/router/radix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radix.d.ts","sourceRoot":"","sources":["../../src/router/radix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAIjD,mBAAW,QAAQ;IACjB,MAAM,IAAI;IACV,KAAK,IAAI;IACT,QAAQ,IAAI;CACb;AAKD,cAAM,SAAS;IAEb,IAAI,EAAE,QAAQ,CAAkB;IAChC,IAAI,SAAK;IAMT,QAAQ,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAO;IACvC,SAAS,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAO;IACxC,QAAQ,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAO;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAO;IAEzD,OAAO,CAAC,gBAAgB;IAoBxB,cAAc,EAAE,SAAS,EAAE,GAAG,IAAI,CAAO;IACzC,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAO;IAGvC,UAAU,EAAE,SAAS,GAAG,IAAI,CAAO;IACnC,SAAS,SAAK;IAGd,aAAa,EAAE,SAAS,GAAG,IAAI,CAAO;IACtC,YAAY,SAAK;IAEjB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IA8B5C,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI;IA6D/D,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAUlD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;CASxD;AAID,qBAAa,SAAS;IACpB,IAAI,EAAE,SAAS,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,YAAY,CAAO;IAI3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAiExD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IA4BtE,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,WAAW;IAuCnB,OAAO,CAAC,WAAW;IAwHnB,OAAO,CAAC,gBAAgB;CA+FzB;AA+CD,OAAO,EAAE,SAAS,EAAE,CAAA"}