exisjs 0.1.2

package/dist/cli/utils.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.c = void 0;
+exports.banner = banner;
+exports.log = log;
+exports.success = success;
+exports.warn = warn;
+exports.error = error;
+exports.info = info;
+// Terminal colors (no chalk dependency needed for these basics)
+exports.c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    gray: '\x1b[90m',
+    magenta: '\x1b[35m',
+    bgCyan: '\x1b[46m',
+    bgBlack: '\x1b[40m',
+    bgMagenta: '\x1b[45m',
+    primary: '\x1b[38;2;160;70;255m',
+    blue: '\x1b[38;2;41;169;206m',
+};
+function banner() {
+    console.log(`
+${exports.c.primary}${exports.c.bold} ███████╗██╗  ██╗██╗███████╗      ██╗███████╗${exports.c.reset}
+${exports.c.primary}${exports.c.bold} ██╔════╝╚██╗██╔╝██║██╔════╝      ██║██╔════╝${exports.c.reset}
+${exports.c.primary}${exports.c.bold} █████╗   ╚███╔╝ ██║███████╗      ██║███████╗${exports.c.reset}
+${exports.c.primary}${exports.c.bold} ██╔══╝   ██╔██╗ ██║╚════██║ ██   ██║╚════██║${exports.c.reset}
+${exports.c.primary}${exports.c.bold} ███████╗██╔╝ ██╗██║███████║ ███████║███████║${exports.c.reset}
+${exports.c.primary}${exports.c.bold} ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝ ╚══════╝╚══════╝${exports.c.reset}
+${exports.c.gray}  The elegantly structured TypeScript Node.js framework${exports.c.reset}
+`);
+}
+function log(msg) {
+    console.log(`  ${msg}`);
+}
+function success(msg) {
+    console.log(`${exports.c.green}✓${exports.c.reset} ${msg}`);
+}
+function warn(msg) {
+    console.log(`${exports.c.yellow}⚠${exports.c.reset} ${msg}`);
+}
+function error(msg) {
+    console.error(`${exports.c.red}✗${exports.c.reset} ${msg}`);
+}
+function info(msg) {
+    console.log(`${exports.c.gray}  ${msg}${exports.c.reset}`);
+}
+//# sourceMappingURL=utils.js.map

package/dist/cli/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":";;;AAmBA,wBAUC;AAED,kBAEC;AAED,0BAEC;AAED,oBAEC;AAED,sBAEC;AAED,oBAEC;AAjDD,gEAAgE;AACnD,QAAA,CAAC,GAAG;IACf,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE,uBAAuB;IAChC,IAAI,EAAE,uBAAuB;CAC9B,CAAA;AAED,SAAgB,MAAM;IACpB,OAAO,CAAC,GAAG,CAAC;EACZ,SAAC,CAAC,OAAO,GAAG,SAAC,CAAC,IAAI,gDAAgD,SAAC,CAAC,KAAK;EACzE,SAAC,CAAC,OAAO,GAAG,SAAC,CAAC,IAAI,gDAAgD,SAAC,CAAC,KAAK;EACzE,SAAC,CAAC,OAAO,GAAG,SAAC,CAAC,IAAI,gDAAgD,SAAC,CAAC,KAAK;EACzE,SAAC,CAAC,OAAO,GAAG,SAAC,CAAC,IAAI,gDAAgD,SAAC,CAAC,KAAK;EACzE,SAAC,CAAC,OAAO,GAAG,SAAC,CAAC,IAAI,gDAAgD,SAAC,CAAC,KAAK;EACzE,SAAC,CAAC,OAAO,GAAG,SAAC,CAAC,IAAI,gDAAgD,SAAC,CAAC,KAAK;EACzE,SAAC,CAAC,IAAI,0DAA0D,SAAC,CAAC,KAAK;CACxE,CAAC,CAAA;AACF,CAAC;AAED,SAAgB,GAAG,CAAC,GAAW;IAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAA;AACzB,CAAC;AAED,SAAgB,OAAO,CAAC,GAAW;IACjC,OAAO,CAAC,GAAG,CAAC,GAAG,SAAC,CAAC,KAAK,IAAI,SAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AAC7C,CAAC;AAED,SAAgB,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,SAAC,CAAC,MAAM,IAAI,SAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AAC9C,CAAC;AAED,SAAgB,KAAK,CAAC,GAAW;IAC/B,OAAO,CAAC,KAAK,CAAC,GAAG,SAAC,CAAC,GAAG,IAAI,SAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AAC7C,CAAC;AAED,SAAgB,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,SAAC,CAAC,IAAI,KAAK,GAAG,GAAG,SAAC,CAAC,KAAK,EAAE,CAAC,CAAA;AAC5C,CAAC"}

