@nest-native/jobs 0.1.0 → 0.2.0

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

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

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

@@ -0,0 +1,22 @@
+import type { ResolvedScheduleUpsert, ScheduleClaim, ScheduleClaimResult, ScheduleRow, ScheduleStore } from '../../interfaces';
+/**
+ * Postgres (node-postgres) schedule store. Every method is **asynchronous**,
+ * mirroring {@link PostgresJobStore}.
+ *
+ * `claimAndEnqueue` runs the compare-and-swap on `next_run_at` and the
+ * occurrence insert in ONE transaction. The insert uses
+ * `ON CONFLICT DO NOTHING` on `(name, unique_key)` — crucial on Postgres,
+ * where a raised unique violation would poison the whole transaction; the
+ * conflict-tolerant insert lets the schedule row advance even when the
+ * overlap guard suppresses the occurrence.
+ */
+export declare class PostgresScheduleStore implements ScheduleStore {
+    upsert(db: unknown, input: ResolvedScheduleUpsert): Promise<ScheduleRow>;
+    get(db: unknown, name: string): Promise<ScheduleRow | undefined>;
+    list(db: unknown): Promise<ScheduleRow[]>;
+    remove(db: unknown, name: string): Promise<boolean>;
+    setEnabled(db: unknown, name: string, enabled: boolean, nextRunAt: string | null, expectedUpdatedAt?: string): Promise<ScheduleRow | undefined>;
+    listDue(db: unknown, nowIso: string, limit: number): Promise<ScheduleRow[]>;
+    claimAndEnqueue(db: unknown, claim: ScheduleClaim): Promise<ScheduleClaimResult>;
+    disable(db: unknown, id: string, lastError: string): Promise<void>;
+}

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

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresScheduleStore = void 0;
+const node_crypto_1 = require("node:crypto");
+const drizzle_orm_1 = require("drizzle-orm");
+const schema_1 = require("./schema");
+/**
+ * Postgres (node-postgres) schedule store. Every method is **asynchronous**,
+ * mirroring {@link PostgresJobStore}.
+ *
+ * `claimAndEnqueue` runs the compare-and-swap on `next_run_at` and the
+ * occurrence insert in ONE transaction. The insert uses
+ * `ON CONFLICT DO NOTHING` on `(name, unique_key)` — crucial on Postgres,
+ * where a raised unique violation would poison the whole transaction; the
+ * conflict-tolerant insert lets the schedule row advance even when the
+ * overlap guard suppresses the occurrence.
+ */
+class PostgresScheduleStore {
+    async upsert(db, input) {
+        const nowIso = new Date().toISOString();
+        const [row] = await db
+            .insert(schema_1.jobSchedules)
+            .values({
+            id: (0, node_crypto_1.randomUUID)(),
+            ...input,
+            enabled: input.enabled ?? true,
+            lastEnqueuedAt: null,
+            lastError: null,
+            createdAt: nowIso,
+            updatedAt: nowIso,
+        })
+            .onConflictDoUpdate({
+            target: schema_1.jobSchedules.name,
+            // Updates keep id / createdAt / lastEnqueuedAt; a successful upsert
+            // clears any stale claim-time error. Two deliberate preservations
+            // make boot-time upserts safe: an omitted `enabled` (null) keeps the
+            // stored flag (ops kill switches survive redeploys), and the stored
+            // `next_run_at` survives while cron/timezone are unchanged (a pending
+            // catch-up is not skipped; the rhythm is not perturbed).
+            set: {
+                nextRunAt: (0, drizzle_orm_1.sql) `CASE WHEN ${schema_1.jobSchedules.cron} = excluded.cron AND ${schema_1.jobSchedules.timezone} IS NOT DISTINCT FROM excluded.timezone AND ${schema_1.jobSchedules.nextRunAt} IS NOT NULL THEN ${schema_1.jobSchedules.nextRunAt} ELSE excluded.next_run_at END`,
+                jobName: input.jobName,
+                payload: input.payload,
+                cron: input.cron,
+                timezone: input.timezone,
+                maxAttempts: input.maxAttempts,
+                priority: input.priority,
+                uniqueKey: input.uniqueKey,
+                lastError: null,
+                updatedAt: nowIso,
+                ...(input.enabled !== null && { enabled: input.enabled }),
+            },
+        })
+            .returning();
+        return row;
+    }
+    async get(db, name) {
+        const rows = await db
+            .select()
+            .from(schema_1.jobSchedules)
+            .where((0, drizzle_orm_1.eq)(schema_1.jobSchedules.name, name));
+        return rows[0];
+    }
+    async list(db) {
+        return db
+            .select()
+            .from(schema_1.jobSchedules)
+            .orderBy((0, drizzle_orm_1.asc)(schema_1.jobSchedules.name));
+    }
+    async remove(db, name) {
+        const rows = await db
+            .delete(schema_1.jobSchedules)
+            .where((0, drizzle_orm_1.eq)(schema_1.jobSchedules.name, name))
+            .returning({ id: schema_1.jobSchedules.id });
+        return rows.length > 0;
+    }
+    async setEnabled(db, name, enabled, nextRunAt, expectedUpdatedAt) {
+        const rows = await db
+            .update(schema_1.jobSchedules)
+            .set({ enabled, nextRunAt, updatedAt: new Date().toISOString() })
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.jobSchedules.name, name), 
+        // Optimistic guard: only write over the row version the caller read.
+        ...(expectedUpdatedAt === undefined
+            ? []
+            : [(0, drizzle_orm_1.eq)(schema_1.jobSchedules.updatedAt, expectedUpdatedAt)])))
+            .returning();
+        return rows[0];
+    }
+    async listDue(db, nowIso, limit) {
+        return db
+            .select()
+            .from(schema_1.jobSchedules)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.jobSchedules.enabled, true), (0, drizzle_orm_1.isNotNull)(schema_1.jobSchedules.nextRunAt), (0, drizzle_orm_1.lte)(schema_1.jobSchedules.nextRunAt, nowIso)))
+            .orderBy((0, drizzle_orm_1.asc)(schema_1.jobSchedules.nextRunAt))
+            .limit(limit);
+    }
+    async claimAndEnqueue(db, claim) {
+        return db.transaction(async (tx) => {
+            const cas = await tx
+                .update(schema_1.jobSchedules)
+                .set({
+                nextRunAt: claim.nextRunAt,
+                // A schedule with no future occurrence disables itself.
+                enabled: claim.nextRunAt !== null,
+                lastEnqueuedAt: claim.nowIso,
+                lastError: null,
+                updatedAt: claim.nowIso,
+            })
+                .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema_1.jobSchedules.id, claim.id), (0, drizzle_orm_1.eq)(schema_1.jobSchedules.nextRunAt, claim.expectedNextRunAt), (0, drizzle_orm_1.eq)(schema_1.jobSchedules.enabled, true)))
+                .returning({ id: schema_1.jobSchedules.id });
+            if (cas.length === 0) {
+                return { claimed: false, job: null };
+            }
+            const inserted = await tx
+                .insert(schema_1.jobs)
+                .values({
+                id: (0, node_crypto_1.randomUUID)(),
+                name: claim.input.name,
+                payload: claim.input.payload,
+                status: 'pending',
+                maxAttempts: claim.input.maxAttempts ?? 10,
+                uniqueKey: claim.input.uniqueKey ?? null,
+                priority: claim.input.priority ?? 0,
+                availableAt: claim.nowIso,
+                createdAt: claim.nowIso,
+            })
+                .onConflictDoNothing({ target: [schema_1.jobs.name, schema_1.jobs.uniqueKey] })
+                .returning();
+            // An empty RETURNING means the overlap guard suppressed the insert (an
+            // occurrence with this (name, unique_key) is still active) — the
+            // schedule still advanced; there is just no new job.
+            return { claimed: true, job: inserted.length > 0 ? inserted[0] : null };
+        });
+    }
+    async disable(db, id, lastError) {
+        await db
+            .update(schema_1.jobSchedules)
+            .set({ enabled: false, lastError, updatedAt: new Date().toISOString() })
+            .where((0, drizzle_orm_1.eq)(schema_1.jobSchedules.id, id));
+    }
+}
+exports.PostgresScheduleStore = PostgresScheduleStore;
+//# sourceMappingURL=schedule-store.js.map

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

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

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

