@nest-native/jobs 0.1.0

package/dist/dialects/sqlite/job-store.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteJobStore = void 0;
+exports.isSqliteUniqueViolation = isSqliteUniqueViolation;
+const node_crypto_1 = require("node:crypto");
+const drizzle_orm_1 = require("drizzle-orm");
+const enqueue_input_1 = require("../../enqueue-input");
+const schema_1 = require("./schema");
+/**
+ * better-sqlite3 surfaces a unique-constraint violation as a `SqliteError` with
+ * `code === 'SQLITE_CONSTRAINT_UNIQUE'`. Match on the code (stable across driver
+ * versions), not the message. Drizzle may wrap driver errors in a
+ * `DrizzleQueryError`, so the code may instead sit on `error.cause` — check both.
+ */
+function isSqliteUniqueViolation(error) {
+    const code = 'SQLITE_CONSTRAINT_UNIQUE';
+    return hasCode(error, code) || hasCode(error?.cause, code);
+}
+function hasCode(error, code) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === code);
+}
+/**
+ * SQLite (better-sqlite3) job store. Every method runs **synchronously** —
+ * `enqueue` returns the row directly so it composes inside a synchronous
+ * `@Transactional` body, and the rest wrap their synchronous result in a
+ * resolved Promise for the engine to await from outside the transaction.
+ *
+ * A `(name, unique_key)` unique violation on `enqueue` is the active-dedup
+ * no-op: the store returns the EXISTING active row instead of inserting.
+ */
+class SqliteJobStore {
+    enqueue(db, input) {
+        const availableAt = (0, enqueue_input_1.resolveAvailableAt)(input).toISOString();
+        try {
+            return db
+                .insert(schema_1.jobs)
+                .values({
+                id: (0, node_crypto_1.randomUUID)(),
+                name: input.name,
+                // The one place the structural input payload widens to the stored shape.
+                payload: input.payload,
+                status: 'pending',
+                maxAttempts: input.maxAttempts ?? 10,
+                uniqueKey: input.uniqueKey ?? null,
+                priority: input.priority ?? 0,
+                availableAt,
+                createdAt: new Date().toISOString(),
+            })
+                .returning()
+                .get();
+        }
+        catch (error) {
+            const existing = this.findActiveDuplicate(db, input, error);
+            if (!existing)
+                throw error;
+            return existing;
+        }
+    }
+    /**
+     * On a unique violation with a `uniqueKey`, the ACTIVE row that owns the
+     * `(name, uniqueKey)` pair — terminal rows cannot own it (their key is
+     * cleared to NULL). Any other error, or a vanished row (the owner completed
+     * between the insert and this read), returns undefined so the caller
+     * rethrows the original error.
+     */
+    findActiveDuplicate(db, input, error) {
+        if (!isSqliteUniqueViolation(error) || input.uniqueKey == null) {
+            return undefined;
+        }
+        return db
+            .select()
+            .from(schema_1.jobs)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.jobs.name, input.name), (0, drizzle_orm_1.eq)(schema_1.jobs.uniqueKey, input.uniqueKey)))
+            .get();
+    }
+    claimBatch(db, cfg) {
+        const now = new Date();
+        const nowIso = now.toISOString();
+        const stuckCutoff = new Date(now.getTime() - cfg.stuckTimeoutMs).toISOString();
+        const rows = db.transaction((tx) => {
+            const candidates = tx
+                .select({ id: schema_1.jobs.id })
+                .from(schema_1.jobs)
+                .where((0, drizzle_orm_1.or)((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.jobs.status, 'pending'), (0, drizzle_orm_1.lte)(schema_1.jobs.availableAt, nowIso)), (0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.jobs.status, 'processing'), (0, drizzle_orm_1.lte)(schema_1.jobs.claimedAt, stuckCutoff))))
+                .orderBy((0, drizzle_orm_1.desc)(schema_1.jobs.priority), (0, drizzle_orm_1.asc)(schema_1.jobs.availableAt))
+                .limit(cfg.batchSize)
+                .all();
+            if (candidates.length === 0)
+                return [];
+            const ids = candidates.map((c) => c.id);
+            tx.update(schema_1.jobs)
+                .set({ status: 'processing', claimedAt: nowIso, claimedBy: cfg.workerInstanceId })
+                .where((0, drizzle_orm_1.inArray)(schema_1.jobs.id, ids))
+                .run();
+            return tx
+                .select()
+                .from(schema_1.jobs)
+                .where((0, drizzle_orm_1.inArray)(schema_1.jobs.id, ids))
+                .orderBy((0, drizzle_orm_1.desc)(schema_1.jobs.priority), (0, drizzle_orm_1.asc)(schema_1.jobs.availableAt))
+                .all();
+        });
+        return Promise.resolve(rows);
+    }
+    markCompleted(db, id) {
+        db
+            .update(schema_1.jobs)
+            .set({
+            status: 'completed',
+            processedAt: new Date().toISOString(),
+            lastError: null,
+            // Terminal → release the active-dedup key.
+            uniqueKey: null,
+        })
+            .where((0, drizzle_orm_1.eq)(schema_1.jobs.id, id))
+            .run();
+        return Promise.resolve();
+    }
+    retry(db, id, delayMs, lastError) {
+        const nextAvailable = new Date(Date.now() + delayMs).toISOString();
+        db
+            .update(schema_1.jobs)
+            .set({
+            status: 'pending',
+            attempts: (0, drizzle_orm_1.sql) `${schema_1.jobs.attempts} + 1`,
+            availableAt: nextAvailable,
+            claimedAt: null,
+            claimedBy: null,
+            lastError: lastError ?? null,
+            // Still active → the uniqueKey stays claimed.
+        })
+            .where((0, drizzle_orm_1.eq)(schema_1.jobs.id, id))
+            .run();
+        return Promise.resolve();
+    }
+    markFailed(db, id, reason) {
+        db
+            .update(schema_1.jobs)
+            .set({
+            status: 'failed',
+            attempts: (0, drizzle_orm_1.sql) `${schema_1.jobs.attempts} + 1`,
+            lastError: reason,
+            processedAt: new Date().toISOString(),
+            // Terminal → release the active-dedup key.
+            uniqueKey: null,
+        })
+            .where((0, drizzle_orm_1.eq)(schema_1.jobs.id, id))
+            .run();
+        return Promise.resolve();
+    }
+}
+exports.SqliteJobStore = SqliteJobStore;
+//# sourceMappingURL=job-store.js.map

