@nest-batch/core 0.2.0

package/dist/src/repository/in-memory/in-memory-job-repository.js

@@ -0,0 +1,291 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get InMemoryJobRepository () {
+        return InMemoryJobRepository;
+    },
+    get RESTARTABLE_DEFAULT_INMEMORY () {
+        return RESTARTABLE_DEFAULT_INMEMORY;
+    }
+});
+const _common = require("@nestjs/common");
+const _core = require("@nest-batch/core");
+const _idgenerator = require("../id-generator");
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+function deepClone(value) {
+    if (value === null || typeof value !== 'object') return value;
+    if (value instanceof Date) return new Date(value.getTime());
+    if (Array.isArray(value)) return value.map((v)=>deepClone(v));
+    const out = {};
+    for (const k of Object.keys(value)){
+        out[k] = deepClone(value[k]);
+    }
+    return out;
+}
+function scopeKey(scope) {
+    if ('jobExecutionId' in scope) return `job::${scope.jobExecutionId}`;
+    return `step::${scope.stepExecutionId}`;
+}
+let InMemoryJobRepository = class InMemoryJobRepository extends _core.JobRepository {
+    idGen;
+    state = {
+        instances: new Map(),
+        instancesByKey: new Map(),
+        executions: new Map(),
+        stepExecutions: new Map(),
+        contexts: new Map()
+    };
+    /** Promise-chain lock to serialize getOrCreateJobInstance calls. */ lock = Promise.resolve();
+    constructor(idGen = new _idgenerator.UuidIdGenerator()){
+        super(), this.idGen = idGen;
+    }
+    async withLock(fn) {
+        const prev = this.lock;
+        let release;
+        this.lock = new Promise((resolve)=>{
+            release = resolve;
+        });
+        try {
+            await prev;
+            return await fn();
+        } finally{
+            release();
+        }
+    }
+    async getOrCreateJobInstance(name, jobKey) {
+        return this.withLock(async ()=>{
+            const key = `${name}::${jobKey}`;
+            const existing = this.state.instancesByKey.get(key);
+            if (existing) return deepClone(existing);
+            const inst = {
+                id: this.idGen.next(),
+                jobName: name,
+                jobKey,
+                createdAt: new Date()
+            };
+            this.state.instances.set(inst.id, inst);
+            this.state.instancesByKey.set(key, inst);
+            return deepClone(inst);
+        });
+    }
+    async createJobExecution(jobInstanceId, params) {
+        return this.withLock(async ()=>{
+            const exec = {
+                id: this.idGen.next(),
+                jobInstanceId,
+                status: _core.JobStatus.STARTING,
+                startTime: null,
+                endTime: null,
+                exitCode: '',
+                exitMessage: '',
+                params: deepClone(params)
+            };
+            this.state.executions.set(exec.id, exec);
+            return deepClone(exec);
+        });
+    }
+    async createExecutionAtomic(name, jobKey, params) {
+        return this.withLock(async ()=>{
+            const key = `${name}::${jobKey}`;
+            let instance = this.state.instancesByKey.get(key);
+            if (!instance) {
+                instance = {
+                    id: this.idGen.next(),
+                    jobName: name,
+                    jobKey,
+                    createdAt: new Date()
+                };
+                this.state.instances.set(instance.id, instance);
+                this.state.instancesByKey.set(key, instance);
+            }
+            for (const exec of this.state.executions.values()){
+                if (exec.jobInstanceId === instance.id && (exec.status === _core.JobStatus.STARTING || exec.status === _core.JobStatus.STARTED)) {
+                    throw new _core.JobExecutionAlreadyRunningError(exec.id);
+                }
+            }
+            const exec = {
+                id: this.idGen.next(),
+                jobInstanceId: instance.id,
+                status: _core.JobStatus.STARTING,
+                startTime: null,
+                endTime: null,
+                exitCode: '',
+                exitMessage: '',
+                params: deepClone(params)
+            };
+            this.state.executions.set(exec.id, exec);
+            return deepClone(exec);
+        });
+    }
+    async getRunningJobExecution(jobInstanceId) {
+        return this.withLock(async ()=>{
+            for (const exec of this.state.executions.values()){
+                if (exec.jobInstanceId === jobInstanceId && (exec.status === _core.JobStatus.STARTING || exec.status === _core.JobStatus.STARTED)) {
+                    return deepClone(exec);
+                }
+            }
+            return null;
+        });
+    }
+    async updateJobExecution(executionId, patch) {
+        const cur = this.state.executions.get(executionId);
+        if (!cur) throw new Error(`JobExecution not found: ${executionId}`);
+        const next = {
+            ...cur,
+            ...patch,
+            startTime: patch.startTime === undefined ? cur.startTime : patch.startTime,
+            endTime: patch.endTime === undefined ? cur.endTime : patch.endTime
+        };
+        this.state.executions.set(executionId, next);
+    }
+    async getJobExecution(executionId) {
+        const e = this.state.executions.get(executionId);
+        return e ? deepClone(e) : null;
+    }
+    async getJobInstance(jobInstanceId) {
+        const instance = this.state.instances.get(jobInstanceId);
+        return instance ? deepClone(instance) : null;
+    }
+    async findJobInstances(filter = {}) {
+        const rows = [];
+        for (const instance of this.state.instances.values()){
+            if (filter.jobName !== undefined && instance.jobName !== filter.jobName) continue;
+            if (filter.jobKey !== undefined && instance.jobKey !== filter.jobKey) continue;
+            rows.push(deepClone(instance));
+        }
+        return rows;
+    }
+    async findJobExecutions(filter = {}) {
+        let statuses;
+        if (filter.status !== undefined) {
+            const statusFilter = filter.status;
+            const statusList = Array.isArray(statusFilter) ? statusFilter : [
+                statusFilter
+            ];
+            statuses = new Set(statusList);
+        }
+        const rows = [];
+        for (const execution of this.state.executions.values()){
+            if (filter.jobInstanceId !== undefined && execution.jobInstanceId !== filter.jobInstanceId) {
+                continue;
+            }
+            if (statuses !== undefined && !statuses.has(execution.status)) continue;
+            if (filter.startedAfter !== undefined && (execution.startTime === null || execution.startTime < filter.startedAfter)) {
+                continue;
+            }
+            if (filter.startedBefore !== undefined && (execution.startTime === null || execution.startTime > filter.startedBefore)) {
+                continue;
+            }
+            rows.push(deepClone(execution));
+        }
+        return rows;
+    }
+    async createStepExecution(jobExecutionId, stepName) {
+        const step = {
+            id: this.idGen.next(),
+            jobExecutionId,
+            stepName,
+            status: _core.StepStatus.STARTING,
+            readCount: 0,
+            writeCount: 0,
+            skipCount: 0,
+            rollbackCount: 0,
+            commitCount: 0,
+            startTime: null,
+            endTime: null,
+            exitCode: '',
+            exitMessage: ''
+        };
+        this.state.stepExecutions.set(step.id, step);
+        return deepClone(step);
+    }
+    async updateStepExecution(stepExecutionId, patch) {
+        const cur = this.state.stepExecutions.get(stepExecutionId);
+        if (!cur) throw new Error(`StepExecution not found: ${stepExecutionId}`);
+        const next = {
+            ...cur,
+            ...patch
+        };
+        this.state.stepExecutions.set(stepExecutionId, next);
+    }
+    async getStepExecution(stepExecutionId) {
+        const s = this.state.stepExecutions.get(stepExecutionId);
+        return s ? deepClone(s) : null;
+    }
+    async findStepExecutions(jobExecutionId) {
+        const rows = [];
+        for (const step of this.state.stepExecutions.values()){
+            if (step.jobExecutionId === jobExecutionId) {
+                rows.push(deepClone(step));
+            }
+        }
+        return rows;
+    }
+    async getExecutionContext(scope) {
+        const ctx = this.state.contexts.get(scopeKey(scope));
+        if (ctx) return {
+            data: deepClone(ctx.data),
+            version: ctx.version
+        };
+        return {
+            data: null,
+            version: 0
+        };
+    }
+    async saveExecutionContext(scope, ctx, version) {
+        // Validate JSON-serializability (per ExecutionContext contract)
+        (0, _core.assertJsonSerializable)(ctx.data);
+        const current = this.state.contexts.get(scopeKey(scope));
+        const nextVersion = version !== undefined ? version : (current?.version ?? 0) + 1;
+        this.state.contexts.set(scopeKey(scope), {
+            data: deepClone(ctx.data),
+            version: nextVersion
+        });
+    }
+    /**
+   * Returns the most recently created StepExecution for the given
+   * (jobExecutionId, stepName) pair, or `null` if none exists. Insertion
+   * order over `Map` is stable (ES2015+), so a reverse scan picks the
+   * latest entry that matches the filter. The restart path filters the
+   * result further by status (FAILED) at the call site.
+   */ async findLatestStepExecution(jobExecutionId, stepName) {
+        let latest = null;
+        for (const step of this.state.stepExecutions.values()){
+            if (step.jobExecutionId === jobExecutionId && step.stepName === stepName) {
+                if (!latest) {
+                    latest = step;
+                }
+                // No monotonic timestamp on StepExecution itself; rely on Map
+                // insertion order: later-created entries override earlier ones.
+                latest = step;
+            }
+        }
+        return latest ? deepClone(latest) : null;
+    }
+};
+InMemoryJobRepository = _ts_decorate([
+    (0, _common.Injectable)(),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof IdGenerator === "undefined" ? Object : IdGenerator
+    ])
+], InMemoryJobRepository);
+const RESTARTABLE_DEFAULT_INMEMORY = false;
+
+//# sourceMappingURL=in-memory-job-repository.js.map

