worker-que 1.0.0

package/dist/dashboard/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../src/dashboard/views.ts"],"names":[],"mappings":";;AAEA,4CA6wBC;AA7wBD,SAAgB,gBAAgB,CAAC,OAAmC;IAClE,OAAO;;;;;;aAMI,OAAO,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmXZ,OAAO,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAuFQ,OAAO,CAAC,eAAe;;;;;;;;;;;;;;;;;;gDAkBV,OAAO,CAAC,QAAQ;;;;;;;;;;;;;;;;;;gDAkBhB,OAAO,CAAC,QAAQ;;;;;;;;;;;;;;;;gDAgBhB,OAAO,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDA6Bf,OAAO,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAqKhB,OAAO,CAAC,QAAQ;;;;;;;;;;;;;;;;;;iDAkBhB,OAAO,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmD9D,CAAC,IAAI,EAAE,CAAC;AACX,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Client } from './client';
+export { Worker } from './worker';
+export { JobInstance } from './job';
+export * from './types';
+export { calculateRetryDelay, formatJobArgs, parseJobArgs } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"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.parseJobArgs = exports.formatJobArgs = exports.calculateRetryDelay = exports.JobInstance = exports.Worker = exports.Client = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_1.Client; } });
+var worker_1 = require("./worker");
+Object.defineProperty(exports, "Worker", { enumerable: true, get: function () { return worker_1.Worker; } });
+var job_1 = require("./job");
+Object.defineProperty(exports, "JobInstance", { enumerable: true, get: function () { return job_1.JobInstance; } });
+__exportStar(require("./types"), exports);
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "calculateRetryDelay", { enumerable: true, get: function () { return utils_1.calculateRetryDelay; } });
+Object.defineProperty(exports, "formatJobArgs", { enumerable: true, get: function () { return utils_1.formatJobArgs; } });
+Object.defineProperty(exports, "parseJobArgs", { enumerable: true, get: function () { return utils_1.parseJobArgs; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AACpB,0CAAwB;AACxB,iCAA2E;AAAlE,4GAAA,mBAAmB,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,qGAAA,YAAY,OAAA"}

package/dist/job.d.ts

@@ -0,0 +1,19 @@
+import { Pool } from 'pg';
+import { Job, JobRow } from './types';
+export declare class JobInstance implements Job {
+    readonly id: number;
+    readonly queue: string;
+    readonly priority: number;
+    readonly runAt: Date;
+    readonly jobClass: string;
+    readonly args: any[];
+    readonly errorCount: number;
+    readonly lastError?: string;
+    private pool;
+    constructor(row: JobRow, pool: Pool);
+    delete(): Promise<void>;
+    done(): Promise<void>;
+    error(errorMessage: string): Promise<void>;
+    private unlock;
+}
+//# sourceMappingURL=job.d.ts.map

package/dist/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC,qBAAa,WAAY,YAAW,GAAG;IACrC,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,IAAI,CAAC;IAC5B,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,GAAG,EAAE,CAAC;IAC5B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnC,OAAO,CAAC,IAAI,CAAO;gBAEP,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;IAY7B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQlC,MAAM;CAGrB"}

package/dist/job.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobInstance = void 0;
+const sql_1 = require("./sql");
+const utils_1 = require("./utils");
+class JobInstance {
+    constructor(row, pool) {
+        this.id = parseInt(row.job_id, 10);
+        this.queue = row.queue;
+        this.priority = row.priority;
+        this.runAt = row.run_at;
+        this.jobClass = row.job_class;
+        this.args = (0, utils_1.parseJobArgs)(row.args);
+        this.errorCount = row.error_count;
+        this.lastError = row.last_error || undefined;
+        this.pool = pool;
+    }
+    async delete() {
+        await this.pool.query(sql_1.SQL_QUERIES.DELETE_JOB, [this.id]);
+        await this.unlock();
+    }
+    async done() {
+        await this.delete();
+    }
+    async error(errorMessage) {
+        const retryDelay = (0, utils_1.calculateRetryDelay)(this.errorCount + 1);
+        const updateQuery = sql_1.SQL_QUERIES.UPDATE_JOB_ERROR.replace('%d', retryDelay.toString());
+        await this.pool.query(updateQuery, [this.id, errorMessage]);
+        await this.unlock();
+    }
+    async unlock() {
+        await this.pool.query(sql_1.SQL_QUERIES.UNLOCK_JOB, [this.id]);
+    }
+}
+exports.JobInstance = JobInstance;
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":";;;AAEA,+BAAoC;AACpC,mCAA4D;AAE5D,MAAa,WAAW;IAYtB,YAAY,GAAW,EAAE,IAAU;QACjC,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAA,oBAAY,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,WAAW,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAW,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,YAAoB;QAC9B,MAAM,UAAU,GAAG,IAAA,2BAAmB,EAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,iBAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEtF,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAW,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF;AA5CD,kCA4CC"}

package/dist/sql.d.ts

@@ -0,0 +1,8 @@
+export declare const SQL_QUERIES: {
+    readonly ENQUEUE_JOB: "\n    INSERT INTO que_jobs (job_class, args, priority, run_at, queue)\n    VALUES ($1, $2, $3, $4, $5)\n    RETURNING job_id, priority, run_at, job_class, args, error_count, last_error, queue\n  ";
+    readonly LOCK_JOB: "\n    WITH RECURSIVE jobs AS (\n      SELECT (j).*, pg_try_advisory_lock((j).job_id) AS locked\n      FROM (\n        SELECT j\n        FROM que_jobs AS j\n        WHERE queue = $1 AND run_at <= now() AND error_count < 5\n        ORDER BY priority, run_at, job_id\n        LIMIT 1\n      ) AS t1\n      UNION ALL (\n        SELECT (j).*, pg_try_advisory_lock((j).job_id) AS locked\n        FROM (\n          SELECT (\n            SELECT j\n            FROM que_jobs AS j\n            WHERE queue = $1 AND run_at <= now() AND error_count < 5\n            AND (priority, run_at, job_id) > (jobs.priority, jobs.run_at, jobs.job_id)\n            ORDER BY priority, run_at, job_id\n            LIMIT 1\n          ) AS j\n          FROM jobs\n          WHERE jobs.job_id IS NOT NULL\n          LIMIT 1\n        ) AS t1\n      )\n    )\n    SELECT job_id, priority, run_at, job_class, args, error_count, last_error, queue\n    FROM jobs\n    WHERE locked\n    LIMIT 1\n  ";
+    readonly DELETE_JOB: "\n    DELETE FROM que_jobs\n    WHERE job_id = $1\n  ";
+    readonly UPDATE_JOB_ERROR: "\n    UPDATE que_jobs\n    SET error_count = error_count + 1,\n        last_error = $2,\n        run_at = now() + interval '%d seconds'\n    WHERE job_id = $1\n  ";
+    readonly UNLOCK_JOB: "\n    SELECT pg_advisory_unlock($1)\n  ";
+};
+//# sourceMappingURL=sql.d.ts.map

package/dist/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;CAwDd,CAAC"}

package/dist/sql.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQL_QUERIES = void 0;
+exports.SQL_QUERIES = {
+    ENQUEUE_JOB: `
+    INSERT INTO que_jobs (job_class, args, priority, run_at, queue)
+    VALUES ($1, $2, $3, $4, $5)
+    RETURNING job_id, priority, run_at, job_class, args, error_count, last_error, queue
+  `,
+    LOCK_JOB: `
+    WITH RECURSIVE jobs AS (
+      SELECT (j).*, pg_try_advisory_lock((j).job_id) AS locked
+      FROM (
+        SELECT j
+        FROM que_jobs AS j
+        WHERE queue = $1 AND run_at <= now() AND error_count < 5
+        ORDER BY priority, run_at, job_id
+        LIMIT 1
+      ) AS t1
+      UNION ALL (
+        SELECT (j).*, pg_try_advisory_lock((j).job_id) AS locked
+        FROM (
+          SELECT (
+            SELECT j
+            FROM que_jobs AS j
+            WHERE queue = $1 AND run_at <= now() AND error_count < 5
+            AND (priority, run_at, job_id) > (jobs.priority, jobs.run_at, jobs.job_id)
+            ORDER BY priority, run_at, job_id
+            LIMIT 1
+          ) AS j
+          FROM jobs
+          WHERE jobs.job_id IS NOT NULL
+          LIMIT 1
+        ) AS t1
+      )
+    )
+    SELECT job_id, priority, run_at, job_class, args, error_count, last_error, queue
+    FROM jobs
+    WHERE locked
+    LIMIT 1
+  `,
+    DELETE_JOB: `
+    DELETE FROM que_jobs
+    WHERE job_id = $1
+  `,
+    UPDATE_JOB_ERROR: `
+    UPDATE que_jobs
+    SET error_count = error_count + 1,
+        last_error = $2,
+        run_at = now() + interval '%d seconds'
+    WHERE job_id = $1
+  `,
+    UNLOCK_JOB: `
+    SELECT pg_advisory_unlock($1)
+  `
+};
+//# sourceMappingURL=sql.js.map

package/dist/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IACzB,WAAW,EAAE;;;;GAIZ;IAED,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BT;IAED,UAAU,EAAE;;;GAGX;IAED,gBAAgB,EAAE;;;;;;GAMjB;IAED,UAAU,EAAE;;GAEX;CACO,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,90 @@
+import { ConnectionOptions } from "tls";
+export type JSONValue = string | number | boolean | null | JSONObject | JSONArray;
+export interface JSONObject {
+    [key: string]: JSONValue;
+}
+export interface JSONArray extends Array<JSONValue> {
+}
+export interface Job {
+    id: number;
+    queue: string;
+    priority: number;
+    runAt: Date;
+    jobClass: string;
+    args: JSONArray;
+    errorCount: number;
+    lastError?: string;
+    delete(): Promise<void>;
+    done(): Promise<void>;
+    error(errorMessage: string): Promise<void>;
+}
+export interface EnqueueOptions {
+    priority?: number;
+    runAt?: Date;
+    queue?: string;
+}
+export interface WorkFunction {
+    (job: Job): Promise<void>;
+}
+export interface WorkMap {
+    [jobClass: string]: WorkFunction;
+}
+/**
+ * SSL configuration options for PostgreSQL connection
+ */
+export interface SSLConfig extends ConnectionOptions {
+    /**
+     * Reject unauthorized certificates (default: true for security)
+     * Set to false only in development/testing environments
+     */
+    rejectUnauthorized?: boolean;
+    /**
+     * Path to client certificate file (.crt or .pem)
+     */
+    cert?: string | Buffer;
+    /**
+     * Path to client private key file (.key)
+     */
+    key?: string | Buffer;
+    /**
+     * Path to CA certificate file to verify server certificate
+     */
+    ca?: string | Buffer | Array<string | Buffer>;
+    /**
+     * Passphrase for the private key if encrypted
+     */
+    passphrase?: string;
+}
+export interface ClientConfig {
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    database?: string;
+    user?: string;
+    password?: string;
+    /**
+     * SSL configuration:
+     * - false: No SSL
+     * - true: SSL with default settings (rejectUnauthorized: true)
+     * - SSLConfig object: Custom SSL configuration with certificates
+     */
+    ssl?: boolean | SSLConfig;
+    dialectOptions?: object;
+    maxConnections?: number;
+}
+export interface WorkerOptions {
+    queue?: string;
+    interval?: number;
+    maxAttempts?: number;
+}
+export interface JobRow {
+    priority: number;
+    run_at: Date;
+    job_id: string;
+    job_class: string;
+    args: JSONArray;
+    error_count: number;
+    last_error?: string | null;
+    queue: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,KAAK,CAAC;AAGxC,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,SAAS,CAAC;CAAG;AAEtD,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+import { JSONArray } from './types';
+export declare function intPow(base: number, exponent: number): number;
+export declare function calculateRetryDelay(errorCount: number): number;
+export declare function formatJobArgs(args: JSONArray): string;
+export declare function parseJobArgs(args: JSONArray): JSONArray;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,SAAS,CAAC;AAE/C,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW7D;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAErD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAQvD"}

package/dist/utils.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.intPow = intPow;
+exports.calculateRetryDelay = calculateRetryDelay;
+exports.formatJobArgs = formatJobArgs;
+exports.parseJobArgs = parseJobArgs;
+function intPow(base, exponent) {
+    if (exponent < 0) {
+        return 0;
+    }
+    let result = 1;
+    for (let i = 0; i < exponent; i++) {
+        result *= base;
+    }
+    return result;
+}
+function calculateRetryDelay(errorCount) {
+    return intPow(errorCount, 4);
+}
+function formatJobArgs(args) {
+    return JSON.stringify(args);
+}
+function parseJobArgs(args) {
+    // PostgreSQL JSON column is already parsed by the pg driver
+    // Just validate it's an array and return it
+    if (!Array.isArray(args)) {
+        throw new Error(`Expected job arguments to be an array, received: ${typeof args}`);
+    }
+    return args;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAEA,wBAWC;AAED,kDAEC;AAED,sCAEC;AAED,oCAQC;AA7BD,SAAgB,MAAM,CAAC,IAAY,EAAE,QAAgB;IACnD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,mBAAmB,CAAC,UAAkB;IACpD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,SAAgB,aAAa,CAAC,IAAe;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAgB,YAAY,CAAC,IAAe;IAC1C,4DAA4D;IAC5D,4CAA4C;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oDAAoD,OAAO,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/worker.d.ts

@@ -0,0 +1,19 @@
+import { WorkFunction, WorkerOptions, ClientConfig } from './types';
+export declare class Worker {
+    private client;
+    private workMap;
+    private queue;
+    private interval;
+    private running;
+    private shutdownPromise;
+    private timeoutId;
+    private timeoutResolve;
+    constructor(clientConfig?: ClientConfig, options?: WorkerOptions);
+    register(jobClass: string, workFunc: WorkFunction): void;
+    work(): Promise<void>;
+    workOne(): Promise<boolean>;
+    shutdown(): Promise<void>;
+    private workLoop;
+    private processJob;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,YAAY,EAAW,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAElF,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,cAAc,CAA6B;gBAEvC,YAAY,GAAE,YAAiB,EAAE,OAAO,GAAE,aAAkB;IAMxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIlD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAW3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAyBjB,QAAQ;YA8BR,UAAU;CAgBzB"}

package/dist/worker.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Worker = void 0;
+const client_1 = require("./client");
+class Worker {
+    constructor(clientConfig = {}, options = {}) {
+        this.workMap = {};
+        this.running = false;
+        this.shutdownPromise = null;
+        this.timeoutId = null;
+        this.timeoutResolve = null;
+        this.client = new client_1.Client(clientConfig);
+        this.queue = options.queue || '';
+        this.interval = options.interval || 60 * 1000;
+    }
+    register(jobClass, workFunc) {
+        this.workMap[jobClass] = workFunc;
+    }
+    async work() {
+        if (this.running) {
+            throw new Error('Worker is already running');
+        }
+        this.running = true;
+        this.shutdownPromise = this.workLoop();
+        return this.shutdownPromise;
+    }
+    async workOne() {
+        const job = await this.client.lockJob(this.queue);
+        if (!job) {
+            return false;
+        }
+        await this.processJob(job);
+        return true;
+    }
+    async shutdown() {
+        if (!this.running) {
+            return;
+        }
+        this.running = false;
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = null;
+        }
+        // Resolve any pending timeout promises
+        if (this.timeoutResolve) {
+            this.timeoutResolve();
+            this.timeoutResolve = null;
+        }
+        if (this.shutdownPromise) {
+            await this.shutdownPromise;
+        }
+        await this.client.close();
+    }
+    async workLoop() {
+        while (this.running) {
+            try {
+                const processed = await this.workOne();
+                if (!processed && this.running) {
+                    await new Promise((resolve) => {
+                        this.timeoutResolve = resolve;
+                        this.timeoutId = setTimeout(() => {
+                            this.timeoutResolve = null;
+                            resolve();
+                        }, this.interval);
+                    });
+                }
+            }
+            catch (error) {
+                console.error('Worker error:', error);
+                if (this.running) {
+                    await new Promise((resolve) => {
+                        this.timeoutResolve = resolve;
+                        this.timeoutId = setTimeout(() => {
+                            this.timeoutResolve = null;
+                            resolve();
+                        }, this.interval);
+                    });
+                }
+            }
+        }
+    }
+    async processJob(job) {
+        const workFunc = this.workMap[job.jobClass];
+        if (!workFunc) {
+            await job.error(`No work function registered for job class: ${job.jobClass}`);
+            return;
+        }
+        try {
+            await workFunc(job);
+            await job.done();
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            await job.error(errorMessage);
+        }
+    }
+}
+exports.Worker = Worker;
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

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

package/migrations/schema.sql

@@ -0,0 +1,26 @@
+-- Que job queue table compatible with Ruby Que and que-go
+CREATE TABLE que_jobs (
+    priority    smallint    NOT NULL DEFAULT 100,
+    run_at      timestamptz NOT NULL DEFAULT now(),
+    job_id      bigserial   NOT NULL,
+    job_class   text        NOT NULL,
+    args        json        NOT NULL DEFAULT '[]'::json,
+    error_count integer     NOT NULL DEFAULT 0,
+    last_error  text,
+    queue       text        NOT NULL DEFAULT '',
+    
+    -- Composite primary key for efficient job ordering and retrieval
+    PRIMARY KEY (queue, priority, run_at, job_id)
+);
+
+-- Index for efficient job polling
+CREATE INDEX CONCURRENTLY que_poll_idx ON que_jobs (queue, priority, run_at, job_id) WHERE error_count < 5;
+
+-- Function to get current time (useful for compatibility)
+CREATE OR REPLACE FUNCTION que_current_time()
+RETURNS timestamptz
+LANGUAGE SQL
+STABLE
+AS $$
+  SELECT now();
+$$;

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "worker-que",
+  "version": "1.0.0",
+  "description": "A TypeScript job queue library for PostgreSQL with real-time web dashboard, SSL support, and cross-language compatibility",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./dashboard": {
+      "require": "./dist/dashboard/index.js",
+      "import": "./dist/dashboard/index.js",
+      "types": "./dist/dashboard/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "migrations/",
+    "README.md",
+    "LICENSE",
+    "DASHBOARD.md",
+    "DASHBOARD-QUICKSTART.md",
+    "SSL.md",
+    "SSL-QUICK-REFERENCE.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "dev": "tsc --watch",
+    "test": "jest --testTimeout=5000",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:debug": "jest --detectOpenHandles --testTimeout=5000",
+    "test:docker": "npm run docker:up && npm run test && npm run docker:down",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "prepublishOnly": "npm run lint && npm run build",
+    "clean": "rm -rf dist",
+    "docker:up": "docker-compose up -d",
+    "docker:down": "docker-compose down",
+    "docker:logs": "docker-compose logs -f postgres",
+    "docker:clean": "docker-compose down -v --remove-orphans",
+    "docker:reset": "npm run docker:clean && npm run docker:up"
+  },
+  "keywords": [
+    "job-queue",
+    "worker-queue",
+    "postgresql",
+    "postgres",
+    "typescript",
+    "background-jobs",
+    "job-processing",
+    "task-queue",
+    "async-jobs",
+    "que",
+    "worker",
+    "dashboard",
+    "queue-monitoring",
+    "express",
+    "ssl",
+    "tls",
+    "advisory-locks"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.5",
+    "@types/node": "^20.6.2",
+    "@types/pg": "^8.10.2",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "dotenv": "^17.2.1",
+    "eslint": "^8.57.1",
+    "express": "^4.18.2",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1"
+  },
+  "dependencies": {
+    "pg": "^8.11.3",
+    "typescript": "^5.2.2"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Zongo-Technologies/expert-garbanzo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Zongo-Technologies/expert-garbanzo/issues"
+  },
+  "homepage": "https://github.com/Zongo-Technologies/expert-garbanzo#readme"
+}