@engjts/nexus 0.1.0

package/dist/advanced/graphql/server.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphQLServer = void 0;
+const graphql_1 = require("graphql");
+class GraphQLServer {
+    schema;
+    options;
+    constructor(options) {
+        this.schema = options.schema;
+        this.options = {
+            playground: options.playground ?? false,
+            introspection: options.introspection ?? process.env.NODE_ENV !== 'production',
+            dataloaders: options.dataloaders ?? true,
+            ...options
+        };
+    }
+    /**
+     * Returns a framework route handler
+     */
+    handler() {
+        return async (ctx) => {
+            if (ctx.method === 'GET' && this.shouldRenderPlayground(ctx)) {
+                return ctx.html(this.renderPlayground());
+            }
+            const payload = await this.parseRequest(ctx);
+            const document = this.parseDocument(payload.query);
+            this.enforceRules(document, payload);
+            const cacheKey = await this.computeCacheKey(payload);
+            if (cacheKey) {
+                const cached = await this.options.cache.instance.get(cacheKey);
+                if (cached) {
+                    return this.buildResponse(cached);
+                }
+            }
+            const contextValue = await this.buildContext(ctx);
+            const result = await (0, graphql_1.execute)({
+                schema: this.schema,
+                document,
+                variableValues: payload.variables,
+                operationName: payload.operationName,
+                contextValue
+            });
+            if (cacheKey && !result.errors) {
+                await this.options.cache.instance.set(cacheKey, result, { ttl: this.options.cache?.ttl });
+            }
+            return this.buildResponse(result);
+        };
+    }
+    shouldRenderPlayground(ctx) {
+        if (!this.options.playground) {
+            return false;
+        }
+        const accept = ctx.headers['accept'];
+        if (!accept)
+            return false;
+        const acceptHeader = Array.isArray(accept) ? accept.join(',') : accept;
+        return acceptHeader.includes('text/html');
+    }
+    async parseRequest(ctx) {
+        if (ctx.method === 'GET') {
+            return {
+                query: ctx.query.query,
+                variables: this.safeParseJSON(ctx.query.variables),
+                operationName: ctx.query.operationName
+            };
+        }
+        if (typeof ctx.body === 'string') {
+            return JSON.parse(ctx.body);
+        }
+        return ctx.body ?? {};
+    }
+    parseDocument(query) {
+        if (!query) {
+            throw new Error('GraphQL query is required');
+        }
+        return (0, graphql_1.parse)(query);
+    }
+    enforceRules(document, payload) {
+        if (!this.options.introspection) {
+            const operation = (0, graphql_1.getOperationAST)(document, payload.operationName || undefined);
+            if (operation?.operation === 'query' && operation.name?.value === '__schema') {
+                throw new Error('Introspection is disabled');
+            }
+        }
+        const validationErrors = (0, graphql_1.validate)(this.schema, document);
+        if (validationErrors.length > 0) {
+            throw validationErrors[0];
+        }
+        if (this.options.depthLimit !== undefined) {
+            const depth = this.calculateDepth(document);
+            if (depth > this.options.depthLimit) {
+                throw new Error(`Query depth ${depth} exceeds limit of ${this.options.depthLimit}`);
+            }
+        }
+        if (this.options.complexity) {
+            const complexity = this.calculateComplexity(document, this.options.complexity);
+            if (complexity > this.options.complexity.limit) {
+                throw new Error(`Query complexity ${complexity} exceeds limit of ${this.options.complexity.limit}`);
+            }
+        }
+    }
+    async buildContext(ctx) {
+        const base = typeof this.options.context === 'function'
+            ? await this.options.context({ ctx })
+            : this.options.context ?? {};
+        if (this.options.dataloaders) {
+            Object.assign(base, { loaders: {} });
+        }
+        return { ...base, request: ctx };
+    }
+    calculateDepth(document) {
+        let maxDepth = 0;
+        const traverse = (node, depth) => {
+            if (!node.selectionSet) {
+                return;
+            }
+            depth += 1;
+            maxDepth = Math.max(maxDepth, depth);
+            for (const selection of node.selectionSet.selections) {
+                traverse(selection, depth);
+            }
+        };
+        for (const definition of document.definitions) {
+            if (definition.kind === graphql_1.Kind.OPERATION_DEFINITION) {
+                traverse(definition, 0);
+            }
+        }
+        return maxDepth;
+    }
+    calculateComplexity(document, options) {
+        const costs = options.cost || {};
+        const defaultCost = options.defaultCost ?? 1;
+        let complexity = 0;
+        const visitNode = (node) => {
+            if (!node.selectionSet) {
+                return;
+            }
+            for (const selection of node.selectionSet.selections) {
+                if (selection.kind === graphql_1.Kind.FIELD) {
+                    const fieldName = selection.name.value;
+                    complexity += costs[fieldName] ?? defaultCost;
+                }
+                visitNode(selection);
+            }
+        };
+        for (const definition of document.definitions) {
+            if (definition.kind === graphql_1.Kind.OPERATION_DEFINITION) {
+                visitNode(definition);
+            }
+        }
+        return complexity;
+    }
+    async computeCacheKey(payload) {
+        if (!this.options.cache) {
+            return null;
+        }
+        const generator = this.options.cache.keyGenerator ??
+            ((data) => JSON.stringify(data));
+        return generator(payload);
+    }
+    buildResponse(result) {
+        if (result.errors && this.options.formatError) {
+            result = {
+                ...result,
+                errors: result.errors.map(err => this.options.formatError(err))
+            };
+        }
+        return {
+            statusCode: result.errors ? 400 : 200,
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(result)
+        };
+    }
+    safeParseJSON(value) {
+        if (!value)
+            return undefined;
+        try {
+            if (typeof value === 'string') {
+                return JSON.parse(value);
+            }
+            return value;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    renderPlayground() {
+        return `
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset=utf-8/>
+    <title>GraphQL Playground</title>
+    <link rel="stylesheet" href="https://unpkg.com/graphql-playground-react/build/static/css/index.css" />
+    <link rel="shortcut icon" href="https://raw.githubusercontent.com/graphql/graphql-playground/main/packages/graphql-playground-react/public/favicon.png" />
+    <script src="https://unpkg.com/graphql-playground-react/build/static/js/middleware.js"></script>
+  </head>
+  <body>
+    <div id="root" />
+    <script>window.addEventListener('load', function () {
+      GraphQLPlayground.init(document.getElementById('root'), { endpoint: '/graphql' })
+    })</script>
+  </body>
+</html>`;
+    }
+}
+exports.GraphQLServer = GraphQLServer;
+//# sourceMappingURL=server.js.map

package/dist/advanced/graphql/server.js.map

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

package/dist/advanced/graphql/types.d.ts

@@ -0,0 +1,45 @@
+import { GraphQLSchema } from "graphql";
+import { Context } from "vm";
+import { MultiTierCache } from "../cache";
+import { SimpleDataLoader } from "./SimpleDataLoader";
+export interface GraphQLComplexityOptions {
+    limit: number;
+    cost?: Record<string, number>;
+    defaultCost?: number;
+}
+export interface GraphQLCacheOptions {
+    instance: MultiTierCache<any>;
+    ttl?: number;
+    keyGenerator?: (payload: GraphQLRequestPayload) => string;
+}
+export interface GraphQLRequestPayload {
+    query?: string;
+    variables?: Record<string, any>;
+    operationName?: string;
+}
+export interface GraphQLServerOptions {
+    schema: GraphQLSchema;
+    context?: (args: {
+        ctx: Context;
+    }) => Promise<Record<string, any>> | Record<string, any>;
+    playground?: boolean;
+    introspection?: boolean;
+    cache?: GraphQLCacheOptions;
+    complexity?: GraphQLComplexityOptions;
+    depthLimit?: number;
+    dataloaders?: boolean;
+    formatError?: (error: any) => any;
+    logger?: {
+        debug?: (...args: any[]) => void;
+        error?: (...args: any[]) => void;
+    };
+}
+export interface SimpleDataLoaderBatch<Key = any, Value = any> {
+    keys: Key[];
+    resolvers: Array<{
+        resolve: (value: Value) => void;
+        reject: (error: Error) => void;
+    }>;
+}
+export type DataLoaderFactory = (ctx: Context) => Record<string, SimpleDataLoader>;
+//# sourceMappingURL=types.d.ts.map

package/dist/advanced/graphql/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/advanced/graphql/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,MAAM,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;IAClC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CACnF;AAED,MAAM,WAAW,qBAAqB,CAAC,GAAG,GAAG,GAAG,EAAE,KAAK,GAAG,GAAG;IACzD,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;KAAE,CAAC,CAAC;CACzF;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/advanced/graphql/types.js

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

package/dist/advanced/graphql/types.js.map

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

package/dist/advanced/jobs/InMemoryQueueStore.d.ts

@@ -0,0 +1,14 @@
+import { QueueStore, Job, JobState, QueueStats } from './types';
+/**
+ * Simple in-memory queue store implementation
+ */
+export declare class InMemoryQueueStore<Data = any> implements QueueStore<Data> {
+    private jobs;
+    enqueue(job: Job<Data>): Promise<void>;
+    dequeue(): Promise<Job<Data> | undefined>;
+    update(job: Job<Data>): Promise<void>;
+    get(id: string): Promise<Job<Data> | undefined>;
+    list(state?: JobState): Promise<Job<Data>[]>;
+    stats(): Promise<QueueStats>;
+}
+//# sourceMappingURL=InMemoryQueueStore.d.ts.map

package/dist/advanced/jobs/InMemoryQueueStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryQueueStore.d.ts","sourceRoot":"","sources":["../../../src/advanced/jobs/InMemoryQueueStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhE;;GAEG;AAGH,qBAAa,kBAAkB,CAAC,IAAI,GAAG,GAAG,CAAE,YAAW,UAAU,CAAC,IAAI,CAAC;IACnE,OAAO,CAAC,IAAI,CAAqC;IAE3C,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAqBzC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAI/C,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;IAO5C,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;CAiBrC"}

package/dist/advanced/jobs/InMemoryQueueStore.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryQueueStore = void 0;
+/**
+ * Simple in-memory queue store implementation
+ */
+class InMemoryQueueStore {
+    jobs = new Map();
+    async enqueue(job) {
+        this.jobs.set(job.id, job);
+    }
+    async dequeue() {
+        const candidates = Array.from(this.jobs.values())
+            .filter(job => job.state === 'waiting' || (job.state === 'delayed' && job.runAt <= Date.now()))
+            .sort((a, b) => {
+            if (a.priority === b.priority) {
+                return a.runAt - b.runAt;
+            }
+            return b.priority - a.priority;
+        });
+        const job = candidates[0];
+        if (!job) {
+            return undefined;
+        }
+        job.state = 'active';
+        job.updatedAt = Date.now();
+        this.jobs.set(job.id, job);
+        return job;
+    }
+    async update(job) {
+        this.jobs.set(job.id, job);
+    }
+    async get(id) {
+        return this.jobs.get(id);
+    }
+    async list(state) {
+        if (!state) {
+            return Array.from(this.jobs.values());
+        }
+        return Array.from(this.jobs.values()).filter(job => job.state === state);
+    }
+    async stats() {
+        const stats = {
+            waiting: 0,
+            active: 0,
+            completed: 0,
+            failed: 0,
+            delayed: 0
+        };
+        for (const job of this.jobs.values()) {
+            if (job.state in stats) {
+                stats[job.state] += 1;
+            }
+        }
+        return stats;
+    }
+}
+exports.InMemoryQueueStore = InMemoryQueueStore;
+//# sourceMappingURL=InMemoryQueueStore.js.map

package/dist/advanced/jobs/InMemoryQueueStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryQueueStore.js","sourceRoot":"","sources":["../../../src/advanced/jobs/InMemoryQueueStore.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AAGH,MAAa,kBAAkB;IACnB,IAAI,GAA2B,IAAI,GAAG,EAAE,CAAC;IAEjD,KAAK,CAAC,OAAO,CAAC,GAAc;QACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO;QACT,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aAC5C,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;aAC9F,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACX,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC5B,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YAC7B,CAAC;YACD,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;QACnC,CAAC,CAAC,CAAC;QAEP,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC;QACrB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC;IACf,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAc;QACvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAgB;QACvB,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,KAAK,GAAe;YACtB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;SACb,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;gBACpB,KAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AA5DD,gDA4DC"}

package/dist/advanced/jobs/JobQueue.d.ts

@@ -0,0 +1,178 @@
+import { EventEmitter } from 'events';
+import { QueueOptions, JobHandler, EnqueueOptions, Job, QueueStats } from './types';
+/**
+ * Cron expression parser
+ * Supports: second minute hour dayOfMonth month dayOfWeek
+ *
+ * Examples:
+ * - '0 0 * * *' = Every day at midnight
+ * - '*\/5 * * * *' = Every 5 minutes
+ * - '0 9 * * 1-5' = 9 AM on weekdays
+ * - '0 0 1 * *' = First day of every month
+ */
+export interface CronSchedule {
+    /**
+     * Cron expression (5 or 6 fields)
+     * Standard: minute hour dayOfMonth month dayOfWeek
+     * Extended: second minute hour dayOfMonth month dayOfWeek
+     */
+    cron: string;
+    /**
+     * Timezone for the schedule (e.g., 'America/New_York')
+     * @default 'UTC'
+     */
+    timezone?: string;
+}
+/**
+ * Scheduled job configuration
+ */
+export interface ScheduledJobConfig<Data = any> {
+    /**
+     * Unique name for the scheduled job
+     */
+    name: string;
+    /**
+     * Cron schedule or interval
+     */
+    schedule: CronSchedule | number;
+    /**
+     * Job data generator or static data
+     */
+    data: Data | (() => Data | Promise<Data>);
+    /**
+     * Job handler
+     */
+    handler: JobHandler<Data, any>;
+    /**
+     * Whether to run immediately on startup
+     * @default false
+     */
+    runOnStart?: boolean;
+    /**
+     * Maximum instances that can run concurrently
+     * @default 1
+     */
+    maxConcurrency?: number;
+}
+/**
+ * Background job queue implementation with cron support
+ *
+ * @example
+ * ```typescript
+ * const queue = new JobQueue('tasks');
+ *
+ * // Regular job
+ * queue.process('sendEmail', async (job) => {
+ *   await sendEmail(job.data);
+ * });
+ *
+ * // Scheduled job (every 5 minutes)
+ * queue.schedule({
+ *   name: 'cleanup',
+ *   schedule: { cron: '*\/5 * * * *' },
+ *   data: {},
+ *   handler: async () => {
+ *     await cleanupOldData();
+ *   }
+ * });
+ *
+ * // Interval job (every 30 seconds)
+ * queue.schedule({
+ *   name: 'healthCheck',
+ *   schedule: 30000,
+ *   data: {},
+ *   handler: async () => {
+ *     await checkHealth();
+ *   }
+ * });
+ * ```
+ */
+export declare class JobQueue<Data = any, Result = any> extends EventEmitter {
+    name: string;
+    private options;
+    private handlers;
+    private store;
+    private activeWorkers;
+    private paused;
+    private limiterWindowStart;
+    private processedInWindow;
+    private scheduledJobs;
+    constructor(name: string, options?: QueueOptions<Data>);
+    /**
+     * Add a job to the queue
+     */
+    add(name: string, data: Data, options?: EnqueueOptions): Promise<Job<Data>>;
+    /**
+     * Add many jobs at once
+     */
+    addBulk(jobs: Array<{
+        name: string;
+        data: Data;
+        options?: EnqueueOptions;
+    }>): Promise<Job<Data, any>[]>;
+    /**
+     * Register a processor for a given job name
+     */
+    process(name: string, handler: JobHandler<Data, Result>): void;
+    /**
+     * Schedule a recurring job using cron expression or interval
+     *
+     * @example
+     * ```typescript
+     * // Cron: Every day at 9 AM
+     * queue.schedule({
+     *   name: 'dailyReport',
+     *   schedule: { cron: '0 9 * * *' },
+     *   data: { type: 'daily' },
+     *   handler: async (job) => generateReport(job.data)
+     * });
+     *
+     * // Interval: Every 30 seconds
+     * queue.schedule({
+     *   name: 'heartbeat',
+     *   schedule: 30000,
+     *   data: {},
+     *   handler: async () => sendHeartbeat()
+     * });
+     * ```
+     */
+    schedule(config: ScheduledJobConfig<Data>): void;
+    /**
+     * Remove a scheduled job
+     */
+    unschedule(name: string): boolean;
+    /**
+     * Get all scheduled jobs
+     */
+    getScheduledJobs(): string[];
+    /**
+     * Pause job processing
+     */
+    pause(): void;
+    /**
+     * Resume job processing
+     */
+    resume(): void;
+    /**
+     * Get queue statistics
+     */
+    stats(): Promise<QueueStats>;
+    /**
+     * Retry a failed job manually
+     */
+    retry(jobId: string): Promise<void>;
+    /**
+     * Shutdown the queue gracefully
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Internal worker loop
+     */
+    private work;
+    private executeJob;
+    private completeJob;
+    private failJob;
+    private calculateRetryDelay;
+    private canProcessDueToRateLimit;
+}
+//# sourceMappingURL=JobQueue.d.ts.map

package/dist/advanced/jobs/JobQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobQueue.d.ts","sourceRoot":"","sources":["../../../src/advanced/jobs/JobQueue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAc,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhG;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IACzB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,IAAI,GAAG,GAAG;IAC1C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAC;IAEhC;;OAEG;IACH,IAAI,EAAE,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1C;;OAEG;IACH,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE/B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAqFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,QAAQ,CAAC,IAAI,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,CAAE,SAAQ,YAAY;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,OAAO,CAAmF;IAClG,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,aAAa,CAIN;gBAEH,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAY,CAAC,IAAI,CAAM;IAiB1D;;OAEG;IACG,GAAG,CACL,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IA0BrB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAC;KAAE,CAAC;IAIlF;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;IAIvD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI;IAwEhD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAgBjC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,KAAK;IAKL;;OAEG;IACH,MAAM;IAON;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAIlC;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B;;OAEG;YACW,IAAI;YAoBJ,UAAU;YAuBV,WAAW;YAUX,OAAO;IAoBrB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,wBAAwB;CAyBnC"}