package/dist/dialects/sqlite/job-store.js.map

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

package/dist/dialects/sqlite/schema.d.ts

@@ -0,0 +1,279 @@
+/**
+ * SQLite `jobs` table. Add it to your Drizzle schema and generate a migration
+ * with drizzle-kit.
+ *
+ * The **full** unique index on `(name, unique_key)` is the active-dedup
+ * primitive: SQL treats `NULL` as distinct in unique indexes, so jobs without
+ * a `uniqueKey` never collide, and — because terminal transitions clear
+ * `unique_key` to `NULL` — uniqueness only constrains ACTIVE jobs. The same
+ * full-index shape works on every dialect (no partial indexes needed). The
+ * `(status, available_at)` index serves the claimer's batch query.
+ */
+export declare const jobs: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "jobs";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "name";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        payload: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "payload";
+            tableName: "jobs";
+            dataType: "json";
+            columnType: "SQLiteTextJson";
+            data: Record<string, unknown>;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Record<string, unknown>;
+        }>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "pending" | "processing" | "completed" | "failed";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+            $type: "pending" | "processing" | "completed" | "failed";
+        }>;
+        attempts: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "attempts";
+            tableName: "jobs";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        maxAttempts: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "max_attempts";
+            tableName: "jobs";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        uniqueKey: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "unique_key";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        priority: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "priority";
+            tableName: "jobs";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        availableAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "available_at";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        claimedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "claimed_at";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        claimedBy: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "claimed_by";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        processedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "processed_at";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        lastError: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "last_error";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;

