@nest-batch/typeorm 0.2.0 → 0.2.2

package/README.ko.md

@@ -0,0 +1,55 @@
+# @nest-batch/typeorm
+
+`@nest-batch/core`용 TypeORM persistence adapter입니다.
+
+English: [README.md](./README.md)
+
+## 설치
+
+```bash
+pnpm add @nest-batch/core @nest-batch/typeorm typeorm
+```
+
+Nest 애플리케이션에서 `@nestjs/typeorm`을 사용한다면 기존 `TypeOrmModule.forRoot`
+구성을 그대로 소유하면 됩니다.
+
+## Public Import
+
+```ts
+import {
+  BATCH_META_ENTITIES,
+  TypeOrmAdapter,
+  TypeOrmJobRepository,
+  TypeOrmTransactionManager,
+  batchMetaEntities,
+} from '@nest-batch/typeorm';
+```
+
+## Wiring
+
+host-owned TypeORM data source에 batch metadata entity를 등록합니다.
+
+```ts
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { InProcessAdapter, NestBatchModule } from '@nest-batch/core';
+import { BATCH_META_ENTITIES, TypeOrmAdapter } from '@nest-batch/typeorm';
+
+@Module({
+  imports: [
+    TypeOrmModule.forRoot({
+      type: 'postgres',
+      entities: [ProductEntity, ...BATCH_META_ENTITIES],
+      url: process.env.DATABASE_URL,
+    }),
+    NestBatchModule.forRoot({
+      adapters: {
+        persistence: TypeOrmAdapter.forRoot(),
+        transport: InProcessAdapter.forRoot(),
+      },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+metadata entity를 추가한 뒤 application repository에서 migration을 생성하세요.

package/README.md

@@ -1,263 +1,56 @@
-# `@nest-batch/typeorm`
+# @nest-batch/typeorm
 
-The TypeORM 1.0.0 adapter for [`@nest-batch/core`](../core). It owns
-the same six Spring Batch-compatible batch meta-tables that
-`@nest-batch/mikro-orm` ships, expressed as TypeORM 1.0 entities plus
-a bundled migration. It exposes `TypeOrmJobRepository` and
-`TypeOrmTransactionManager` and runs the shared core contract suite
-against a real TypeORM `DataSource`.
+TypeORM persistence adapter for `@nest-batch/core`.
 
-The package is a **sibling**, not a replacement. The dependency
-direction is strict and one-way:
-
-```
-@nest-batch/typeorm  ──▶  @nest-batch/core
-        │
-        └──────▶  typeorm (peer, ^1.0.0)
-```
-
-`@nest-batch/core` does not know this package exists. The boundary is
-enforced by a core test that fails the build if any `typeorm` import
-shows up in core.
-
----
-
-## TypeORM 1.0.0-only policy
-
-This adapter targets **TypeORM 1.0.0 only**. The peer range is
-`typeorm: ^1.0.0` and intentionally excludes `0.3.x`.
-
-Why 1.0.0 and not 0.3? Two reasons:
-
-1. The `Connection` → `DataSource` rename. TypeORM 1.0.0 finished the
-   rename that 0.3 started; the API now exposes `DataSource`,
-   `DataSourceOptions`, and `DataSource.transaction()` instead of
-   `Connection`, `ConnectionOptions`, and `Connection.transaction()`.
-   Maintaining 0.3 support would mean running the full codebase
-   through `Connection → DataSource` shims, which is a waste of
-   effort when 0.3 is on a separate support track.
-2. The entity / migration surface. A few decorators and migration
-   helpers moved between 0.3 and 1.0. Supporting both means
-   conditional entity definitions, which is a smell.
-
-The peer range is `^1.0.0`, so any 1.x release works. The boundary
-test in core and a dedicated peer-range test in this package
-together ensure 0.3 does not silently sneak back in.
-
-If you're on TypeORM 0.3, stay on the previous
-`@nest-batch/nest-batch` package (pre-rename) or upgrade TypeORM
-first. There's no compatibility shim in this release.
-
----
+Korean: [README.ko.md](./README.ko.md)
 
 ## Install
 
 ```bash
-pnpm add @nest-batch/typeorm
+pnpm add @nest-batch/core @nest-batch/typeorm typeorm
 ```
 
-Peer dependencies the host must already provide:
-
-| Package            | Range         |
-| ------------------ | ------------- |
-| `@nest-batch/core` | `workspace:*` |
-| `typeorm`          | `^1.0.0`      |
+If your Nest application uses `@nestjs/typeorm`, keep using your normal
+`TypeOrmModule.forRoot` configuration.
 
-`typeorm` is a hard peer (declared in `peerDependencies` with
-`optional: false`). The `package.json` also lists it as a
-`devDependency` so the package's own test suite can resolve it
-without the host.
+## Public Imports
 
----
-
-## Schema ownership
-
-This package owns the same six batch meta tables as
-`@nest-batch/mikro-orm`:
-
-| Table                          | Purpose                                                                            |
-| ------------------------------ | ---------------------------------------------------------------------------------- |
-| `batch_job_instance`           | One row per logical job (unique on `job_name`+`job_key`).                          |
-| `batch_job_execution`          | One row per job run. Holds status, start/end, exit code/message.                   |
-| `batch_job_execution_params`   | Composite-keyed params (one row per param name).                                   |
-| `batch_step_execution`         | One row per step run. Holds step status, exit code/message, last-chunk checkpoint. |
-| `batch_job_execution_context`  | JSON checkpoint + execution context (job-scoped).                                  |
-| `batch_step_execution_context` | JSON checkpoint + execution context (step-scoped).                                 |
-
-The bundled migration lives at
-`src/migrations/1700000000000-CreateBatchMeta.ts` and is exported
-as `CreateBatchMeta1700000000000` from the package root. Apps that
-already have a TypeORM migration directory should copy the file in
-and renumber it to fit their own migration sequence.
-
-> **Note:** The six batch meta entities are also exported as a
-> single tuple under `batchMetaEntities` from the package root.
-> Because the adapter no longer bootstraps the `DataSource` (the
-> host owns the `TypeOrmModule.forRoot()` call), spreading
-> `batchMetaEntities` into your own `entities` array is the only
-> way the meta tables are registered with TypeORM's metadata
-> system. Forgetting the spread means `Repository<Entity>` lookups
-> for the meta tables fail silently and the repository throws at
-> first call.
-
-> The migration uses `datetime` (not `timestamptz`) on the SQLite
-> test driver and `timestamptz` on PostgreSQL production. The
-> entities declare `datetime` for portability, and the migration
-> handler emits the right per-driver type. This is intentional:
-> the test suite runs against `better-sqlite3` for speed, and the
-> production driver is PostgreSQL.
-
----
+```ts
+import {
+  BATCH_META_ENTITIES,
+  TypeOrmAdapter,
+  TypeOrmJobRepository,
+  TypeOrmTransactionManager,
+  batchMetaEntities,
+} from '@nest-batch/typeorm';
+```
 
 ## Wiring
 
-Wire the adapter with two imports in `AppModule.imports`: a host-
-owned `TypeOrmModule.forRoot()` call (which builds the
-`DataSource` and registers the meta entities) and a
-`TypeOrmAdapter.forRoot()` carrier passed to
-`NestBatchModule.forRoot({ adapters: { persistence, ... } })`.
-
-### Bring-your-own `DataSource` (recommended)
-
-If your app already uses `@nestjs/typeorm` (the typical case for a
-Nest app with user-domain entities), call
-`TypeOrmModule.forRoot()` yourself, spread `batchMetaEntities()`
-into its `entities` array, and pass the adapter's no-arg
-`TypeOrmAdapter.forRoot()` to `NestBatchModule.forRoot()` under
-`adapters.persistence`:
+Register the batch metadata entities in your host-owned TypeORM data source.
 
 ```ts