@@ -260,3 +260,276 @@ export declare const jobs: import("drizzle-orm/pg-core").PgTableWithColumns<{
     };
     dialect: "pg";
 }>;
+/**
+ * Postgres `job_schedules` table. Add it to your Drizzle schema (alongside
+ * `jobs`) and generate a migration with drizzle-kit — only needed when you
+ * opt in to schedules.
+ *
+ * `name` is the unique schedule identity (upserts key on it); the
+ * `(enabled, next_run_at)` index serves the claimer's due query. Timestamps
+ * are ISO-8601 strings, like every timestamp in this package.
+ */
+export declare const jobSchedules: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "job_schedules";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "job_schedules";
+            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: "job_schedules";
+            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;
+        }, {}, {}>;
+        jobName: import("drizzle-orm/pg-core").PgColumn<{
+            name: "job_name";
+            tableName: "job_schedules";
+            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: "job_schedules";
+            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>;
+        }>;
+        cron: import("drizzle-orm/pg-core").PgColumn<{
+            name: "cron";
+            tableName: "job_schedules";
+            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;
+        }, {}, {}>;
+        timezone: import("drizzle-orm/pg-core").PgColumn<{
+            name: "timezone";
+            tableName: "job_schedules";
+            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;
+        }, {}, {}>;
+        enabled: import("drizzle-orm/pg-core").PgColumn<{
+            name: "enabled";
+            tableName: "job_schedules";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        nextRunAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "next_run_at";
+            tableName: "job_schedules";
+            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;
+        }, {}, {}>;
+        maxAttempts: import("drizzle-orm/pg-core").PgColumn<{
+            name: "max_attempts";
+            tableName: "job_schedules";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        priority: import("drizzle-orm/pg-core").PgColumn<{
+            name: "priority";
+            tableName: "job_schedules";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            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: "job_schedules";
+            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;
+        }, {}, {}>;
+        lastEnqueuedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_enqueued_at";
+            tableName: "job_schedules";
+            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: "job_schedules";
+            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: "job_schedules";
+            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;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "job_schedules";
+            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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.jobs = void 0;
+exports.jobSchedules = 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
@@ -34,4 +34,33 @@ exports.jobs = (0, pg_core_1.pgTable)('jobs', {
     (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),
 ]);
+/**
+ * Postgres `job_schedules` table. Add it to your Drizzle schema (alongside
+ * `jobs`) and generate a migration with drizzle-kit — only needed when you
+ * opt in to schedules.
+ *
+ * `name` is the unique schedule identity (upserts key on it); the
+ * `(enabled, next_run_at)` index serves the claimer's due query. Timestamps
+ * are ISO-8601 strings, like every timestamp in this package.
+ */
+exports.jobSchedules = (0, pg_core_1.pgTable)('job_schedules', {
+    id: (0, pg_core_1.text)('id').primaryKey(),
+    name: (0, pg_core_1.text)('name').notNull(),
+    jobName: (0, pg_core_1.text)('job_name').notNull(),
+    payload: (0, pg_core_1.jsonb)('payload').$type().notNull(),
+    cron: (0, pg_core_1.text)('cron').notNull(),
+    timezone: (0, pg_core_1.text)('timezone'),
+    enabled: (0, pg_core_1.boolean)('enabled').notNull().default(true),
+    nextRunAt: (0, pg_core_1.text)('next_run_at'),
+    maxAttempts: (0, pg_core_1.integer)('max_attempts'),
+    priority: (0, pg_core_1.integer)('priority'),
+    uniqueKey: (0, pg_core_1.text)('unique_key'),
+    lastEnqueuedAt: (0, pg_core_1.text)('last_enqueued_at'),
+    lastError: (0, pg_core_1.text)('last_error'),
+    createdAt: (0, pg_core_1.text)('created_at').notNull(),
+    updatedAt: (0, pg_core_1.text)('updated_at').notNull(),
+}, (table) => [
+    (0, pg_core_1.uniqueIndex)('job_schedules_name_unique').on(table.name),
+    (0, pg_core_1.index)('job_schedules_enabled_next_run_idx').on(table.enabled, table.nextRunAt),
+]);
 //# sourceMappingURL=schema.js.map

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

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

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

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

package/dist/dialects/sqlite/index.js

@@ -15,7 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 // @nest-native/jobs/sqlite — the better-sqlite3 (synchronous) dialect:
-// the `jobs` table definition + the SQLite store.
+// the `jobs` + `job_schedules` table definitions + the SQLite stores.
 __exportStar(require("./schema"), exports);
 __exportStar(require("./job-store"), exports);
+__exportStar(require("./schedule-store"), exports);
 //# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { ResolvedScheduleUpsert, ScheduleClaim, ScheduleClaimResult, ScheduleRow, ScheduleStore } from '../../interfaces';
+/**
+ * SQLite (better-sqlite3) schedule store. Like {@link SqliteJobStore}, every
+ * method runs **synchronously** — `upsert` returns the row directly so it
+ * composes inside a synchronous `@Transactional` body; the rest wrap their
+ * synchronous result in a resolved Promise.
+ *
+ * `claimAndEnqueue` runs the compare-and-swap on `next_run_at` and the
+ * occurrence insert in ONE synchronous transaction. The insert uses
+ * `ON CONFLICT DO NOTHING` on `(name, unique_key)` so an active occurrence
+ * with the schedule's `uniqueKey` suppresses the new one (the overlap guard)
+ * without poisoning the transaction — the schedule row still advances.
+ */
+export declare class SqliteScheduleStore implements ScheduleStore {
+    upsert(db: unknown, input: ResolvedScheduleUpsert): ScheduleRow;
+    get(db: unknown, name: string): Promise<ScheduleRow | undefined>;
+    list(db: unknown): Promise<ScheduleRow[]>;
+    remove(db: unknown, name: string): Promise<boolean>;
+    setEnabled(db: unknown, name: string, enabled: boolean, nextRunAt: string | null, expectedUpdatedAt?: string): Promise<ScheduleRow | undefined>;
+    listDue(db: unknown, nowIso: string, limit: number): Promise<ScheduleRow[]>;
+    claimAndEnqueue(db: unknown, claim: ScheduleClaim): Promise<ScheduleClaimResult>;
+    disable(db: unknown, id: string, lastError: string): Promise<void>;
+}