package/dist/src/repository/in-memory/in-memory-job-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/repository/in-memory/in-memory-job-repository.ts"],"sourcesContent":["import { Injectable } from '@nestjs/common';\nimport { JobRepository } from '@nest-batch/core';\nimport type {\n  JobInstance,\n  JobExecution,\n  JobExecutionPatch,\n  JobParameters,\n  StepExecution,\n  StepExecutionPatch,\n  ExecutionContext,\n  ExecutionScope,\n  JobInstanceFilter,\n  JobExecutionFilter,\n} from '@nest-batch/core';\nimport { JobStatus, StepStatus } from '@nest-batch/core';\nimport { JobExecutionAlreadyRunningError } from '@nest-batch/core';\nimport { assertJsonSerializable } from '@nest-batch/core';\nimport type { IdGenerator } from '../id-generator';\nimport { UuidIdGenerator } from '../id-generator';\n\nfunction deepClone<T>(value: T): T {\n  if (value === null || typeof value !== 'object') return value;\n  if (value instanceof Date) return new Date(value.getTime()) as unknown as T;\n  if (Array.isArray(value)) return value.map((v) => deepClone(v)) as unknown as T;\n  const out: Record<string, unknown> = {};\n  for (const k of Object.keys(value as Record<string, unknown>)) {\n    out[k] = deepClone((value as Record<string, unknown>)[k]);\n  }\n  return out as T;\n}\n\ninterface InMemoryState {\n  instances: Map<string, JobInstance>; // key: instanceId\n  instancesByKey: Map<string, JobInstance>; // key: `${name}::${jobKey}`\n  executions: Map<string, JobExecution>;\n  stepExecutions: Map<string, StepExecution>;\n  contexts: Map<string, ExecutionContext>; // key: serialized ExecutionScope\n}\n\nfunction scopeKey(scope: ExecutionScope): string {\n  if ('jobExecutionId' in scope) return `job::${scope.jobExecutionId}`;\n  return `step::${scope.stepExecutionId}`;\n}\n\n/**\n * In-memory JobRepository with real-repo semantics:\n * - deterministic IDs (configurable via IdGenerator)\n * - deep clone on reads/writes to prevent mutation leaks\n * - async signatures\n * - uniqueness on (jobName, jobKey)\n * - getOrCreateJobInstance / createJobExecution / getRunningJobExecution\n *   share a single promise-chain lock, so the check-then-create sequence\n *   used by JobLauncher is race-safe\n *\n * restartable: false by default (per Metis directive: in-memory repo is non-restartable\n * because contexts are lost on process restart).\n */\n@Injectable()\nexport class InMemoryJobRepository extends JobRepository {\n  private readonly state: InMemoryState = {\n    instances: new Map(),\n    instancesByKey: new Map(),\n    executions: new Map(),\n    stepExecutions: new Map(),\n    contexts: new Map(),\n  };\n  /** Promise-chain lock to serialize getOrCreateJobInstance calls. */\n  private lock: Promise<unknown> = Promise.resolve();\n\n  constructor(private readonly idGen: IdGenerator = new UuidIdGenerator()) {\n    super();\n  }\n\n  private async withLock<T>(fn: () => Promise<T>): Promise<T> {\n    const prev = this.lock;\n    let release!: () => void;\n    this.lock = new Promise<void>((resolve) => {\n      release = resolve;\n    });\n    try {\n      await prev;\n      return await fn();\n    } finally {\n      release();\n    }\n  }\n\n  async getOrCreateJobInstance(name: string, jobKey: string): Promise<JobInstance> {\n    return this.withLock(async () => {\n      const key = `${name}::${jobKey}`;\n      const existing = this.state.instancesByKey.get(key);\n      if (existing) return deepClone(existing);\n      const inst: JobInstance = {\n        id: this.idGen.next(),\n        jobName: name,\n        jobKey,\n        createdAt: new Date(),\n      };\n      this.state.instances.set(inst.id, inst);\n      this.state.instancesByKey.set(key, inst);\n      return deepClone(inst);\n    });\n  }\n\n  async createJobExecution(jobInstanceId: string, params: JobParameters): Promise<JobExecution> {\n    return this.withLock(async () => {\n      const exec: JobExecution = {\n        id: this.idGen.next(),\n        jobInstanceId,\n        status: JobStatus.STARTING,\n        startTime: null,\n        endTime: null,\n        exitCode: '',\n        exitMessage: '',\n        params: deepClone(params),\n      };\n      this.state.executions.set(exec.id, exec);\n      return deepClone(exec);\n    });\n  }\n\n  async createExecutionAtomic(\n    name: string,\n    jobKey: string,\n    params: JobParameters,\n  ): Promise<JobExecution> {\n    return this.withLock(async () => {\n      const key = `${name}::${jobKey}`;\n      let instance = this.state.instancesByKey.get(key);\n      if (!instance) {\n        instance = {\n          id: this.idGen.next(),\n          jobName: name,\n          jobKey,\n          createdAt: new Date(),\n        };\n        this.state.instances.set(instance.id, instance);\n        this.state.instancesByKey.set(key, instance);\n      }\n      for (const exec of this.state.executions.values()) {\n        if (\n          exec.jobInstanceId === instance.id &&\n          (exec.status === JobStatus.STARTING || exec.status === JobStatus.STARTED)\n        ) {\n          throw new JobExecutionAlreadyRunningError(exec.id);\n        }\n      }\n      const exec: JobExecution = {\n        id: this.idGen.next(),\n        jobInstanceId: instance.id,\n        status: JobStatus.STARTING,\n        startTime: null,\n        endTime: null,\n        exitCode: '',\n        exitMessage: '',\n        params: deepClone(params),\n      };\n      this.state.executions.set(exec.id, exec);\n      return deepClone(exec);\n    });\n  }\n\n  async getRunningJobExecution(jobInstanceId: string): Promise<JobExecution | null> {\n    return this.withLock(async () => {\n      for (const exec of this.state.executions.values()) {\n        if (\n          exec.jobInstanceId === jobInstanceId &&\n          (exec.status === JobStatus.STARTING || exec.status === JobStatus.STARTED)\n        ) {\n          return deepClone(exec);\n        }\n      }\n      return null;\n    });\n  }\n\n  async updateJobExecution(executionId: string, patch: JobExecutionPatch): Promise<void> {\n    const cur = this.state.executions.get(executionId);\n    if (!cur) throw new Error(`JobExecution not found: ${executionId}`);\n    const next: JobExecution = {\n      ...cur,\n      ...patch,\n      startTime: patch.startTime === undefined ? cur.startTime : patch.startTime,\n      endTime: patch.endTime === undefined ? cur.endTime : patch.endTime,\n    };\n    this.state.executions.set(executionId, next);\n  }\n\n  async getJobExecution(executionId: string): Promise<JobExecution | null> {\n    const e = this.state.executions.get(executionId);\n    return e ? deepClone(e) : null;\n  }\n\n  override async getJobInstance(jobInstanceId: string): Promise<JobInstance | null> {\n    const instance = this.state.instances.get(jobInstanceId);\n    return instance ? deepClone(instance) : null;\n  }\n\n  override async findJobInstances(filter: JobInstanceFilter = {}): Promise<JobInstance[]> {\n    const rows: JobInstance[] = [];\n    for (const instance of this.state.instances.values()) {\n      if (filter.jobName !== undefined && instance.jobName !== filter.jobName) continue;\n      if (filter.jobKey !== undefined && instance.jobKey !== filter.jobKey) continue;\n      rows.push(deepClone(instance));\n    }\n    return rows;\n  }\n\n  override async findJobExecutions(filter: JobExecutionFilter = {}): Promise<JobExecution[]> {\n    let statuses: Set<JobStatus> | undefined;\n    if (filter.status !== undefined) {\n      const statusFilter = filter.status;\n      const statusList: readonly JobStatus[] = Array.isArray(statusFilter)\n        ? statusFilter\n        : [statusFilter];\n      statuses = new Set<JobStatus>(statusList);\n    }\n\n    const rows: JobExecution[] = [];\n    for (const execution of this.state.executions.values()) {\n      if (\n        filter.jobInstanceId !== undefined &&\n        execution.jobInstanceId !== filter.jobInstanceId\n      ) {\n        continue;\n      }\n      if (statuses !== undefined && !statuses.has(execution.status)) continue;\n      if (\n        filter.startedAfter !== undefined &&\n        (execution.startTime === null || execution.startTime < filter.startedAfter)\n      ) {\n        continue;\n      }\n      if (\n        filter.startedBefore !== undefined &&\n        (execution.startTime === null || execution.startTime > filter.startedBefore)\n      ) {\n        continue;\n      }\n      rows.push(deepClone(execution));\n    }\n    return rows;\n  }\n\n  async createStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution> {\n    const step: StepExecution = {\n      id: this.idGen.next(),\n      jobExecutionId,\n      stepName,\n      status: StepStatus.STARTING,\n      readCount: 0,\n      writeCount: 0,\n      skipCount: 0,\n      rollbackCount: 0,\n      commitCount: 0,\n      startTime: null,\n      endTime: null,\n      exitCode: '',\n      exitMessage: '',\n    };\n    this.state.stepExecutions.set(step.id, step);\n    return deepClone(step);\n  }\n\n  async updateStepExecution(stepExecutionId: string, patch: StepExecutionPatch): Promise<void> {\n    const cur = this.state.stepExecutions.get(stepExecutionId);\n    if (!cur) throw new Error(`StepExecution not found: ${stepExecutionId}`);\n    const next: StepExecution = { ...cur, ...patch };\n    this.state.stepExecutions.set(stepExecutionId, next);\n  }\n\n  async getStepExecution(stepExecutionId: string): Promise<StepExecution | null> {\n    const s = this.state.stepExecutions.get(stepExecutionId);\n    return s ? deepClone(s) : null;\n  }\n\n  override async findStepExecutions(jobExecutionId: string): Promise<StepExecution[]> {\n    const rows: StepExecution[] = [];\n    for (const step of this.state.stepExecutions.values()) {\n      if (step.jobExecutionId === jobExecutionId) {\n        rows.push(deepClone(step));\n      }\n    }\n    return rows;\n  }\n\n  async getExecutionContext(scope: ExecutionScope): Promise<ExecutionContext> {\n    const ctx = this.state.contexts.get(scopeKey(scope));\n    if (ctx) return { data: deepClone(ctx.data), version: ctx.version };\n    return { data: null, version: 0 };\n  }\n\n  async saveExecutionContext(\n    scope: ExecutionScope,\n    ctx: ExecutionContext,\n    version?: number,\n  ): Promise<void> {\n    // Validate JSON-serializability (per ExecutionContext contract)\n    assertJsonSerializable(ctx.data);\n    const current = this.state.contexts.get(scopeKey(scope));\n    const nextVersion = version !== undefined ? version : (current?.version ?? 0) + 1;\n    this.state.contexts.set(scopeKey(scope), {\n      data: deepClone(ctx.data),\n      version: nextVersion,\n    });\n  }\n\n  /**\n   * Returns the most recently created StepExecution for the given\n   * (jobExecutionId, stepName) pair, or `null` if none exists. Insertion\n   * order over `Map` is stable (ES2015+), so a reverse scan picks the\n   * latest entry that matches the filter. The restart path filters the\n   * result further by status (FAILED) at the call site.\n   */\n  async findLatestStepExecution(\n    jobExecutionId: string,\n    stepName: string,\n  ): Promise<StepExecution | null> {\n    let latest: StepExecution | null = null;\n    for (const step of this.state.stepExecutions.values()) {\n      if (step.jobExecutionId === jobExecutionId && step.stepName === stepName) {\n        if (!latest) {\n          latest = step;\n        }\n        // No monotonic timestamp on StepExecution itself; rely on Map\n        // insertion order: later-created entries override earlier ones.\n        latest = step;\n      }\n    }\n    return latest ? deepClone(latest) : null;\n  }\n}\n\nexport const RESTARTABLE_DEFAULT_INMEMORY = false;\n"],"names":["InMemoryJobRepository","RESTARTABLE_DEFAULT_INMEMORY","deepClone","value","Date","getTime","Array","isArray","map","v","out","k","Object","keys","scopeKey","scope","jobExecutionId","stepExecutionId","JobRepository","state","instances","Map","instancesByKey","executions","stepExecutions","contexts","lock","Promise","resolve","idGen","UuidIdGenerator","withLock","fn","prev","release","getOrCreateJobInstance","name","jobKey","key","existing","get","inst","id","next","jobName","createdAt","set","createJobExecution","jobInstanceId","params","exec","status","JobStatus","STARTING","startTime","endTime","exitCode","exitMessage","createExecutionAtomic","instance","values","STARTED","JobExecutionAlreadyRunningError","getRunningJobExecution","updateJobExecution","executionId","patch","cur","Error","undefined","getJobExecution","e","getJobInstance","findJobInstances","filter","rows","push","findJobExecutions","statuses","statusFilter","statusList","Set","execution","has","startedAfter","startedBefore","createStepExecution","stepName","step","StepStatus","readCount","writeCount","skipCount","rollbackCount","commitCount","updateStepExecution","getStepExecution","s","findStepExecutions","getExecutionContext","ctx","data","version","saveExecutionContext","assertJsonSerializable","current","nextVersion","findLatestStepExecution","latest"],"mappings":"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"}

package/dist/src/repository/in-memory/index.d.ts

@@ -0,0 +1,2 @@
+export * from './in-memory-job-repository';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/repository/in-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/repository/in-memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/src/repository/in-memory/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./in-memory-job-repository"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/src/repository/in-memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/repository/in-memory/index.ts"],"sourcesContent":["export * from './in-memory-job-repository';\n"],"names":[],"mappings":";;;;qBAAc"}