package/dist/config/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Configuration Phases
+ *
+ * Used to determine the current execution context when evaluating
+ * the `exis.config.ts` configuration file.
+ */
+export declare const PHASE_DEVELOPMENT_SERVER = "phase-development-server";
+export declare const PHASE_PRODUCTION_BUILD = "phase-production-build";
+export declare const PHASE_PRODUCTION_SERVER = "phase-production-server";
+export declare const PHASE_TEST = "phase-test";
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAClE,eAAO,MAAM,sBAAsB,2BAA2B,CAAA;AAC9D,eAAO,MAAM,uBAAuB,4BAA4B,CAAA;AAChE,eAAO,MAAM,UAAU,eAAe,CAAA"}

package/dist/config/constants.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Configuration Phases
+ *
+ * Used to determine the current execution context when evaluating
+ * the `exis.config.ts` configuration file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHASE_TEST = exports.PHASE_PRODUCTION_SERVER = exports.PHASE_PRODUCTION_BUILD = exports.PHASE_DEVELOPMENT_SERVER = void 0;
+exports.PHASE_DEVELOPMENT_SERVER = 'phase-development-server';
+exports.PHASE_PRODUCTION_BUILD = 'phase-production-build';
+exports.PHASE_PRODUCTION_SERVER = 'phase-production-server';
+exports.PHASE_TEST = 'phase-test';
+//# sourceMappingURL=constants.js.map

package/dist/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,wBAAwB,GAAG,0BAA0B,CAAA;AACrD,QAAA,sBAAsB,GAAG,wBAAwB,CAAA;AACjD,QAAA,uBAAuB,GAAG,yBAAyB,CAAA;AACnD,QAAA,UAAU,GAAG,YAAY,CAAA"}

package/dist/cron/parser.d.ts

@@ -0,0 +1,2 @@
+export declare function parseCronExpression(expression: string, date: Date): boolean;
+//# sourceMappingURL=parser.d.ts.map

package/dist/cron/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/cron/parser.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAiB3E"}

package/dist/cron/parser.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCronExpression = parseCronExpression;
+function parseCronExpression(expression, date) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new Error(`Invalid cron expression: "${expression}". Expected 5 parts (min hr dom mth dow)`);
+    }
+    const [min, hr, dom, mth, dow] = parts;
+    return (matchCronPart(min, date.getMinutes()) &&
+        matchCronPart(hr, date.getHours()) &&
+        matchCronPart(dom, date.getDate()) &&
+        matchCronPart(mth, date.getMonth() + 1) && // JS months are 0-indexed
+        matchCronPart(dow, date.getDay()));
+}
+function matchCronPart(part, value) {
+    if (part === '*')
+        return true;
+    // Support lists e.g., "1,5,10"
+    if (part.includes(',')) {
+        return part.split(',').some((p) => matchCronPart(p, value));
+    }
+    // Support steps e.g., "*/5" or "10/2"
+    if (part.includes('/')) {
+        const [rangeStr, stepStr] = part.split('/');
+        const step = parseInt(stepStr, 10);
+        if (rangeStr === '*') {
+            return value % step === 0;
+        }
+        // Support range with steps e.g. "1-10/2"
+        if (rangeStr.includes('-')) {
+            const [startStr, endStr] = rangeStr.split('-');
+            const start = parseInt(startStr, 10);
+            const end = parseInt(endStr, 10);
+            if (value >= start && value <= end) {
+                return (value - start) % step === 0;
+            }
+            return false;
+        }
+        // e.g., "10/2" -> value must be >= 10, and (value - 10) % 2 === 0
+        const start = parseInt(rangeStr, 10);
+        return value >= start && (value - start) % step === 0;
+    }
+    // Support ranges e.g., "1-5"
+    if (part.includes('-')) {
+        const [startStr, endStr] = part.split('-');
+        return value >= parseInt(startStr, 10) && value <= parseInt(endStr, 10);
+    }
+    // Exact match
+    return parseInt(part, 10) === value;
+}
+//# sourceMappingURL=parser.js.map