package/dist/dialects/sqlite/schema.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jobs = void 0;
+const sqlite_core_1 = require("drizzle-orm/sqlite-core");
+/**
+ * SQLite `jobs` table. Add it to your Drizzle schema and generate a migration
+ * with drizzle-kit.
+ *
+ * The **full** unique index on `(name, unique_key)` is the active-dedup
+ * primitive: SQL treats `NULL` as distinct in unique indexes, so jobs without
+ * a `uniqueKey` never collide, and — because terminal transitions clear
+ * `unique_key` to `NULL` — uniqueness only constrains ACTIVE jobs. The same
+ * full-index shape works on every dialect (no partial indexes needed). The
+ * `(status, available_at)` index serves the claimer's batch query.
+ */
+exports.jobs = (0, sqlite_core_1.sqliteTable)('jobs', {
+    id: (0, sqlite_core_1.text)('id').primaryKey(),
+    name: (0, sqlite_core_1.text)('name').notNull(),
+    payload: (0, sqlite_core_1.text)('payload', { mode: 'json' })
+        .$type()
+        .notNull(),
+    status: (0, sqlite_core_1.text)('status').$type().notNull(),
+    attempts: (0, sqlite_core_1.integer)('attempts').notNull().default(0),
+    maxAttempts: (0, sqlite_core_1.integer)('max_attempts').notNull().default(10),
+    uniqueKey: (0, sqlite_core_1.text)('unique_key'),
+    priority: (0, sqlite_core_1.integer)('priority').notNull().default(0),
+    availableAt: (0, sqlite_core_1.text)('available_at').notNull(),
+    claimedAt: (0, sqlite_core_1.text)('claimed_at'),
+    claimedBy: (0, sqlite_core_1.text)('claimed_by'),
+    processedAt: (0, sqlite_core_1.text)('processed_at'),
+    lastError: (0, sqlite_core_1.text)('last_error'),
+    createdAt: (0, sqlite_core_1.text)('created_at').notNull(),
+}, (table) => [
+    (0, sqlite_core_1.uniqueIndex)('jobs_name_unique_key_unique').on(table.name, table.uniqueKey),
+    (0, sqlite_core_1.index)('jobs_status_available_idx').on(table.status, table.availableAt),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/dialects/sqlite/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../dialects/sqlite/schema.ts"],"names":[],"mappings":";;;AAAA,yDAMiC;AAGjC;;;;;;;;;;GAUG;AACU,QAAA,IAAI,GAAG,IAAA,yBAAW,EAC7B,MAAM,EACN;IACE,EAAE,EAAE,IAAA,kBAAI,EAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAA,kBAAI,EAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,OAAO,EAAE,IAAA,kBAAI,EAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACvC,KAAK,EAA2B;SAChC,OAAO,EAAE;IACZ,MAAM,EAAE,IAAA,kBAAI,EAAC,QAAQ,CAAC,CAAC,KAAK,EAAa,CAAC,OAAO,EAAE;IACnD,QAAQ,EAAE,IAAA,qBAAO,EAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,WAAW,EAAE,IAAA,qBAAO,EAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1D,SAAS,EAAE,IAAA,kBAAI,EAAC,YAAY,CAAC;IAC7B,QAAQ,EAAE,IAAA,qBAAO,EAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,WAAW,EAAE,IAAA,kBAAI,EAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC3C,SAAS,EAAE,IAAA,kBAAI,EAAC,YAAY,CAAC;IAC7B,SAAS,EAAE,IAAA,kBAAI,EAAC,YAAY,CAAC;IAC7B,WAAW,EAAE,IAAA,kBAAI,EAAC,cAAc,CAAC;IACjC,SAAS,EAAE,IAAA,kBAAI,EAAC,YAAY,CAAC;IAC7B,SAAS,EAAE,IAAA,kBAAI,EAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CACxC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,IAAA,yBAAW,EAAC,6BAA6B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1E,IAAA,mBAAK,EAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC;CACvE,CACF,CAAC"}

package/dist/enqueue-input.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves when an enqueued job becomes due.
+ *
+ * - `runAt` and `delayMs` are **mutually exclusive** — both set throws, so a
+ *   silent precedence rule can never mask a caller bug.
+ * - `runAt` wins as the absolute time; `delayMs` counts from now; neither
+ *   means "due immediately".
+ */
+export declare function resolveAvailableAt(input: {
+    runAt?: Date;
+    delayMs?: number;
+}): Date;

package/dist/enqueue-input.js

@@ -0,0 +1,26 @@
+"use strict";
+// Shared enqueue-input resolution, used by every dialect store so the
+// runAt/delayMs contract is identical no matter which store executes it.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAvailableAt = resolveAvailableAt;
+/**
+ * Resolves when an enqueued job becomes due.
+ *
+ * - `runAt` and `delayMs` are **mutually exclusive** — both set throws, so a
+ *   silent precedence rule can never mask a caller bug.
+ * - `runAt` wins as the absolute time; `delayMs` counts from now; neither
+ *   means "due immediately".
+ */
+function resolveAvailableAt(input) {
+    if (input.runAt !== undefined && input.delayMs !== undefined) {
+        throw new Error('EnqueueJobInput: runAt and delayMs are mutually exclusive — set at most one.');
+    }
+    if (input.runAt !== undefined) {
+        return input.runAt;
+    }
+    if (input.delayMs !== undefined) {
+        return new Date(Date.now() + input.delayMs);
+    }
+    return new Date();
+}
+//# sourceMappingURL=enqueue-input.js.map

package/dist/enqueue-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enqueue-input.js","sourceRoot":"","sources":["../enqueue-input.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,yEAAyE;;AAUzE,gDAaC;AArBD;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,KAAyC;IAC1E,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Signals a transient failure: the job could not complete now but a later
+ * attempt may succeed. `delayMs`, when set, overrides the claimer's jittered
+ * exponential backoff for the next attempt (e.g. a handler-supplied
+ * retry-after).
+ */
+export declare class RetryableError extends Error {
+    readonly delayMs?: number | undefined;
+    constructor(message: string, delayMs?: number | undefined);
+}
+/**
+ * Signals a non-recoverable failure: retrying can never succeed (e.g. no
+ * handler registered for the job name, or a malformed payload). The claimer
+ * marks the job failed immediately rather than burning retry attempts.
+ */
+export declare class PermanentError extends Error {
+    constructor(message: string);
+}

package/dist/errors.js

@@ -0,0 +1,33 @@
+"use strict";
+// The retry vocabulary handlers use to steer the claimer. It is deliberately
+// dependency-free (no Nest, no Drizzle) so handlers, stores, and tests can all
+// throw these without importing anything heavier than this module.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermanentError = exports.RetryableError = void 0;
+/**
+ * Signals a transient failure: the job could not complete now but a later
+ * attempt may succeed. `delayMs`, when set, overrides the claimer's jittered
+ * exponential backoff for the next attempt (e.g. a handler-supplied
+ * retry-after).
+ */
+class RetryableError extends Error {
+    constructor(message, delayMs) {
+        super(message);
+        this.delayMs = delayMs;
+        this.name = 'RetryableError';
+    }
+}
+exports.RetryableError = RetryableError;
+/**
+ * Signals a non-recoverable failure: retrying can never succeed (e.g. no
+ * handler registered for the job name, or a malformed payload). The claimer
+ * marks the job failed immediately rather than burning retry attempts.
+ */
+class PermanentError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PermanentError';
+    }
+}
+exports.PermanentError = PermanentError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../errors.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,mEAAmE;;;AAEnE;;;;;GAKG;AACH,MAAa,cAAe,SAAQ,KAAK;IACvC,YACE,OAAe,EACN,OAAgB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,YAAO,GAAP,OAAO,CAAS;QAGzB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AARD,wCAQC;AAED;;;;GAIG;AACH,MAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './errors';
+export * from './interfaces';
+export * from './tokens';
+export * from './enqueue-input';
+export * from './job-handler.decorator';
+export * from './jobs-handler.explorer';
+export * from './jobs.service';
+export * from './jobs-claimer.service';
+export * from './jobs-worker';
+export * from './jobs.module';

package/dist/index.js

@@ -0,0 +1,30 @@
+"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 });
+// Public entrypoint for @nest-native/jobs (core engine).
+// Dialect-specific stores + table definitions ship from their own modules
+// (./sqlite, ./postgres, ./mysql); this barrel is the dialect-agnostic engine.
+__exportStar(require("./errors"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./tokens"), exports);
+__exportStar(require("./enqueue-input"), exports);
+__exportStar(require("./job-handler.decorator"), exports);
+__exportStar(require("./jobs-handler.explorer"), exports);
+__exportStar(require("./jobs.service"), exports);
+__exportStar(require("./jobs-claimer.service"), exports);
+__exportStar(require("./jobs-worker"), exports);
+__exportStar(require("./jobs.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAyD;AACzD,0EAA0E;AAC1E,+EAA+E;AAC/E,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,kDAAgC;AAChC,0DAAwC;AACxC,0DAAwC;AACxC,iDAA+B;AAC/B,yDAAuC;AACvC,gDAA8B;AAC9B,gDAA8B"}