package/dist/src/repository/index.d.ts

@@ -0,0 +1,4 @@
+export * from './id-generator';
+export * from './uuid-v7';
+export * from './in-memory';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/repository/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/src/repository/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./id-generator"), exports);
+_export_star(require("./uuid-v7"), exports);
+_export_star(require("./in-memory"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/src/repository/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/repository/index.ts"],"sourcesContent":["export * from './id-generator';\nexport * from './uuid-v7';\nexport * from './in-memory';\n"],"names":[],"mappings":";;;;qBAAc;qBACA;qBACA"}

package/dist/src/repository/uuid-v7.d.ts

@@ -0,0 +1,20 @@
+/**
+ * UUID v7 generator — time-sortable IDs (first 48 bits are unix time ms).
+ *
+ * Suitable for execution IDs (JobExecution, StepExecution) where
+ * chronological ordering is useful — e.g., grouping recent runs in a
+ * log dashboard or in a B-tree keyed persistence layer.
+ *
+ * Layout per RFC 9562 §5.7:
+ *   xxxxxxxx-xxxx-7xxx-yxxx-xxxxxxxxxxxx
+ *     ^ts hi   ^ts lo  ^rand  ^rand   ^rand
+ * where:
+ *   - positions 0-11  = 48-bit unix-ms timestamp (sortable)
+ *   - position 14     = version nibble '7'
+ *   - position 19     = variant nibble ∈ {8, 9, a, b} (top 2 bits = 10)
+ *   - remaining 62    = random bits from `crypto.randomBytes(10)`
+ */
+export declare class UuidV7IdGenerator {
+    next(): string;
+}
+//# sourceMappingURL=uuid-v7.d.ts.map

package/dist/src/repository/uuid-v7.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-v7.d.ts","sourceRoot":"","sources":["../../../src/repository/uuid-v7.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAiB;IAC5B,IAAI,IAAI,MAAM;CAoBf"}

package/dist/src/repository/uuid-v7.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "UuidV7IdGenerator", {
+    enumerable: true,
+    get: function() {
+        return UuidV7IdGenerator;
+    }
+});
+const _crypto = require("crypto");
+let UuidV7IdGenerator = class UuidV7IdGenerator {
+    next() {
+        // 48-bit timestamp in hex (12 chars) — Date.now() is bounded to ~2^41
+        // today, so padStart keeps it stable-width for predictable sorting.
+        const ts = Date.now().toString(16).padStart(12, '0');
+        // 80 random bits (10 bytes). We use byte 0's top nibble as the
+        // variant and place it explicitly in group 4; the remaining 9
+        // bytes (18 hex chars) fill the rest of the random slots.
+        const rand = (0, _crypto.randomBytes)(10);
+        // RFC 9562 §4.1 variant: top 2 bits of the variant nibble must be `10`.
+        // `& 0x3f` clears the top 2 bits, then `| 0x80` sets them to `10`,
+        // yielding a value in [0x80, 0xbf] whose hex first digit ∈ {8,9,a,b}.
+        const variantNibble = ((rand[0] ?? 0) & 0x3f | 0x80).toString(16)[0];
+        // 18 hex chars of pure random from the remaining 9 bytes.
+        const rest = rand.subarray(1).toString('hex');
+        return `${ts.slice(0, 8)}-${ts.slice(8, 12)}-7${rest.slice(0, 3)}-${variantNibble}${rest.slice(3, 6)}-${rest.slice(6, 18)}`;
+    }
+};
+
+//# sourceMappingURL=uuid-v7.js.map

package/dist/src/repository/uuid-v7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/repository/uuid-v7.ts"],"sourcesContent":["import { randomBytes } from 'crypto';\n\n/**\n * UUID v7 generator — time-sortable IDs (first 48 bits are unix time ms).\n *\n * Suitable for execution IDs (JobExecution, StepExecution) where\n * chronological ordering is useful — e.g., grouping recent runs in a\n * log dashboard or in a B-tree keyed persistence layer.\n *\n * Layout per RFC 9562 §5.7:\n *   xxxxxxxx-xxxx-7xxx-yxxx-xxxxxxxxxxxx\n *     ^ts hi   ^ts lo  ^rand  ^rand   ^rand\n * where:\n *   - positions 0-11  = 48-bit unix-ms timestamp (sortable)\n *   - position 14     = version nibble '7'\n *   - position 19     = variant nibble ∈ {8, 9, a, b} (top 2 bits = 10)\n *   - remaining 62    = random bits from `crypto.randomBytes(10)`\n */\nexport class UuidV7IdGenerator {\n  next(): string {\n    // 48-bit timestamp in hex (12 chars) — Date.now() is bounded to ~2^41\n    // today, so padStart keeps it stable-width for predictable sorting.\n    const ts = Date.now().toString(16).padStart(12, '0');\n\n    // 80 random bits (10 bytes). We use byte 0's top nibble as the\n    // variant and place it explicitly in group 4; the remaining 9\n    // bytes (18 hex chars) fill the rest of the random slots.\n    const rand = randomBytes(10);\n\n    // RFC 9562 §4.1 variant: top 2 bits of the variant nibble must be `10`.\n    // `& 0x3f` clears the top 2 bits, then `| 0x80` sets them to `10`,\n    // yielding a value in [0x80, 0xbf] whose hex first digit ∈ {8,9,a,b}.\n    const variantNibble = ((((rand[0] ?? 0) & 0x3f) | 0x80).toString(16) as string)[0];\n\n    // 18 hex chars of pure random from the remaining 9 bytes.\n    const rest = rand.subarray(1).toString('hex');\n\n    return `${ts.slice(0, 8)}-${ts.slice(8, 12)}-7${rest.slice(0, 3)}-${variantNibble}${rest.slice(3, 6)}-${rest.slice(6, 18)}`;\n  }\n}\n"],"names":["UuidV7IdGenerator","next","ts","Date","now","toString","padStart","rand","randomBytes","variantNibble","rest","subarray","slice"],"mappings":";;;;+BAkBaA;;;eAAAA;;;wBAlBe;AAkBrB,IAAA,AAAMA,oBAAN,MAAMA;IACXC,OAAe;QACb,sEAAsE;QACtE,oEAAoE;QACpE,MAAMC,KAAKC,KAAKC,GAAG,GAAGC,QAAQ,CAAC,IAAIC,QAAQ,CAAC,IAAI;QAEhD,+DAA+D;QAC/D,8DAA8D;QAC9D,0DAA0D;QAC1D,MAAMC,OAAOC,IAAAA,mBAAW,EAAC;QAEzB,wEAAwE;QACxE,mEAAmE;QACnE,sEAAsE;QACtE,MAAMC,gBAAgB,AAAC,AAAC,CAAA,AAAEF,CAAAA,IAAI,CAAC,EAAE,IAAI,CAAA,IAAK,OAAQ,IAAG,EAAGF,QAAQ,CAAC,GAAc,CAAC,EAAE;QAElF,0DAA0D;QAC1D,MAAMK,OAAOH,KAAKI,QAAQ,CAAC,GAAGN,QAAQ,CAAC;QAEvC,OAAO,GAAGH,GAAGU,KAAK,CAAC,GAAG,GAAG,CAAC,EAAEV,GAAGU,KAAK,CAAC,GAAG,IAAI,EAAE,EAAEF,KAAKE,KAAK,CAAC,GAAG,GAAG,CAAC,EAAEH,gBAAgBC,KAAKE,KAAK,CAAC,GAAG,GAAG,CAAC,EAAEF,KAAKE,KAAK,CAAC,GAAG,KAAK;IAC7H;AACF"}

package/dist/src/scheduling/batch-scheduled.d.ts

@@ -0,0 +1,87 @@
+import 'reflect-metadata';
+export declare const BATCH_SCHEDULED_OPTIONS = "nest-batch:scheduled";
+/**
+ * Overlap policies for cron-scheduled jobs:
+ *
+ * - `'skip'`     — drop the new tick if the previous run is still in flight.
+ * - `'queue'`    — buffer the new tick and start it after the current one ends.
+ * - `'parallel'` — start the new tick alongside the current one.
+ *
+ * The runtime scheduler (the future `@nest-batch/bullmq` cron strategy)
+ * reads this value off the stored metadata and applies the policy at
+ * dispatch time. The decorator itself MUST NOT silently default the
+ * policy to `'skip'` on the user's behalf — leaving it `undefined` here
+ * is the contract: the runtime applies the default.
+ */
+export type BatchOverlapPolicy = 'skip' | 'queue' | 'parallel';
+/**
+ * Decorator-facing options for `@BatchScheduled`.
+ *
+ * - `name`     — required, unique per job (used as the scheduling key).
+ * - `timezone` — required, IANA zone (e.g. `'UTC'`, `'Asia/Seoul'`).
+ * - `overlap`  — optional, see `BatchOverlapPolicy`. Default applied at
+ *                runtime, never silently here.
+ * - `startAt`  — optional, absolute lower bound. Preserved by reference.
+ * - `endAt`    — optional, absolute upper bound. Preserved by reference.
+ * - `inert`    — optional, hints the runtime scheduler to skip actual
+ *                registration. The decorator stamps this by reading
+ *                `process.env.BATCH_SCHEDULED_DISABLE` at decoration time
+ *                so the runtime never has to re-evaluate the env.
+ */
+export interface BatchScheduledOptions {
+    name: string;
+    timezone: string;
+    overlap?: BatchOverlapPolicy;
+    startAt?: Date;
+    endAt?: Date;
+    inert?: boolean;
+}
+/**
+ * The shape stored under the `BATCH_SCHEDULED_OPTIONS` metadata key on
+ * the decorated method function. The runtime scheduler (the future
+ * `@nest-batch/bullmq` cron strategy) reads this verbatim to register
+ * the job with the underlying scheduler.
+ *
+ * Note: `inert` lives at the top level (not inside `options`) on
+ * purpose. It is a *runtime* flag captured at decoration time from
+ * `process.env.BATCH_SCHEDULED_DISABLE`; it is not a user-facing
+ * knob in `BatchScheduledOptions`. (The `inert?: boolean` slot on
+ * `BatchScheduledOptions` is the user-facing counterpart — see the
+ * GREEN half of Task 13 to wire it up.)
+ */
+export interface BatchScheduledMetadata {
+    cron: string;
+    options: BatchScheduledOptions;
+    inert: boolean;
+}
+/**
+ * Thrown by `@BatchScheduled` when the cron expression fails the
+ * shape check (5/6 fields, non-whitespace tokens). The `.message`
+ * includes the invalid value and the failure reason so the error
+ * is greppable in logs and pinned in test assertions.
+ *
+ * Exported from the module barrel so adapter packages (e.g. the
+ * BullMQ runtime) can `instanceof`-check it without reaching into
+ * the decorator's internal helper.
+ */
+export declare class InvalidBatchScheduledCronError extends Error {
+    readonly cron: string;
+    readonly reason: string;
+    constructor(cron: string, reason: string);
+}
+/**
+ * Thrown by `@BatchScheduled` when the IANA timezone fails the
+ * platform check. The `.message` embeds the invalid value and the
+ * failure reason.
+ *
+ * Exported from the module barrel so adapter packages can
+ * `instanceof`-check it without reaching into the decorator's
+ * internal helper.
+ */
+export declare class InvalidBatchScheduledTimezoneError extends Error {
+    readonly timezone: string;
+    readonly reason: string;
+    constructor(timezone: string, reason: string);
+}
+export declare function BatchScheduled(cronExpression: string, options: BatchScheduledOptions): MethodDecorator;
+//# sourceMappingURL=batch-scheduled.d.ts.map

package/dist/src/scheduling/batch-scheduled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-scheduled.d.ts","sourceRoot":"","sources":["../../../src/scheduling/batch-scheduled.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAK1B,eAAO,MAAM,uBAAuB,yBAAgB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;CAChB;AA2HD;;;;;;;;;GASG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAUzC;AAED;;;;;;;;GAQG;AACH,qBAAa,kCAAmC,SAAQ,KAAK;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAS7C;AAMD,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,qBAAqB,GAC7B,eAAe,CAcjB"}