-import { Module } from '@nestjs/common';
 import { TypeOrmModule } from '@nestjs/typeorm';
-import { NestBatchModule } from '@nest-batch/core';
-import {
-  batchMetaEntities,
-  CreateBatchMeta1700000000000,
-  TypeOrmAdapter,
-} from '@nest-batch/typeorm';
-import { ProductEntity } from './entities/product.entity';
+import { InProcessAdapter, NestBatchModule } from '@nest-batch/core';
+import { BATCH_META_ENTITIES, TypeOrmAdapter } from '@nest-batch/typeorm';
 
 @Module({
   imports: [
     TypeOrmModule.forRoot({
       type: 'postgres',
-      host: '127.0.0.1',
-      port: 5434,
-      username: 'demo',
-      password: 'demo',
-      database: 'nest_batch_demo',
-      entities: [ProductEntity, ...batchMetaEntities()],
-      migrations: [CreateBatchMeta1700000000000 /* your other migrations */],
-      migrationsRun: true,
+      entities: [ProductEntity, ...BATCH_META_ENTITIES],
+      url: process.env.DATABASE_URL,
     }),
     NestBatchModule.forRoot({
-      adapters: { persistence: TypeOrmAdapter.forRoot() },
+      adapters: {
+        persistence: TypeOrmAdapter.forRoot(),
+        transport: InProcessAdapter.forRoot(),
+      },
     }),
   ],
 })
 export class AppModule {}
 ```
 
-`TypeOrmAdapter.forRoot()` takes no arguments on purpose. The host
-already owns the `TypeOrmModule.forRoot()` call; the adapter only
-declares its own provider and export surface. The
-`JOB_REPOSITORY_TOKEN` and `TRANSACTION_MANAGER_TOKEN` bindings are
-registered globally by the adapter, so you do **not** list
-`TypeOrmJobRepository` / `TypeOrmTransactionManager` in the
-`providers` array — they're already wired.
-
-> **Warning:** The adapter does **not** call `TypeOrmModule.forRoot()`
-> and does **not** create a `DataSource`. If you forget the
-> `TypeOrmModule.forRoot()` import, the app boots cleanly and the
-> batch module compiles, but the repository throws at first call
-> because `Repository<Entity>` resolution has nothing to bind to.
-> The two pieces are decoupled by design — the adapter is a
-> binding-only carrier, and the connection is the host's.
-
-> **Note:** `@nestjs/typeorm` defaults to `isGlobal: true`, which
-> is what the adapter assumes. Setting `isGlobal: false` breaks
-> `EntityManager` injection inside the adapter's own module: the
-> `DataSource` is registered on the host's `TypeOrmModule.forRoot()`
-> but the adapter module is `global: true`, so the `EntityManager`
-> token it needs is not exported across the boundary. Leave it at
-> the default unless you've wired an alternative.
-
-`forRootAsync` is the right call when the connection comes from a
-config service or a secret manager. Pass the standard `useFactory`
-plus `inject` list to `TypeOrmModule.forRootAsync()` and keep
-`TypeOrmAdapter.forRoot()` unchanged — the adapter doesn't care
-how the `DataSource` is built.
-
-### DataSource, not Connection
-
-TypeORM 1.0.0 calls it `DataSource`. The old `Connection` type is
-gone, and so is `getConnection()` / `getRepository()` on the
-connection. Every example in this README uses `DataSource`. If
-you're migrating from a 0.3 codebase, the rename touches every
-test file, every import, and every import path — there is no
-`@typeorm/0.3-compat` shim.
-
-The `TypeOrmTransactionManager` accepts a `DataSource` and uses
-`dataSource.transaction()` to start a real DB transaction. The
-callback receives a transactional `EntityManager`; use that one,
-not a globally-injected one, so all reads and writes are part of
-the same transaction.
-
----
-
-## DB-first semantics
-
-The repository is the durable source of truth for execution state.
-Same model as the MikroORM adapter, same invariants:
-
-1. **The DB is canonical.** A BullMQ job is a correlation stamp, not
-   a state row. The `JobExecution` row carries the actual
-   `status`, `startTime`, `endTime`, `exitCode`, and `exitMessage`.
-2. **Atomic launches are enforced by the row lock.** The
-   `createExecutionAtomic` flow uses a transactional
-   `SELECT ... FOR UPDATE SKIP LOCKED` (on PostgreSQL) to serialize
-   concurrent launches. Two callers racing to launch the same
-   `jobName + jobKey` get one winner; the loser sees a thrown
-   `JobExecutionAlreadyRunningError`.
-3. **Restart and checkpoint go through the DB.** `findLatestStepExecution`
-   returns the most recent `StepExecution` for `(jobExecutionId, stepName)`
-   regardless of status, so the executor can load the
-   last-committed chunk index from
-   `batch_step_execution_context` and resume from there.
-
-The contract suite is the same one `@nest-batch/mikro-orm` runs. If
-you change the repository or transaction manager, run the suite to
-confirm you haven't broken the contract.
-
----
-
-## What is NOT in this package
-
-- A TypeORM 0.3 adapter. Use 1.0.0 or stay on the previous package.
-- A Drizzle adapter. Drizzle is explicitly excluded from this
-  release. See `MIGRATION.md`.
-- A MikroORM adapter. Use `@nest-batch/mikro-orm` if you want
-  MikroORM 6; the two packages expose the same six-table schema.
-- A transport. Use `@nest-batch/bullmq` to wire BullMQ as the
-  execution strategy; the transport layer reads the same
-  `JobExecution` rows.
-- An admin UI, metrics, tracing, webhook, or job visualization
-  surface. Out of scope for the whole `@nest-batch/*` family.
-
----
-
-## Scripts
-
-```bash
-pnpm --filter @nest-batch/typeorm build      # SWC transpile + tsc declarations
-pnpm --filter @nest-batch/typeorm test       # vitest run (uses better-sqlite3 by default)
-pnpm --filter @nest-batch/typeorm test:watch # vitest watch
-pnpm --filter @nest-batch/typeorm typecheck  # tsc --noEmit
-```
-
-The contract suite runs against an in-memory SQLite database by
-default. The test driver is `better-sqlite3` because it gives
-sub-millisecond setup and teardown, and the contract tests are
-database-agnostic enough to not need a full PostgreSQL harness.
-For an end-to-end Postgres run, point the suite at your own
-`DataSource` via the documented test harness hook.
+Generate migrations in the application repository after adding the metadata
+entities.

package/dist/src/entities/job-meta.entities.d.ts

@@ -4,8 +4,8 @@
  * One row per logical job instance. Uniqueness is enforced on
  * (jobName, jobKey) so that the same canonical key resolves to the
  * same instance across restarts. The composite unique index is
- * declared on the entity and is also reified in the bundled
- * migration under the same name.
+ * declared on the entity so host-owned TypeORM migrations can
+ * generate the matching database constraint.
  */
 export declare class JobInstanceEntity {
     id: string;

package/dist/src/entities/job-meta.entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-meta.entities.d.ts","sourceRoot":"","sources":["../../../src/entities/job-meta.entities.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,qBAEa,iBAAiB;IAE5B,EAAE,EAAG,MAAM,CAAC;IAGZ,OAAO,EAAG,MAAM,CAAC;IAGjB,MAAM,EAAG,MAAM,CAAC;IAYhB,SAAS,EAAE,IAAI,CAAc;CAC9B;AAED;;;;;;;;GAQG;AACH,qBAEa,kBAAkB;IAE7B,EAAE,EAAG,MAAM,CAAC;IAGZ,aAAa,EAAG,MAAM,CAAC;IAGvB,MAAM,EAAG,MAAM,CAAC;IAGhB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAG9B,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAG5B,QAAQ,EAAG,MAAM,CAAC;IAGlB,WAAW,EAAG,MAAM,CAAC;IAErB;;;;;OAKG;IAEH,MAAM,EAAG,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,qBAEa,mBAAmB;IAE9B,EAAE,EAAG,MAAM,CAAC;IAGZ,cAAc,EAAG,MAAM,CAAC;IAGxB,QAAQ,EAAG,MAAM,CAAC;IAGlB,MAAM,EAAG,MAAM,CAAC;IAGhB,SAAS,EAAG,MAAM,CAAC;IAGnB,UAAU,EAAG,MAAM,CAAC;IAGpB,SAAS,EAAG,MAAM,CAAC;IAGnB,aAAa,EAAG,MAAM,CAAC;IAGvB,WAAW,EAAG,MAAM,CAAC;IAGrB,QAAQ,EAAG,MAAM,CAAC;IAGlB,WAAW,EAAG,MAAM,CAAC;IAOrB,SAAS,EAAE,IAAI,CAAc;CAC9B;AAED;;;;;GAKG;AACH,qBACa,yBAAyB;IAEpC,cAAc,EAAG,MAAM,CAAC;IAGxB,IAAI,EAAG,MAAM,CAAC;IAGd,OAAO,EAAG,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,qBACa,0BAA0B;IAErC,eAAe,EAAG,MAAM,CAAC;IAGzB,IAAI,EAAG,MAAM,CAAC;IAGd,OAAO,EAAG,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iKAMtB,CAAC"}
+{"version":3,"file":"job-meta.entities.d.ts","sourceRoot":"","sources":["../../../src/entities/job-meta.entities.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,qBAEa,iBAAiB;IAE5B,EAAE,EAAG,MAAM,CAAC;IAGZ,OAAO,EAAG,MAAM,CAAC;IAGjB,MAAM,EAAG,MAAM,CAAC;IAWhB,SAAS,EAAE,IAAI,CAAc;CAC9B;AAED;;;;;;;;GAQG;AACH,qBAEa,kBAAkB;IAE7B,EAAE,EAAG,MAAM,CAAC;IAGZ,aAAa,EAAG,MAAM,CAAC;IAGvB,MAAM,EAAG,MAAM,CAAC;IAGhB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAG9B,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAG5B,QAAQ,EAAG,MAAM,CAAC;IAGlB,WAAW,EAAG,MAAM,CAAC;IAErB;;;;;OAKG;IAEH,MAAM,EAAG,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,qBAEa,mBAAmB;IAE9B,EAAE,EAAG,MAAM,CAAC;IAGZ,cAAc,EAAG,MAAM,CAAC;IAGxB,QAAQ,EAAG,MAAM,CAAC;IAGlB,MAAM,EAAG,MAAM,CAAC;IAGhB,SAAS,EAAG,MAAM,CAAC;IAGnB,UAAU,EAAG,MAAM,CAAC;IAGpB,SAAS,EAAG,MAAM,CAAC;IAGnB,aAAa,EAAG,MAAM,CAAC;IAGvB,WAAW,EAAG,MAAM,CAAC;IAGrB,QAAQ,EAAG,MAAM,CAAC;IAGlB,WAAW,EAAG,MAAM,CAAC;IAOrB,SAAS,EAAE,IAAI,CAAc;CAC9B;AAED;;;;;GAKG;AACH,qBACa,yBAAyB;IAEpC,cAAc,EAAG,MAAM,CAAC;IAGxB,IAAI,EAAG,MAAM,CAAC;IAGd,OAAO,EAAG,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,qBACa,0BAA0B;IAErC,eAAe,EAAG,MAAM,CAAC;IAGzB,IAAI,EAAG,MAAM,CAAC;IAGd,OAAO,EAAG,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,iKAMtB,CAAC"}

package/dist/src/entities/job-meta.entities.js

@@ -71,10 +71,9 @@ _ts_decorate([
     (0, _typeorm.Column)({
         name: 'created_at',
         // `datetime` is portable across PostgreSQL and SQLite (the test
-        // driver). The bundled migration uses timestamptz on
-        // PostgreSQL by hand; SQLite loses the timezone qualifier,
-        // which is acceptable for a creation-time stamp that is never
-        // compared with sub-second precision in queries.
+        // driver). Hosts that generate PostgreSQL migrations can map the
+        // same logical column to timestamptz in their own migration
+        // pipeline.
         type: 'datetime',
         default: ()=>'CURRENT_TIMESTAMP'
     }),

package/dist/src/entities/job-meta.entities.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/entities/job-meta.entities.ts"],"sourcesContent":["import { Entity, PrimaryColumn, Column, Index } from 'typeorm';\n\n/**\n * `batch_job_instance` metadata row.\n *\n * One row per logical job instance. Uniqueness is enforced on\n * (jobName, jobKey) so that the same canonical key resolves to the\n * same instance across restarts. The composite unique index is\n * declared on the entity and is also reified in the bundled\n * migration under the same name.\n */\n@Entity('batch_job_instance')\n@Index('batch_job_instance_job_name_job_key_unique', ['jobName', 'jobKey'], { unique: true })\nexport class JobInstanceEntity {\n  @PrimaryColumn({ type: 'varchar', length: 255 })\n  id!: string;\n\n  @Column({ name: 'job_name', type: 'varchar', length: 255 })\n  jobName!: string;\n\n  @Column({ name: 'job_key', type: 'varchar', length: 255 })\n  jobKey!: string;\n\n  @Column({\n    name: 'created_at',\n    // `datetime` is portable across PostgreSQL and SQLite (the test\n    // driver). The bundled migration uses timestamptz on\n    // PostgreSQL by hand; SQLite loses the timezone qualifier,\n    // which is acceptable for a creation-time stamp that is never\n    // compared with sub-second precision in queries.\n    type: 'datetime',\n    default: () => 'CURRENT_TIMESTAMP',\n  })\n  createdAt: Date = new Date();\n}\n\n/**\n * `batch_job_execution` metadata row.\n *\n * One row per job run. `status` is the stringified JobStatus enum\n * (kept as a plain varchar — TypeORM enum support varies across\n * drivers and v1.0.0 dropped a few columns we don't need). The\n * `jobInstanceId` column is indexed because every contract lookup\n * (\"is this instance running?\") scans by it.\n */\n@Entity('batch_job_execution')\n@Index('batch_job_execution_job_instance_id_index', ['jobInstanceId'])\nexport class JobExecutionEntity {\n  @PrimaryColumn({ type: 'varchar', length: 255 })\n  id!: string;\n\n  @Column({ name: 'job_instance_id', type: 'varchar', length: 255 })\n  jobInstanceId!: string;\n\n  @Column({ type: 'varchar', length: 20 })\n  status!: string;\n\n  @Column({ name: 'start_time', type: 'datetime', nullable: true })\n  startTime: Date | null = null;\n\n  @Column({ name: 'end_time', type: 'datetime', nullable: true })\n  endTime: Date | null = null;\n\n  @Column({ name: 'exit_code', type: 'varchar', length: 255, default: '' })\n  exitCode!: string;\n\n  @Column({ name: 'exit_message', type: 'text', default: '' })\n  exitMessage!: string;\n\n  /**\n   * JSON-serialized `JobParameters` snapshot. Stored as `text` (not\n   * native `jsonb`) so the adapter works uniformly across SQLite (used\n   * in unit tests) and PostgreSQL/MySQL — the column is always a\n   * serialized payload, never queried by the ORM.\n   */\n  @Column({ name: 'params', type: 'text', default: '{}' })\n  params!: string;\n}\n\n/**\n * `batch_step_execution` metadata row.\n *\n * One row per step run. Counters default to 0 so the entity can\n * be persisted immediately upon creation, before any items are\n * processed. `createdAt` is stamped on insert and used by\n * `findLatestStepExecution` to resolve the most recently created\n * step for a given `(jobExecutionId, stepName)` pair — a v4 UUID\n * primary key does not preserve insertion order, so an explicit\n * monotonic column is required.\n */\n@Entity('batch_step_execution')\n@Index('batch_step_execution_job_execution_id_index', ['jobExecutionId'])\nexport class StepExecutionEntity {\n  @PrimaryColumn({ type: 'varchar', length: 255 })\n  id!: string;\n\n  @Column({ name: 'job_execution_id', type: 'varchar', length: 255 })\n  jobExecutionId!: string;\n\n  @Column({ name: 'step_name', type: 'varchar', length: 255 })\n  stepName!: string;\n\n  @Column({ type: 'varchar', length: 20 })\n  status!: string;\n\n  @Column({ name: 'read_count', type: 'int', default: 0 })\n  readCount!: number;\n\n  @Column({ name: 'write_count', type: 'int', default: 0 })\n  writeCount!: number;\n\n  @Column({ name: 'skip_count', type: 'int', default: 0 })\n  skipCount!: number;\n\n  @Column({ name: 'rollback_count', type: 'int', default: 0 })\n  rollbackCount!: number;\n\n  @Column({ name: 'commit_count', type: 'int', default: 0 })\n  commitCount!: number;\n\n  @Column({ name: 'exit_code', type: 'varchar', length: 255, default: '' })\n  exitCode!: string;\n\n  @Column({ name: 'exit_message', type: 'text', default: '' })\n  exitMessage!: string;\n\n  @Column({\n    name: 'created_at',\n    type: 'datetime',\n    default: () => 'CURRENT_TIMESTAMP',\n  })\n  createdAt: Date = new Date();\n}\n\n/**\n * `batch_job_execution_context` metadata row.\n *\n * `data` is a JSON-serialized ExecutionContext payload. `version`\n * guards against lost updates during concurrent writers.\n */\n@Entity('batch_job_execution_context')\nexport class JobExecutionContextEntity {\n  @PrimaryColumn({ name: 'job_execution_id', type: 'varchar', length: 255 })\n  jobExecutionId!: string;\n\n  @Column({ type: 'text' })\n  data!: string;\n\n  @Column({ type: 'int', default: 0 })\n  version!: number;\n}\n\n/**\n * `batch_step_execution_context` metadata row.\n *\n * Mirrors the job-level context table but scoped to a single\n * step execution. There is intentionally no params sibling table\n * for steps — step parameters are derivable from the parent job\n * execution params + the step execution context.\n */\n@Entity('batch_step_execution_context')\nexport class StepExecutionContextEntity {\n  @PrimaryColumn({ name: 'step_execution_id', type: 'varchar', length: 255 })\n  stepExecutionId!: string;\n\n  @Column({ type: 'text' })\n  data!: string;\n\n  @Column({ type: 'int', default: 0 })\n  version!: number;\n}\n\n/**\n * All batch meta entities owned by this package. Hand to\n * `DataSource#entityMetadatas` (or `entities:`) so TypeORM\n * discovers them through the standard decorator scan.\n */\nexport const BATCH_META_ENTITIES = [\n  JobInstanceEntity,\n  JobExecutionEntity,\n  StepExecutionEntity,\n  JobExecutionContextEntity,\n  StepExecutionContextEntity,\n] as const;\n"],"names":["BATCH_META_ENTITIES","JobExecutionContextEntity","JobExecutionEntity","JobInstanceEntity","StepExecutionContextEntity","StepExecutionEntity","id","jobName","jobKey","createdAt","Date","type","length","name","default","unique","jobInstanceId","status","startTime","endTime","exitCode","exitMessage","params","nullable","jobExecutionId","stepName","readCount","writeCount","skipCount","rollbackCount","commitCount","data","version","stepExecutionId"],"mappings":";;;;;;;;;;;QAiLaA;eAAAA;;QApCAC;eAAAA;;QA9FAC;eAAAA;;QAlCAC;eAAAA;;QAoJAC;eAAAA;;QArEAC;eAAAA;;;yBA5FwC;;;;;;;;;;AAa9C,IAAA,AAAMF,oBAAN,MAAMA;IAEXG,GAAY;IAGZC,QAAiB;IAGjBC,OAAgB;IAYhBC,YAAkB,IAAIC,OAAO;AAC/B;;;QApBmBC,MAAM;QAAWC,QAAQ;;;;;;QAGhCC,MAAM;QAAYF,MAAM;QAAWC,QAAQ;;;;;;QAG3CC,MAAM;QAAWF,MAAM;QAAWC,QAAQ;;;;;;QAIlDC,MAAM;QACN,gEAAgE;QAChE,qDAAqD;QACrD,2DAA2D;QAC3D,8DAA8D;QAC9D,iDAAiD;QACjDF,MAAM;QACNG,SAAS,IAAM;;;;;;;QAnBmC;QAAW;;QAAaC,QAAQ;;;AAmC/E,IAAA,AAAMb,qBAAN,MAAMA;IAEXI,GAAY;IAGZU,cAAuB;IAGvBC,OAAgB;IAGhBC,YAAyB,KAAK;IAG9BC,UAAuB,KAAK;IAG5BC,SAAkB;IAGlBC,YAAqB;IAErB;;;;;GAKC,GACD,AACAC,OAAgB;AAClB;;;QA7BmBX,MAAM;QAAWC,QAAQ;;;;;;QAGhCC,MAAM;QAAmBF,MAAM;QAAWC,QAAQ;;;;;;QAGlDD,MAAM;QAAWC,QAAQ;;;;;;QAGzBC,MAAM;QAAcF,MAAM;QAAYY,UAAU;;;;;;QAGhDV,MAAM;QAAYF,MAAM;QAAYY,UAAU;;;;;;QAG9CV,MAAM;QAAaF,MAAM;QAAWC,QAAQ;QAAKE,SAAS;;;;;;QAG1DD,MAAM;QAAgBF,MAAM;QAAQG,SAAS;;;;;;QAS7CD,MAAM;QAAUF,MAAM;QAAQG,SAAS;;;;;;;QA7BE;;;AA8C9C,IAAA,AAAMT,sBAAN,MAAMA;IAEXC,GAAY;IAGZkB,eAAwB;IAGxBC,SAAkB;IAGlBR,OAAgB;IAGhBS,UAAmB;IAGnBC,WAAoB;IAGpBC,UAAmB;IAGnBC,cAAuB;IAGvBC,YAAqB;IAGrBV,SAAkB;IAGlBC,YAAqB;IAOrBZ,YAAkB,IAAIC,OAAO;AAC/B;;;QAvCmBC,MAAM;QAAWC,QAAQ;;;;;;QAGhCC,MAAM;QAAoBF,MAAM;QAAWC,QAAQ;;;;;;QAGnDC,MAAM;QAAaF,MAAM;QAAWC,QAAQ;;;;;;QAG5CD,MAAM;QAAWC,QAAQ;;;;;;QAGzBC,MAAM;QAAcF,MAAM;QAAOG,SAAS;;;;;;QAG1CD,MAAM;QAAeF,MAAM;QAAOG,SAAS;;;;;;QAG3CD,MAAM;QAAcF,MAAM;QAAOG,SAAS;;;;;;QAG1CD,MAAM;QAAkBF,MAAM;QAAOG,SAAS;;;;;;QAG9CD,MAAM;QAAgBF,MAAM;QAAOG,SAAS;;;;;;QAG5CD,MAAM;QAAaF,MAAM;QAAWC,QAAQ;QAAKE,SAAS;;;;;;QAG1DD,MAAM;QAAgBF,MAAM;QAAQG,SAAS;;;;;;QAIrDD,MAAM;QACNF,MAAM;QACNG,SAAS,IAAM;;;;;;;QAtCoC;;;AAkDhD,IAAA,AAAMb,4BAAN,MAAMA;IAEXuB,eAAwB;IAGxBO,KAAc;IAGdC,QAAiB;AACnB;;;QARmBnB,MAAM;QAAoBF,MAAM;QAAWC,QAAQ;;;;;;QAG1DD,MAAM;;;;;;QAGNA,MAAM;QAAOG,SAAS;;;;;;;AAa3B,IAAA,AAAMV,6BAAN,MAAMA;IAEX6B,gBAAyB;IAGzBF,KAAc;IAGdC,QAAiB;AACnB;;;QARmBnB,MAAM;QAAqBF,MAAM;QAAWC,QAAQ;;;;;;QAG3DD,MAAM;;;;;;QAGNA,MAAM;QAAOG,SAAS;;;;;;;AAS3B,MAAMd,sBAAsB;IACjCG;IACAD;IACAG;IACAJ;IACAG;CACD"}
+{"version":3,"sources":["../../../src/entities/job-meta.entities.ts"],"sourcesContent":["import { Entity, PrimaryColumn, Column, Index } from 'typeorm';\n\n/**\n * `batch_job_instance` metadata row.\n *\n * One row per logical job instance. Uniqueness is enforced on\n * (jobName, jobKey) so that the same canonical key resolves to the\n * same instance across restarts. The composite unique index is\n * declared on the entity so host-owned TypeORM migrations can\n * generate the matching database constraint.\n */\n@Entity('batch_job_instance')\n@Index('batch_job_instance_job_name_job_key_unique', ['jobName', 'jobKey'], { unique: true })\nexport class JobInstanceEntity {\n  @PrimaryColumn({ type: 'varchar', length: 255 })\n  id!: string;\n\n  @Column({ name: 'job_name', type: 'varchar', length: 255 })\n  jobName!: string;\n\n  @Column({ name: 'job_key', type: 'varchar', length: 255 })\n  jobKey!: string;\n\n  @Column({\n    name: 'created_at',\n    // `datetime` is portable across PostgreSQL and SQLite (the test\n    // driver). Hosts that generate PostgreSQL migrations can map the\n    // same logical column to timestamptz in their own migration\n    // pipeline.\n    type: 'datetime',\n    default: () => 'CURRENT_TIMESTAMP',\n  })\n  createdAt: Date = new Date();\n}\n\n/**\n * `batch_job_execution` metadata row.\n *\n * One row per job run. `status` is the stringified JobStatus enum\n * (kept as a plain varchar — TypeORM enum support varies across\n * drivers and v1.0.0 dropped a few columns we don't need). The\n * `jobInstanceId` column is indexed because every contract lookup\n * (\"is this instance running?\") scans by it.\n */\n@Entity('batch_job_execution')\n@Index('batch_job_execution_job_instance_id_index', ['jobInstanceId'])\nexport class JobExecutionEntity {\n  @PrimaryColumn({ type: 'varchar', length: 255 })\n  id!: string;\n\n  @Column({ name: 'job_instance_id', type: 'varchar', length: 255 })\n  jobInstanceId!: string;\n\n  @Column({ type: 'varchar', length: 20 })\n  status!: string;\n\n  @Column({ name: 'start_time', type: 'datetime', nullable: true })\n  startTime: Date | null = null;\n\n  @Column({ name: 'end_time', type: 'datetime', nullable: true })\n  endTime: Date | null = null;\n\n  @Column({ name: 'exit_code', type: 'varchar', length: 255, default: '' })\n  exitCode!: string;\n\n  @Column({ name: 'exit_message', type: 'text', default: '' })\n  exitMessage!: string;\n\n  /**\n   * JSON-serialized `JobParameters` snapshot. Stored as `text` (not\n   * native `jsonb`) so the adapter works uniformly across SQLite (used\n   * in unit tests) and PostgreSQL/MySQL — the column is always a\n   * serialized payload, never queried by the ORM.\n   */\n  @Column({ name: 'params', type: 'text', default: '{}' })\n  params!: string;\n}\n\n/**\n * `batch_step_execution` metadata row.\n *\n * One row per step run. Counters default to 0 so the entity can\n * be persisted immediately upon creation, before any items are\n * processed. `createdAt` is stamped on insert and used by\n * `findLatestStepExecution` to resolve the most recently created\n * step for a given `(jobExecutionId, stepName)` pair — a v4 UUID\n * primary key does not preserve insertion order, so an explicit\n * monotonic column is required.\n */\n@Entity('batch_step_execution')\n@Index('batch_step_execution_job_execution_id_index', ['jobExecutionId'])\nexport class StepExecutionEntity {\n  @PrimaryColumn({ type: 'varchar', length: 255 })\n  id!: string;\n\n  @Column({ name: 'job_execution_id', type: 'varchar', length: 255 })\n  jobExecutionId!: string;\n\n  @Column({ name: 'step_name', type: 'varchar', length: 255 })\n  stepName!: string;\n\n  @Column({ type: 'varchar', length: 20 })\n  status!: string;\n\n  @Column({ name: 'read_count', type: 'int', default: 0 })\n  readCount!: number;\n\n  @Column({ name: 'write_count', type: 'int', default: 0 })\n  writeCount!: number;\n\n  @Column({ name: 'skip_count', type: 'int', default: 0 })\n  skipCount!: number;\n\n  @Column({ name: 'rollback_count', type: 'int', default: 0 })\n  rollbackCount!: number;\n\n  @Column({ name: 'commit_count', type: 'int', default: 0 })\n  commitCount!: number;\n\n  @Column({ name: 'exit_code', type: 'varchar', length: 255, default: '' })\n  exitCode!: string;\n\n  @Column({ name: 'exit_message', type: 'text', default: '' })\n  exitMessage!: string;\n\n  @Column({\n    name: 'created_at',\n    type: 'datetime',\n    default: () => 'CURRENT_TIMESTAMP',\n  })\n  createdAt: Date = new Date();\n}\n\n/**\n * `batch_job_execution_context` metadata row.\n *\n * `data` is a JSON-serialized ExecutionContext payload. `version`\n * guards against lost updates during concurrent writers.\n */\n@Entity('batch_job_execution_context')\nexport class JobExecutionContextEntity {\n  @PrimaryColumn({ name: 'job_execution_id', type: 'varchar', length: 255 })\n  jobExecutionId!: string;\n\n  @Column({ type: 'text' })\n  data!: string;\n\n  @Column({ type: 'int', default: 0 })\n  version!: number;\n}\n\n/**\n * `batch_step_execution_context` metadata row.\n *\n * Mirrors the job-level context table but scoped to a single\n * step execution. There is intentionally no params sibling table\n * for steps — step parameters are derivable from the parent job\n * execution params + the step execution context.\n */\n@Entity('batch_step_execution_context')\nexport class StepExecutionContextEntity {\n  @PrimaryColumn({ name: 'step_execution_id', type: 'varchar', length: 255 })\n  stepExecutionId!: string;\n\n  @Column({ type: 'text' })\n  data!: string;\n\n  @Column({ type: 'int', default: 0 })\n  version!: number;\n}\n\n/**\n * All batch meta entities owned by this package. Hand to\n * `DataSource#entityMetadatas` (or `entities:`) so TypeORM\n * discovers them through the standard decorator scan.\n */\nexport const BATCH_META_ENTITIES = [\n  JobInstanceEntity,\n  JobExecutionEntity,\n  StepExecutionEntity,\n  JobExecutionContextEntity,\n  StepExecutionContextEntity,\n] as const;\n"],"names":["BATCH_META_ENTITIES","JobExecutionContextEntity","JobExecutionEntity","JobInstanceEntity","StepExecutionContextEntity","StepExecutionEntity","id","jobName","jobKey","createdAt","Date","type","length","name","default","unique","jobInstanceId","status","startTime","endTime","exitCode","exitMessage","params","nullable","jobExecutionId","stepName","readCount","writeCount","skipCount","rollbackCount","commitCount","data","version","stepExecutionId"],"mappings":";;;;;;;;;;;QAgLaA;eAAAA;;QApCAC;eAAAA;;QA9FAC;eAAAA;;QAjCAC;eAAAA;;QAmJAC;eAAAA;;QArEAC;eAAAA;;;yBA3FwC;;;;;;;;;;AAa9C,IAAA,AAAMF,oBAAN,MAAMA;IAEXG,GAAY;IAGZC,QAAiB;IAGjBC,OAAgB;IAWhBC,YAAkB,IAAIC,OAAO;AAC/B;;;QAnBmBC,MAAM;QAAWC,QAAQ;;;;;;QAGhCC,MAAM;QAAYF,MAAM;QAAWC,QAAQ;;;;;;QAG3CC,MAAM;QAAWF,MAAM;QAAWC,QAAQ;;;;;;QAIlDC,MAAM;QACN,gEAAgE;QAChE,iEAAiE;QACjE,4DAA4D;QAC5D,YAAY;QACZF,MAAM;QACNG,SAAS,IAAM;;;;;;;QAlBmC;QAAW;;QAAaC,QAAQ;;;AAkC/E,IAAA,AAAMb,qBAAN,MAAMA;IAEXI,GAAY;IAGZU,cAAuB;IAGvBC,OAAgB;IAGhBC,YAAyB,KAAK;IAG9BC,UAAuB,KAAK;IAG5BC,SAAkB;IAGlBC,YAAqB;IAErB;;;;;GAKC,GACD,AACAC,OAAgB;AAClB;;;QA7BmBX,MAAM;QAAWC,QAAQ;;;;;;QAGhCC,MAAM;QAAmBF,MAAM;QAAWC,QAAQ;;;;;;QAGlDD,MAAM;QAAWC,QAAQ;;;;;;QAGzBC,MAAM;QAAcF,MAAM;QAAYY,UAAU;;;;;;QAGhDV,MAAM;QAAYF,MAAM;QAAYY,UAAU;;;;;;QAG9CV,MAAM;QAAaF,MAAM;QAAWC,QAAQ;QAAKE,SAAS;;;;;;QAG1DD,MAAM;QAAgBF,MAAM;QAAQG,SAAS;;;;;;QAS7CD,MAAM;QAAUF,MAAM;QAAQG,SAAS;;;;;;;QA7BE;;;AA8C9C,IAAA,AAAMT,sBAAN,MAAMA;IAEXC,GAAY;IAGZkB,eAAwB;IAGxBC,SAAkB;IAGlBR,OAAgB;IAGhBS,UAAmB;IAGnBC,WAAoB;IAGpBC,UAAmB;IAGnBC,cAAuB;IAGvBC,YAAqB;IAGrBV,SAAkB;IAGlBC,YAAqB;IAOrBZ,YAAkB,IAAIC,OAAO;AAC/B;;;QAvCmBC,MAAM;QAAWC,QAAQ;;;;;;QAGhCC,MAAM;QAAoBF,MAAM;QAAWC,QAAQ;;;;;;QAGnDC,MAAM;QAAaF,MAAM;QAAWC,QAAQ;;;;;;QAG5CD,MAAM;QAAWC,QAAQ;;;;;;QAGzBC,MAAM;QAAcF,MAAM;QAAOG,SAAS;;;;;;QAG1CD,MAAM;QAAeF,MAAM;QAAOG,SAAS;;;;;;QAG3CD,MAAM;QAAcF,MAAM;QAAOG,SAAS;;;;;;QAG1CD,MAAM;QAAkBF,MAAM;QAAOG,SAAS;;;;;;QAG9CD,MAAM;QAAgBF,MAAM;QAAOG,SAAS;;;;;;QAG5CD,MAAM;QAAaF,MAAM;QAAWC,QAAQ;QAAKE,SAAS;;;;;;QAG1DD,MAAM;QAAgBF,MAAM;QAAQG,SAAS;;;;;;QAIrDD,MAAM;QACNF,MAAM;QACNG,SAAS,IAAM;;;;;;;QAtCoC;;;AAkDhD,IAAA,AAAMb,4BAAN,MAAMA;IAEXuB,eAAwB;IAGxBO,KAAc;IAGdC,QAAiB;AACnB;;;QARmBnB,MAAM;QAAoBF,MAAM;QAAWC,QAAQ;;;;;;QAG1DD,MAAM;;;;;;QAGNA,MAAM;QAAOG,SAAS;;;;;;;AAa3B,IAAA,AAAMV,6BAAN,MAAMA;IAEX6B,gBAAyB;IAGzBF,KAAc;IAGdC,QAAiB;AACnB;;;QARmBnB,MAAM;QAAqBF,MAAM;QAAWC,QAAQ;;;;;;QAG3DD,MAAM;;;;;;QAGNA,MAAM;QAAOG,SAAS;;;;;;;AAS3B,MAAMd,sBAAsB;IACjCG;IACAD;IACAG;IACAJ;IACAG;CACD"}

package/dist/src/index.d.ts

@@ -1,6 +1,9 @@
+import { BATCH_META_ENTITIES } from './entities';
 export { TypeOrmJobRepository } from './repository/typeorm-job-repository';
 export type { TypeOrmTransactionContext } from './transaction/typeorm-transaction-manager';
 export { TypeOrmTransactionManager } from './transaction/typeorm-transaction-manager';
 export * from './adapters';
+export { BATCH_META_ENTITIES } from './entities';
 export * from './typeorm.driver-provider';
+export declare const batchMetaEntities: () => typeof BATCH_META_ENTITIES;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,YAAY,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,YAAY,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAE1C,eAAO,MAAM,iBAAiB,QAAO,OAAO,mBAA0C,CAAC"}

package/dist/src/index.js

@@ -29,12 +29,11 @@
 //     },
 //   });
 //
-// The original `batchMetaEntities()` factory and the bundled
-// `CreateBatchMeta1700000000000` migration moved to
-// `@nest-batch/postgresql/src/migrations/`. The driver sibling owns
-// the TypeORM-specific entity classes and the migration scripts;
-// this package owns only the repository / transaction manager
-// shape and the driver-provider token.
+// The TypeORM entity tuple stays in this package because it is the
+// schema contract consumed by a host-owned TypeORM DataSource. Apps
+// generate and own their runnable migration files in their own
+// migration workflow. Driver siblings bind the
+// `TypeOrmDriverProvider` token to a concrete database connection.
 "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
@@ -46,13 +45,20 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    get BATCH_META_ENTITIES () {
+        return _entities.BATCH_META_ENTITIES;
+    },
     get TypeOrmJobRepository () {
         return _typeormjobrepository.TypeOrmJobRepository;
     },
     get TypeOrmTransactionManager () {
         return _typeormtransactionmanager.TypeOrmTransactionManager;
+    },
+    get batchMetaEntities () {
+        return batchMetaEntities;
     }
 });
+const _entities = require("./entities");
 const _typeormjobrepository = require("./repository/typeorm-job-repository");
 const _typeormtransactionmanager = require("./transaction/typeorm-transaction-manager");
 _export_star(require("./adapters"), exports);
@@ -70,5 +76,6 @@ function _export_star(from, to) {
     });
     return from;
 }
+const batchMetaEntities = ()=>_entities.BATCH_META_ENTITIES;
 
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["// Public API barrel for @nest-batch/typeorm.\n//\n// The package is a **driver-agnostic adapter SLOT**. It owns the\n// `TypeOrmAdapter` factory, the `TypeOrmJobRepository` /\n// `TypeOrmTransactionManager` interface shape, and the\n// `TypeOrmDriverProvider` injection token. It does NOT import\n// `@nestjs/typeorm` (which carries the Postgres driver) — the\n// driver implementation lives in the `@nest-batch/postgresql` (or\n// `@nest-batch/mysql`) sibling package, which binds the\n// `TypeOrmDriverProvider` token to the concrete `DataSource`\n// in its own `forRoot()` factory.\n//\n// Apps wire the persistence concern into `NestBatchModule.forRoot()`\n// via the new `BatchAdapter` factory pattern:\n//\n//   import { NestBatchModule, InProcessAdapter } from '@nest-batch/core';\n//   import { TypeOrmAdapter } from '@nest-batch/typeorm';\n//   import { PostgresAdapter } from '@nest-batch/postgresql';\n//\n//   // The host must also call\n//   // `TypeOrmModule.forRoot({ ... })` in their `AppModule.imports`.\n//   // The PostgresAdapter.forRoot() factory binds the\n//   // TypeOrmDriverProvider token to the host's DataSource.\n//\n//   NestBatchModule.forRoot({\n//     adapters: {\n//       persistence: PostgresAdapter.forRoot(),\n//       transport: InProcessAdapter.forRoot(),\n//     },\n//   });\n//\n// The original `batchMetaEntities()` factory and the bundled\n// `CreateBatchMeta1700000000000` migration moved to\n// `@nest-batch/postgresql/src/migrations/`. The driver sibling owns\n// the TypeORM-specific entity classes and the migration scripts;\n// this package owns only the repository / transaction manager\n// shape and the driver-provider token.\nexport { TypeOrmJobRepository } from './repository/typeorm-job-repository';\nexport type { TypeOrmTransactionContext } from './transaction/typeorm-transaction-manager';\nexport { TypeOrmTransactionManager } from './transaction/typeorm-transaction-manager';\nexport * from './adapters';\nexport * from './typeorm.driver-provider';\n"],"names":["TypeOrmJobRepository","TypeOrmTransactionManager"],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,iEAAiE;AACjE,yDAAyD;AACzD,uDAAuD;AACvD,8DAA8D;AAC9D,8DAA8D;AAC9D,kEAAkE;AAClE,wDAAwD;AACxD,6DAA6D;AAC7D,kCAAkC;AAClC,EAAE;AACF,qEAAqE;AACrE,8CAA8C;AAC9C,EAAE;AACF,0EAA0E;AAC1E,0DAA0D;AAC1D,8DAA8D;AAC9D,EAAE;AACF,+BAA+B;AAC/B,sEAAsE;AACtE,uDAAuD;AACvD,6DAA6D;AAC7D,EAAE;AACF,8BAA8B;AAC9B,kBAAkB;AAClB,gDAAgD;AAChD,+CAA+C;AAC/C,SAAS;AACT,QAAQ;AACR,EAAE;AACF,6DAA6D;AAC7D,oDAAoD;AACpD,oEAAoE;AACpE,iEAAiE;AACjE,8DAA8D;AAC9D,uCAAuC;;;;;;;;;;;;QAC9BA;eAAAA,0CAAoB;;QAEpBC;eAAAA,oDAAyB;;;sCAFG;2CAEK;qBAC5B;qBACA"}
+{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["// Public API barrel for @nest-batch/typeorm.\n//\n// The package is a **driver-agnostic adapter SLOT**. It owns the\n// `TypeOrmAdapter` factory, the `TypeOrmJobRepository` /\n// `TypeOrmTransactionManager` interface shape, and the\n// `TypeOrmDriverProvider` injection token. It does NOT import\n// `@nestjs/typeorm` (which carries the Postgres driver) — the\n// driver implementation lives in the `@nest-batch/postgresql` (or\n// `@nest-batch/mysql`) sibling package, which binds the\n// `TypeOrmDriverProvider` token to the concrete `DataSource`\n// in its own `forRoot()` factory.\n//\n// Apps wire the persistence concern into `NestBatchModule.forRoot()`\n// via the new `BatchAdapter` factory pattern:\n//\n//   import { NestBatchModule, InProcessAdapter } from '@nest-batch/core';\n//   import { TypeOrmAdapter } from '@nest-batch/typeorm';\n//   import { PostgresAdapter } from '@nest-batch/postgresql';\n//\n//   // The host must also call\n//   // `TypeOrmModule.forRoot({ ... })` in their `AppModule.imports`.\n//   // The PostgresAdapter.forRoot() factory binds the\n//   // TypeOrmDriverProvider token to the host's DataSource.\n//\n//   NestBatchModule.forRoot({\n//     adapters: {\n//       persistence: PostgresAdapter.forRoot(),\n//       transport: InProcessAdapter.forRoot(),\n//     },\n//   });\n//\n// The TypeORM entity tuple stays in this package because it is the\n// schema contract consumed by a host-owned TypeORM DataSource. Apps\n// generate and own their runnable migration files in their own\n// migration workflow. Driver siblings bind the\n// `TypeOrmDriverProvider` token to a concrete database connection.\nimport { BATCH_META_ENTITIES } from './entities';\n\nexport { TypeOrmJobRepository } from './repository/typeorm-job-repository';\nexport type { TypeOrmTransactionContext } from './transaction/typeorm-transaction-manager';\nexport { TypeOrmTransactionManager } from './transaction/typeorm-transaction-manager';\nexport * from './adapters';\nexport { BATCH_META_ENTITIES } from './entities';\nexport * from './typeorm.driver-provider';\n\nexport const batchMetaEntities = (): typeof BATCH_META_ENTITIES => BATCH_META_ENTITIES;\n"],"names":["BATCH_META_ENTITIES","TypeOrmJobRepository","TypeOrmTransactionManager","batchMetaEntities"],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,iEAAiE;AACjE,yDAAyD;AACzD,uDAAuD;AACvD,8DAA8D;AAC9D,8DAA8D;AAC9D,kEAAkE;AAClE,wDAAwD;AACxD,6DAA6D;AAC7D,kCAAkC;AAClC,EAAE;AACF,qEAAqE;AACrE,8CAA8C;AAC9C,EAAE;AACF,0EAA0E;AAC1E,0DAA0D;AAC1D,8DAA8D;AAC9D,EAAE;AACF,+BAA+B;AAC/B,sEAAsE;AACtE,uDAAuD;AACvD,6DAA6D;AAC7D,EAAE;AACF,8BAA8B;AAC9B,kBAAkB;AAClB,gDAAgD;AAChD,+CAA+C;AAC/C,SAAS;AACT,QAAQ;AACR,EAAE;AACF,mEAAmE;AACnE,oEAAoE;AACpE,+DAA+D;AAC/D,+CAA+C;AAC/C,mEAAmE;;;;;;;;;;;;QAO1DA;eAAAA,6BAAmB;;QAJnBC;eAAAA,0CAAoB;;QAEpBC;eAAAA,oDAAyB;;QAKrBC;eAAAA;;;0BATuB;sCAEC;2CAEK;qBAC5B;qBAEA;;;;;;;;;;;;;;AAEP,MAAMA,oBAAoB,IAAkCH,6BAAmB"}

package/dist/src/repository/typeorm-job-repository.d.ts

@@ -8,8 +8,8 @@ import type { JobInstance, JobExecution, JobExecutionPatch, JobParameters, StepE
  * provided by the `@nest-batch/postgresql` (or future
  * `@nest-batch/mysql`) driver sibling via the `TypeOrmDriverProvider`
  * token. The repository itself uses raw SQL via `EntityManager.query`
- * so the column-shape contract is owned by the driver sibling
- * (the bundled 6-table migration).
+ * against the table contract represented by this package's exported
+ * TypeORM entities. The consuming app owns the runnable migration.
  *
  * The contract guarantees:
  *   - `getOrCreateJobInstance` is race-safe via the (jobName, jobKey)

package/dist/src/repository/typeorm-job-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeorm-job-repository.d.ts","sourceRoot":"","sources":["../../../src/repository/typeorm-job-repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAqB,MAAM,SAAS,CAAC;AACxD,OAAO,EACL,aAAa,EAOd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAyG1B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,oBAAqB,SAAQ,aAAa;IAEpB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAKxE,OAAO,CAAC,EAAE;IAIJ,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsC1E,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,CAAC;IAoBlB,qBAAqB,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,CAAC;IA6DlB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IASzD,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAWlE,gBAAgB,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsBxE,iBAAiB,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgCpF,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAY3E,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;IAWnB,mBAAmB,CACvB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC;IAoBV,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAS/D,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWnF;;;;;;;;OAQG;IACG,uBAAuB,CAC3B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAY1B,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BrE,oBAAoB,CACxB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;CA0CjB"}
+{"version":3,"file":"typeorm-job-repository.d.ts","sourceRoot":"","sources":["../../../src/repository/typeorm-job-repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAqB,MAAM,SAAS,CAAC;AACxD,OAAO,EACL,aAAa,EAOd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AA6G1B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,oBAAqB,SAAQ,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU;IAIlF,OAAO,CAAC,EAAE;IAIJ,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsC1E,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBvF,qBAAqB,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,CAAC;IA6DlB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgChF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IASzD,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAWlE,gBAAgB,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsBxE,iBAAiB,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgCpF,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAY3E,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAWrF,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CtF,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAS/D,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWnF;;;;;;;;OAQG;IACG,uBAAuB,CAC3B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAY1B,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BrE,oBAAoB,CACxB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;CA4CjB"}