@nest-native/jobs 0.1.0

package/dist/dialects/postgres/index.js

@@ -0,0 +1,21 @@
+"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 });
+// @nest-native/jobs/postgres — the node-postgres (async) dialect:
+// the `jobs` table definition + the Postgres store.
+__exportStar(require("./schema"), exports);
+__exportStar(require("./job-store"), exports);
+//# sourceMappingURL=index.js.map

package/dist/dialects/postgres/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../dialects/postgres/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAkE;AAClE,oDAAoD;AACpD,2CAAyB;AACzB,8CAA4B"}

package/dist/dialects/postgres/job-store.d.ts

@@ -0,0 +1,32 @@
+import type { EnqueueJobInput, JobRow, JobStore, ResolvedRunnerConfig } from '../../interfaces';
+/**
+ * Postgres surfaces a unique-constraint violation with SQLSTATE `23505`
+ * (`unique_violation`). node-postgres exposes it as `error.code === '23505'`;
+ * Drizzle wraps driver errors in a `DrizzleQueryError`, so the code may instead
+ * sit on `error.cause`. Check both so the predicate is robust to wrapping.
+ */
+export declare function isPgUniqueViolation(error: unknown): boolean;
+/**
+ * Postgres (node-postgres) job store. Every method is **asynchronous** —
+ * `enqueue` awaits the insert (call it with `await` inside an async
+ * `@Transactional` body), and the claimer's batch claim runs in an async
+ * 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.
+ */
+export declare class PostgresJobStore implements JobStore {
+    enqueue(db: unknown, input: EnqueueJobInput<object>): Promise<JobRow>;
+    /**
+     * 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), resolves undefined so the caller
+     * rethrows the original error.
+     */
+    private findActiveDuplicate;
+    claimBatch(db: unknown, cfg: ResolvedRunnerConfig): Promise<JobRow[]>;
+    markCompleted(db: unknown, id: string): Promise<void>;
+    retry(db: unknown, id: string, delayMs: number, lastError?: string): Promise<void>;
+    markFailed(db: unknown, id: string, reason: string): Promise<void>;
+}

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

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresJobStore = void 0;
+exports.isPgUniqueViolation = isPgUniqueViolation;
+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");
+/**
+ * Postgres surfaces a unique-constraint violation with SQLSTATE `23505`
+ * (`unique_violation`). node-postgres exposes it as `error.code === '23505'`;
+ * Drizzle wraps driver errors in a `DrizzleQueryError`, so the code may instead
+ * sit on `error.cause`. Check both so the predicate is robust to wrapping.
+ */
+function isPgUniqueViolation(error) {
+    return hasCode(error, '23505') || hasCode(error?.cause, '23505');
+}
+function hasCode(error, code) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === code);
+}
+/**
+ * Postgres (node-postgres) job store. Every method is **asynchronous** —
+ * `enqueue` awaits the insert (call it with `await` inside an async
+ * `@Transactional` body), and the claimer's batch claim runs in an async
+ * 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 PostgresJobStore {
+    async enqueue(db, input) {
+        const availableAt = (0, enqueue_input_1.resolveAvailableAt)(input).toISOString();
+        try {
+            const [row] = await 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();
+            return row;
+        }
+        catch (error) {
+            const existing = await 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), resolves undefined so the caller
+     * rethrows the original error.
+     */
+    async findActiveDuplicate(db, input, error) {
+        if (!isPgUniqueViolation(error) || input.uniqueKey == null) {
+            return undefined;
+        }
+        const [existing] = await 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)));
+        return existing;
+    }
+    async claimBatch(db, cfg) {
+        const now = new Date();
+        const nowIso = now.toISOString();
+        const stuckCutoff = new Date(now.getTime() - cfg.stuckTimeoutMs).toISOString();
+        return db.transaction(async (tx) => {
+            const candidates = await 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);
+            if (candidates.length === 0)
+                return [];
+            const ids = candidates.map((c) => c.id);
+            await tx
+                .update(schema_1.jobs)
+                .set({ status: 'processing', claimedAt: nowIso, claimedBy: cfg.workerInstanceId })
+                .where((0, drizzle_orm_1.inArray)(schema_1.jobs.id, ids));
+            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));
+        });
+    }
+    async markCompleted(db, id) {
+        await 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));
+    }
+    async retry(db, id, delayMs, lastError) {
+        const nextAvailable = new Date(Date.now() + delayMs).toISOString();
+        await 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));
+    }
+    async markFailed(db, id, reason) {
+        await 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));
+    }
+}
+exports.PostgresJobStore = PostgresJobStore;
+//# sourceMappingURL=job-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-store.js","sourceRoot":"","sources":["../../../dialects/postgres/job-store.ts"],"names":[],"mappings":";;;AAoBA,kDAEC;AAtBD,6CAAyC;AACzC,6CAAwE;AAExE,uDAAyD;AAOzD,qCAAgC;AAIhC;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,OAAO,CAAE,KAA6B,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,IAAY;IAC3C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA4B,CAAC,IAAI,KAAK,IAAI,CAC5C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAa,gBAAgB;IAC3B,KAAK,CAAC,OAAO,CAAC,EAAW,EAAE,KAA8B;QACvD,MAAM,WAAW,GAAG,IAAA,kCAAkB,EAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,GAAG,MAAO,EAAS;iBAC3B,MAAM,CAAC,aAAI,CAAC;iBACZ,MAAM,CAAC;gBACN,EAAE,EAAE,IAAA,wBAAU,GAAE;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,yEAAyE;gBACzE,OAAO,EAAE,KAAK,CAAC,OAAkC;gBACjD,MAAM,EAAE,SAAS;gBACjB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;gBAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC;gBAC7B,WAAW;gBACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;iBACD,SAAS,EAAE,CAAC;YACf,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAClE,IAAI,CAAC,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,mBAAmB,CAC/B,EAAW,EACX,KAA8B,EAC9B,KAAc;QAEd,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;YAC3D,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAO,EAAS;aAChC,MAAM,EAAE;aACR,IAAI,CAAC,aAAI,CAAC;aACV,KAAK,CAAC,IAAA,iBAAG,EAAC,IAAA,gBAAE,EAAC,aAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAA,gBAAE,EAAC,aAAI,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAW,EAAE,GAAyB;QACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/E,OAAQ,EAAS,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YACzC,MAAM,UAAU,GAAG,MAAM,EAAE;iBACxB,MAAM,CAAC,EAAE,EAAE,EAAE,aAAI,CAAC,EAAE,EAAE,CAAC;iBACvB,IAAI,CAAC,aAAI,CAAC;iBACV,KAAK,CACJ,IAAA,gBAAE,EACA,IAAA,iBAAG,EAAC,IAAA,gBAAE,EAAC,aAAI,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,IAAA,iBAAG,EAAC,aAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,EAC9D,IAAA,iBAAG,EAAC,IAAA,gBAAE,EAAC,aAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,IAAA,iBAAG,EAAC,aAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CACrE,CACF;iBACA,OAAO,CAAC,IAAA,kBAAI,EAAC,aAAI,CAAC,QAAQ,CAAC,EAAE,IAAA,iBAAG,EAAC,aAAI,CAAC,WAAW,CAAC,CAAC;iBACnD,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxC,MAAM,EAAE;iBACL,MAAM,CAAC,aAAI,CAAC;iBACZ,GAAG,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,gBAAgB,EAAE,CAAC;iBACjF,KAAK,CAAC,IAAA,qBAAO,EAAC,aAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;YAChC,OAAO,EAAE;iBACN,MAAM,EAAE;iBACR,IAAI,CAAC,aAAI,CAAC;iBACV,KAAK,CAAC,IAAA,qBAAO,EAAC,aAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;iBAC5B,OAAO,CAAC,IAAA,kBAAI,EAAC,aAAI,CAAC,QAAQ,CAAC,EAAE,IAAA,iBAAG,EAAC,aAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAW,EAAE,EAAU;QACzC,MAAO,EAAS;aACb,MAAM,CAAC,aAAI,CAAC;aACZ,GAAG,CAAC;YACH,MAAM,EAAE,WAAW;YACnB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,SAAS,EAAE,IAAI;YACf,2CAA2C;YAC3C,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,KAAK,CAAC,IAAA,gBAAE,EAAC,aAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,KAAK,CACT,EAAW,EACX,EAAU,EACV,OAAe,EACf,SAAkB;QAElB,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACnE,MAAO,EAAS;aACb,MAAM,CAAC,aAAI,CAAC;aACZ,GAAG,CAAC;YACH,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,IAAA,iBAAG,EAAA,GAAG,aAAI,CAAC,QAAQ,MAAM;YACnC,WAAW,EAAE,aAAa;YAC1B,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,SAAS,IAAI,IAAI;YAC5B,8CAA8C;SAC/C,CAAC;aACD,KAAK,CAAC,IAAA,gBAAE,EAAC,aAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAW,EAAE,EAAU,EAAE,MAAc;QACtD,MAAO,EAAS;aACb,MAAM,CAAC,aAAI,CAAC;aACZ,GAAG,CAAC;YACH,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,IAAA,iBAAG,EAAA,GAAG,aAAI,CAAC,QAAQ,MAAM;YACnC,SAAS,EAAE,MAAM;YACjB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,2CAA2C;YAC3C,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,KAAK,CAAC,IAAA,gBAAE,EAAC,aAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;CACF;AA9HD,4CA8HC"}

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