package/dist/cron/parser.js.map

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

package/dist/cron/scheduler.d.ts

@@ -0,0 +1,22 @@
+import type { JobDefinition } from '../queue/types';
+import type Redis from 'ioredis';
+import type { ExisWorker } from '../queue/worker';
+import type { LogFn } from '../types';
+export declare class CronScheduler {
+    private jobs;
+    private timer;
+    private redis;
+    private worker;
+    private logger;
+    private prefix;
+    constructor(worker: ExisWorker | null, redis: Redis | null, logger: {
+        error: LogFn;
+        info: LogFn;
+        debug: LogFn;
+    });
+    registerJob(job: JobDefinition): void;
+    start(): void;
+    private tick;
+    stop(): void;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/cron/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/cron/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,MAAM,CAAc;gBAG1B,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,MAAM,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE;IAOrD,WAAW,CAAC,GAAG,EAAE,aAAa;IAO9B,KAAK;YAsBS,IAAI;IAsElB,IAAI;CAOL"}

package/dist/cron/scheduler.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CronScheduler = void 0;
+const parser_1 = require("./parser");
+class CronScheduler {
+    constructor(worker, redis, logger) {
+        this.jobs = [];
+        this.timer = null;
+        this.redis = null;
+        this.worker = null;
+        this.prefix = 'exis:cron';
+        this.worker = worker;
+        this.redis = redis;
+        this.logger = logger;
+    }
+    registerJob(job) {
+        if (job.cron) {
+            this.jobs.push(job);
+            this.logger.info(`Scheduled cron job ${job.name} (${job.cron})`);
+        }
+    }
+    start() {
+        if (this.jobs.length === 0)
+            return;
+        if (!this.worker) {
+            this.logger.error('CronScheduler cannot start: Queue Worker is disabled.');
+            return;
+        }
+        // Align to the next exact minute
+        const now = new Date();
+        const msUntilNextMinute = 60000 - (now.getSeconds() * 1000 + now.getMilliseconds());
+        this.timer = setTimeout(() => {
+            this.tick();
+            // Now run exactly every 60 seconds
+            this.timer = setInterval(() => this.tick(), 60000);
+            this.timer.unref?.();
+        }, msUntilNextMinute);
+        this.timer.unref?.();
+    }
+    async tick() {
+        const now = new Date();
+        // Zero out seconds/milliseconds for precise cron matching
+        now.setSeconds(0, 0);
+        for (const job of this.jobs) {
+            if (!job.cron)
+                continue;
+            try {
+                if ((0, parser_1.parseCronExpression)(job.cron, now)) {
+                    // If Redis is configured, use SETNX to acquire a lock for this minute
+                    // This guarantees that across a 10-server cluster, the job only runs ONCE.
+                    let shouldRun = true;
+                    if (this.redis) {
+                        const lockKey = `${this.prefix}:lock:${job.name}:${now.getTime()}`;
+                        // Lock expires in 55 seconds to clean itself up
+                        const acquired = await this.redis.set(lockKey, 'locked', 'EX', 55, 'NX');
+                        if (!acquired) {
+                            shouldRun = false;
+                        }
+                    }
+                    if (shouldRun) {
+                        this.logger.debug(`Triggering cron job: ${job.name}`);
+                        // We just enqueue an empty object for cron triggers!
+                        const id = Date.now().toString() +
+                            '-' +
+                            Math.random().toString(36).substring(2, 9);
+                        if (this.redis) {
+                            const payload = {
+                                id,
+                                name: job.name,
+                                data: {},
+                                attemptsMade: 0,
+                            };
+                            await this.redis.rpush(`exis:queue:${job.name}:pending`, JSON.stringify(payload));
+                        }
+                        else if (this.worker) {
+                            // Fallback for completely memory-based setups without Redis
+                            // We'll directly invoke the worker processJob method (but it's private...)
+                            // Since worker poll reads from Redis, if they don't have Redis they shouldn't be using cron.
+                            // We will just throw an error if no redis but has worker.
+                            // Wait, they can use cron locally! We can expose a trigger method on the worker or threadpool.
+                            // Actually, ExisWorker is designed to be Redis-backed.
+                            // We can just log an error if Redis is not configured but they are trying to run cron.
+                            this.logger.error(`Cron requires Redis to distribute the queue payload for ${job.name}.`);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                this.logger.error(`Failed to parse cron for ${job.name}: ${err.message}`);
+            }
+        }
+    }
+    stop() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+exports.CronScheduler = CronScheduler;
+//# sourceMappingURL=scheduler.js.map

package/dist/cron/scheduler.js.map

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

package/dist/dataloader/dataloader.d.ts

@@ -0,0 +1,23 @@
+export type BatchLoadFn<K, V> = (keys: readonly K[]) => Promise<readonly (V | Error)[]>;
+export interface DataloaderOptions<K, C = K> {
+    cache?: boolean;
+    maxBatchSize?: number;
+    cacheKeyFn?: (key: K) => C;
+}
+export declare class Dataloader<K, V, C = K> {
+    private batchFn;
+    private options;
+    private cacheMap;
+    private queue;
+    private dispatchScheduled;
+    constructor(batchFn: BatchLoadFn<K, V>, options?: DataloaderOptions<K, C>);
+    private getCacheKey;
+    load(key: K): Promise<V>;
+    loadMany(keys: readonly K[]): Promise<V[]>;
+    clear(key: K): this;
+    clearAll(): this;
+    prime(key: K, value: V | Error): this;
+    private dispatch;
+    private dispatchBatch;
+}
+//# sourceMappingURL=dataloader.d.ts.map

package/dist/dataloader/dataloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataloader.d.ts","sourceRoot":"","sources":["../../src/dataloader/dataloader.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,CAC9B,IAAI,EAAE,SAAS,CAAC,EAAE,KACf,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAA;AAEpC,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;CAC3B;AAED,qBAAa,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC;IAU/B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IAVjB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,KAAK,CAIL;IACR,OAAO,CAAC,iBAAiB,CAAQ;gBAGvB,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,OAAO,GAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAM;IAG/C,OAAO,CAAC,WAAW;IAWnB,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwBxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAI1C,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAKnB,QAAQ,IAAI,IAAI;IAKhB,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,GAAG,IAAI;YAUvB,QAAQ;YAgBR,aAAa;CA6B5B"}

package/dist/dataloader/dataloader.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Dataloader = void 0;
+class Dataloader {
+    constructor(batchFn, options = {}) {
+        this.batchFn = batchFn;
+        this.options = options;
+        this.cacheMap = new Map();
+        this.queue = [];
+        this.dispatchScheduled = false;
+    }
+    getCacheKey(key) {
+        if (this.options.cacheKeyFn) {
+            return this.options.cacheKeyFn(key);
+        }
+        // Default fallback: if key is an object, stringify it to prevent reference-equality cache misses
+        if (typeof key === 'object' && key !== null) {
+            return JSON.stringify(key);
+        }
+        return key;
+    }
+    load(key) {
+        const shouldCache = this.options.cache !== false;
+        const cacheKey = this.getCacheKey(key);
+        if (shouldCache && this.cacheMap.has(cacheKey)) {
+            return this.cacheMap.get(cacheKey);
+        }
+        const promise = new Promise((resolve, reject) => {
+            this.queue.push({ key, resolve, reject });
+        });
+        if (shouldCache) {
+            this.cacheMap.set(cacheKey, promise);
+        }
+        if (!this.dispatchScheduled) {
+            this.dispatchScheduled = true;
+            process.nextTick(() => this.dispatch());
+        }
+        return promise;
+    }
+    loadMany(keys) {
+        return Promise.all(keys.map((key) => this.load(key)));
+    }
+    clear(key) {
+        this.cacheMap.delete(this.getCacheKey(key));
+        return this;
+    }
+    clearAll() {
+        this.cacheMap.clear();
+        return this;
+    }
+    prime(key, value) {
+        const cacheKey = this.getCacheKey(key);
+        if (!this.cacheMap.has(cacheKey)) {
+            const promise = value instanceof Error ? Promise.reject(value) : Promise.resolve(value);
+            this.cacheMap.set(cacheKey, promise);
+        }
+        return this;
+    }
+    async dispatch() {
+        this.dispatchScheduled = false;
+        const queue = this.queue;
+        this.queue = [];
+        if (queue.length === 0)
+            return;
+        const maxBatchSize = this.options.maxBatchSize || 1000;
+        // Split into batches if needed
+        for (let i = 0; i < queue.length; i += maxBatchSize) {
+            const batch = queue.slice(i, i + maxBatchSize);
+            this.dispatchBatch(batch);
+        }
+    }
+    async dispatchBatch(batch) {
+        const keys = batch.map((q) => q.key);
+        try {
+            const results = await this.batchFn(keys);
+            if (!Array.isArray(results) || results.length !== keys.length) {
+                throw new Error('Dataloader batch function must return an array of the same length as the keys array');
+            }
+            for (let i = 0; i < batch.length; i++) {
+                const result = results[i];
+                if (result instanceof Error) {
+                    batch[i].reject(result);
+                }
+                else {
+                    batch[i].resolve(result);
+                }
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            for (const q of batch) {
+                q.reject(error);
+            }
+        }
+    }
+}
+exports.Dataloader = Dataloader;
+//# sourceMappingURL=dataloader.js.map

package/dist/dataloader/dataloader.js.map

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

package/dist/dataloader/registry.d.ts

@@ -0,0 +1,17 @@
+import type { Dataloader } from './dataloader';
+/**
+ * Defines a registry of per-request Dataloaders securely bound to the Exis context.
+ */
+export declare function defineLoaders<T extends Record<string, () => Dataloader<any, any>>>(factories: T): {
+    /**
+     * Middleware that lazy-initializes all loaders into the current request context.
+     * Register this globally or on a gateway.
+     */
+    loaderMiddleware: (req: any, res: any, next: any) => void;
+    /**
+     * Strongly-typed hook to retrieve the isolated loaders anywhere in the codebase
+     * without needing to pass the req object.
+     */
+    getLoaders: () => { [K in keyof T]: ReturnType<T[K]>; };
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/dataloader/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/dataloader/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C;;GAEG;AACH,wBAAgB,aAAa,CAC3B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EACpD,SAAS,EAAE,CAAC;IAEV;;;OAGG;4BACqB,GAAG,OAAO,GAAG,QAAQ,GAAG;IAsBhD;;;OAGG;yBAGa,CAAC;EAWpB"}

package/dist/dataloader/registry.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineLoaders = defineLoaders;
+const context_1 = require("../server/context");
+/**
+ * Defines a registry of per-request Dataloaders securely bound to the Exis context.
+ */
+function defineLoaders(factories) {
+    return {
+        /**
+         * Middleware that lazy-initializes all loaders into the current request context.
+         * Register this globally or on a gateway.
+         */
+        loaderMiddleware: (req, res, next) => {
+            const instances = {};
+            // We lazily instantiate the loaders so we don't pay the penalty
+            // if a specific loader isn't used in this request.
+            for (const key of Object.keys(factories)) {
+                Object.defineProperty(instances, key, {
+                    get: () => {
+                        if (!instances[`_${key}`]) {
+                            instances[`_${key}`] = factories[key]();
+                        }
+                        return instances[`_${key}`];
+                    },
+                    enumerable: true,
+                });
+            }
+            (0, context_1.setContext)('loaders', instances);
+            if (next)
+                next();
+        },
+        /**
+         * Strongly-typed hook to retrieve the isolated loaders anywhere in the codebase
+         * without needing to pass the req object.
+         */
+        getLoaders: () => {
+            const state = (0, context_1.getContext)();
+            if (!state || !state.loaders) {
+                throw new Error('getLoaders() was called, but the loaderMiddleware is not registered. ' +
+                    'Please ensure loaderMiddleware is added to your app or gateway.');
+            }
+            return state.loaders;
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/dataloader/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/dataloader/registry.ts"],"names":[],"mappings":";;AAMA,sCA+CC;AArDD,+CAA0D;AAG1D;;GAEG;AACH,SAAgB,aAAa,CAE3B,SAAY;IACZ,OAAO;QACL;;;WAGG;QACH,gBAAgB,EAAE,CAAC,GAAQ,EAAE,GAAQ,EAAE,IAAS,EAAE,EAAE;YAClD,MAAM,SAAS,GAAG,EAAS,CAAA;YAE3B,gEAAgE;YAChE,mDAAmD;YACnD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE;oBACpC,GAAG,EAAE,GAAG,EAAE;wBACR,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC;4BAC1B,SAAS,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAA;wBACzC,CAAC;wBACD,OAAO,SAAS,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;oBAC7B,CAAC;oBACD,UAAU,EAAE,IAAI;iBACjB,CAAC,CAAA;YACJ,CAAC;YAED,IAAA,oBAAU,EAAC,SAAS,EAAE,SAAS,CAAC,CAAA;YAEhC,IAAI,IAAI;gBAAE,IAAI,EAAE,CAAA;QAClB,CAAC;QAED;;;WAGG;QACH,UAAU,EAAE,GAAG,EAAE;YACf,MAAM,KAAK,GAAG,IAAA,oBAAU,GAEpB,CAAA;YACJ,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,uEAAuE;oBACrE,iEAAiE,CACpE,CAAA;YACH,CAAC;YACD,OAAO,KAAK,CAAC,OAAO,CAAA;QACtB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,63 @@
+import type { HttpMethod, RouteSchema } from '../types';
+export declare const ROUTE_REGISTRY: unique symbol;
+export declare const CONTROLLER_PREFIX: unique symbol;
+export declare const CONTROLLER_HOST: unique symbol;
+export declare const MIDDLEWARE_REGISTRY: unique symbol;
+export declare const ROUTE_METADATA: unique symbol;
+export declare const LIFECYCLE_METADATA: unique symbol;
+export declare const PARAM_METADATA: unique symbol;
+export interface RouteMeta {
+    method: HttpMethod;
+    path: string;
+    schema?: RouteSchema<any, any, any, any>;
+    handlerName: string;
+}
+export interface ControllerOptions {
+    prefix?: string;
+    host?: string;
+}
+/**
+ * Marks a class as a controller, automatically grouping its routes under the provided prefix.
+ * Uses standard ES decorators, completely avoiding reflect-metadata bloat.
+ */
+export declare function Controller(prefixOrOptions?: string | ControllerOptions): any;
+export declare const Get: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Post: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Put: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Patch: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Delete: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Options: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Head: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const All: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Connect: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Trace: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Ws: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare const Sse: (path?: string, schema?: RouteSchema<any, any, any, any>) => any;
+export declare function Use(...middlewares: any[]): any;
+export declare function HttpCode(code: number): any;
+export declare function Header(name: string, value: string): any;
+export declare function UseGuards(...guards: any[]): any;
+export declare function UseInterceptors(...interceptors: any[]): any;
+export declare function UseFilters(...filters: any[]): any;
+export declare const Param: (nameOrPipe?: string | any, ...pipes: any[]) => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Body: (nameOrPipe?: string | any, ...pipes: any[]) => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Headers: (nameOrPipe?: string | any, ...pipes: any[]) => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const HostParam: (nameOrPipe?: string | any, ...pipes: any[]) => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Req: () => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Socket: () => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Stream: () => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Session: () => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Next: () => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Ip: () => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const UploadedFile: (nameOrPipe?: string | any, ...pipes: any[]) => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const UploadedFiles: (nameOrPipe?: string | any, ...pipes: any[]) => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+export declare const Res: (options?: {
+    passthrough?: boolean;
+}) => any;
+export declare function Query(pathOrName?: string | any, schemaOrPipe?: RouteSchema<any, any, any, any> | any, ...pipes: any[]): any;
+export declare const Redirect: (url: string, statusCode?: number) => any;
+export declare const Hosts: (...hosts: string[]) => any;
+export declare function Injectable(options?: {
+    scope?: 'singleton' | 'request';
+}): any;
+//# sourceMappingURL=index.d.ts.map

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

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