@@ -0,0 +1,262 @@
+/**
+ * Postgres `jobs` table. Add it to your Drizzle schema and generate a
+ * migration with drizzle-kit. Timestamps are stored as ISO-8601 `text` so the
+ * row shape is identical across dialects (ISO-8601 compares lexicographically,
+ * which the claimer's `available_at` range query relies on).
+ *
+ * The **full** unique index on `(name, unique_key)` is the active-dedup
+ * primitive: Postgres treats `NULL`s as distinct in unique indexes (the
+ * default `NULLS DISTINCT`), so jobs without a `uniqueKey` never collide,
+ * and — because terminal transitions clear `unique_key` to `NULL` —
+ * uniqueness only constrains ACTIVE jobs. No partial index needed, so the
+ * same shape works on every dialect.
+ */
+export declare const jobs: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "jobs";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: import("drizzle-orm/pg-core").PgColumn<{
+            name: "name";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: "jobs";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Record<string, unknown>;
+            driverParam: unknown;
+            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/pg-core").PgColumn<{
+            name: "status";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            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;
+        }, {}, {
+            $type: "pending" | "processing" | "completed" | "failed";
+        }>;
+        attempts: import("drizzle-orm/pg-core").PgColumn<{
+            name: "attempts";
+            tableName: "jobs";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        maxAttempts: import("drizzle-orm/pg-core").PgColumn<{
+            name: "max_attempts";
+            tableName: "jobs";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        uniqueKey: import("drizzle-orm/pg-core").PgColumn<{
+            name: "unique_key";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        priority: import("drizzle-orm/pg-core").PgColumn<{
+            name: "priority";
+            tableName: "jobs";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        availableAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "available_at";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        claimedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "claimed_at";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        claimedBy: import("drizzle-orm/pg-core").PgColumn<{
+            name: "claimed_by";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        processedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "processed_at";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastError: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_error";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "jobs";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/dialects/postgres/schema.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jobs = void 0;
+const pg_core_1 = require("drizzle-orm/pg-core");
+/**
+ * Postgres `jobs` table. Add it to your Drizzle schema and generate a
+ * migration with drizzle-kit. Timestamps are stored as ISO-8601 `text` so the
+ * row shape is identical across dialects (ISO-8601 compares lexicographically,
+ * which the claimer's `available_at` range query relies on).
+ *
+ * The **full** unique index on `(name, unique_key)` is the active-dedup
+ * primitive: Postgres treats `NULL`s as distinct in unique indexes (the
+ * default `NULLS DISTINCT`), so jobs without a `uniqueKey` never collide,
+ * and — because terminal transitions clear `unique_key` to `NULL` —
+ * uniqueness only constrains ACTIVE jobs. No partial index needed, so the
+ * same shape works on every dialect.
+ */
+exports.jobs = (0, pg_core_1.pgTable)('jobs', {
+    id: (0, pg_core_1.text)('id').primaryKey(),
+    name: (0, pg_core_1.text)('name').notNull(),
+    payload: (0, pg_core_1.jsonb)('payload').$type().notNull(),
+    status: (0, pg_core_1.text)('status').$type().notNull(),
+    attempts: (0, pg_core_1.integer)('attempts').notNull().default(0),
+    maxAttempts: (0, pg_core_1.integer)('max_attempts').notNull().default(10),
+    uniqueKey: (0, pg_core_1.text)('unique_key'),
+    priority: (0, pg_core_1.integer)('priority').notNull().default(0),
+    availableAt: (0, pg_core_1.text)('available_at').notNull(),
+    claimedAt: (0, pg_core_1.text)('claimed_at'),
+    claimedBy: (0, pg_core_1.text)('claimed_by'),
+    processedAt: (0, pg_core_1.text)('processed_at'),
+    lastError: (0, pg_core_1.text)('last_error'),
+    createdAt: (0, pg_core_1.text)('created_at').notNull(),
+}, (table) => [
+    (0, pg_core_1.uniqueIndex)('jobs_name_unique_key_unique').on(table.name, table.uniqueKey),
+    (0, pg_core_1.index)('jobs_status_available_idx').on(table.status, table.availableAt),
+]);
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../dialects/postgres/schema.ts"],"names":[],"mappings":";;;AAAA,iDAO6B;AAG7B;;;;;;;;;;;;GAYG;AACU,QAAA,IAAI,GAAG,IAAA,iBAAO,EACzB,MAAM,EACN;IACE,EAAE,EAAE,IAAA,cAAI,EAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAA,cAAI,EAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,OAAO,EAAE,IAAA,eAAK,EAAC,SAAS,CAAC,CAAC,KAAK,EAA2B,CAAC,OAAO,EAAE;IACpE,MAAM,EAAE,IAAA,cAAI,EAAC,QAAQ,CAAC,CAAC,KAAK,EAAa,CAAC,OAAO,EAAE;IACnD,QAAQ,EAAE,IAAA,iBAAO,EAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,WAAW,EAAE,IAAA,iBAAO,EAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1D,SAAS,EAAE,IAAA,cAAI,EAAC,YAAY,CAAC;IAC7B,QAAQ,EAAE,IAAA,iBAAO,EAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,WAAW,EAAE,IAAA,cAAI,EAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC3C,SAAS,EAAE,IAAA,cAAI,EAAC,YAAY,CAAC;IAC7B,SAAS,EAAE,IAAA,cAAI,EAAC,YAAY,CAAC;IAC7B,WAAW,EAAE,IAAA,cAAI,EAAC,cAAc,CAAC;IACjC,SAAS,EAAE,IAAA,cAAI,EAAC,YAAY,CAAC;IAC7B,SAAS,EAAE,IAAA,cAAI,EAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CACxC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,IAAA,qBAAW,EAAC,6BAA6B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1E,IAAA,eAAK,EAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC;CACvE,CACF,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from './schema';
+export * from './job-store';

package/dist/dialects/sqlite/index.js

@@ -0,0 +1,21 @@
+"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 });
+// @nest-native/jobs/sqlite — the better-sqlite3 (synchronous) dialect:
+// the `jobs` table definition + the SQLite store.
+__exportStar(require("./schema"), exports);
+__exportStar(require("./job-store"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../dialects/sqlite/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uEAAuE;AACvE,kDAAkD;AAClD,2CAAyB;AACzB,8CAA4B"}

package/dist/dialects/sqlite/job-store.d.ts

@@ -0,0 +1,32 @@
+import type { EnqueueJobInput, JobRow, JobStore, ResolvedRunnerConfig } from '../../interfaces';
+/**
+ * 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.
+ */
+export declare function isSqliteUniqueViolation(error: unknown): boolean;
+/**
+ * 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.
+ */
+export declare class SqliteJobStore implements JobStore {
+    enqueue(db: unknown, input: EnqueueJobInput<object>): JobRow;
+    /**
+     * 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.
+     */
+    private findActiveDuplicate;
+    claimBatch(db: unknown, cfg: ResolvedRunnerConfig): Promise<JobRow[]>;
+    markCompleted(db: unknown, id: string): Promise<void>;
+    retry(db: unknown, id: string, delayMs: number, lastError?: string): Promise<void>;
+    markFailed(db: unknown, id: string, reason: string): Promise<void>;
+}