@nestjs-transactional/outbox-typeorm 1.0.0-alpha.0

package/dist/repository/typeorm-event-publication.repository.d.ts

@@ -0,0 +1,50 @@
+import { PublicationStatus, type EventPublication, type EventPublicationRepository, type FindCompletedOptions, type FindFailedOptions, type NewEventPublication, type UpdateStatusOptions } from '@nestjs-transactional/outbox';
+import { type DataSource } from 'typeorm';
+/**
+ * TypeORM-backed implementation of
+ * {@link EventPublicationRepository}. Reads and writes go through the
+ * {@link EntityManager} bound to the ambient transaction (via
+ * `@nestjs-transactional/core`'s `AsyncLocalStorage`), so publication
+ * rows commit atomically with the business data.
+ *
+ * `findReadyForProcessing` returns ready rows in publication-date
+ * order WITHOUT per-row locking. The earlier design used
+ * `SELECT ... FOR UPDATE SKIP LOCKED` to give concurrent workers
+ * disjoint row sets; that approach was dropped because pessimistic
+ * locks require an enclosing transaction whose lifetime did not fit
+ * the worker's `find → tryClaim → invoke → finalize` flow (a
+ * transaction wide enough to hold the lock would have to wrap the
+ * listener invocation, which is unsafe for long-running listeners).
+ * Concurrent workers may now SEE the same rows; correctness comes
+ * from {@link tryClaim}, whose conditional `UPDATE` transitions
+ * `PUBLISHED`/`RESUBMITTED` → `PROCESSING` atomically and returns
+ * whether the row was actually claimed. A losing worker simply moves
+ * on. With small worker counts (typical: 1–3) the duplicate-fetch
+ * cost is negligible.
+ *
+ * The repository is dataSource-aware: pass a non-default
+ * `dataSourceName` when the application uses multiple DataSources
+ * (`'billing'`, `'inventory'`, ...). The fallback {@link DataSource}
+ * passed to the constructor is used when `getCurrentEntityManager` is
+ * called outside any active transaction — typical for operator-facing
+ * read APIs.
+ */
+export declare class TypeOrmEventPublicationRepository implements EventPublicationRepository {
+    private readonly dataSource;
+    private readonly dataSourceName;
+    constructor(dataSource: DataSource, dataSourceName?: string);
+    private get em();
+    createAll(inputs: NewEventPublication[]): Promise<EventPublication[]>;
+    findById(id: string): Promise<EventPublication | null>;
+    updateStatus(id: string, status: PublicationStatus, options?: UpdateStatusOptions): Promise<void>;
+    tryClaim(id: string): Promise<boolean>;
+    findReadyForProcessing(limit: number): Promise<EventPublication[]>;
+    findStale(beforeDate: Date, statuses: PublicationStatus[]): Promise<EventPublication[]>;
+    findCompleted(options?: FindCompletedOptions): Promise<EventPublication[]>;
+    findIncomplete(): Promise<EventPublication[]>;
+    findFailed(options?: FindFailedOptions): Promise<EventPublication[]>;
+    deleteCompleted(olderThan?: Date): Promise<number>;
+    archiveCompleted(id: string): Promise<void>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=typeorm-event-publication.repository.d.ts.map

package/dist/repository/typeorm-event-publication.repository.js

@@ -0,0 +1,237 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypeOrmEventPublicationRepository = void 0;
+const node_crypto_1 = require("node:crypto");
+const common_1 = require("@nestjs/common");
+const outbox_1 = require("@nestjs-transactional/outbox");
+const typeorm_1 = require("@nestjs-transactional/typeorm");
+const typeorm_2 = require("typeorm");
+const event_publication_archive_entity_1 = require("../entity/event-publication-archive.entity");
+const event_publication_entity_1 = require("../entity/event-publication.entity");
+/**
+ * TypeORM-backed implementation of
+ * {@link EventPublicationRepository}. Reads and writes go through the
+ * {@link EntityManager} bound to the ambient transaction (via
+ * `@nestjs-transactional/core`'s `AsyncLocalStorage`), so publication
+ * rows commit atomically with the business data.
+ *
+ * `findReadyForProcessing` returns ready rows in publication-date
+ * order WITHOUT per-row locking. The earlier design used
+ * `SELECT ... FOR UPDATE SKIP LOCKED` to give concurrent workers
+ * disjoint row sets; that approach was dropped because pessimistic
+ * locks require an enclosing transaction whose lifetime did not fit
+ * the worker's `find → tryClaim → invoke → finalize` flow (a
+ * transaction wide enough to hold the lock would have to wrap the
+ * listener invocation, which is unsafe for long-running listeners).
+ * Concurrent workers may now SEE the same rows; correctness comes
+ * from {@link tryClaim}, whose conditional `UPDATE` transitions
+ * `PUBLISHED`/`RESUBMITTED` → `PROCESSING` atomically and returns
+ * whether the row was actually claimed. A losing worker simply moves
+ * on. With small worker counts (typical: 1–3) the duplicate-fetch
+ * cost is negligible.
+ *
+ * The repository is dataSource-aware: pass a non-default
+ * `dataSourceName` when the application uses multiple DataSources
+ * (`'billing'`, `'inventory'`, ...). The fallback {@link DataSource}
+ * passed to the constructor is used when `getCurrentEntityManager` is
+ * called outside any active transaction — typical for operator-facing
+ * read APIs.
+ */
+let TypeOrmEventPublicationRepository = class TypeOrmEventPublicationRepository {
+    dataSource;
+    dataSourceName;
+    constructor(dataSource, dataSourceName = 'default') {
+        this.dataSource = dataSource;
+        this.dataSourceName = dataSourceName;
+    }
+    get em() {
+        return (0, typeorm_1.getCurrentEntityManager)(this.dataSourceName, this.dataSource);
+    }
+    async createAll(inputs) {
+        const entities = inputs.map((input) => {
+            const entity = new event_publication_entity_1.EventPublicationEntity();
+            entity.id = (0, node_crypto_1.randomUUID)();
+            entity.listenerId = input.listenerId;
+            entity.eventType = input.eventType;
+            entity.serializedEvent = input.serializedEvent;
+            entity.publicationDate = input.publicationDate ?? new Date();
+            entity.status = outbox_1.PublicationStatus.PUBLISHED;
+            entity.completionDate = null;
+            entity.lastResubmissionDate = null;
+            entity.completionAttempts = 0;
+            entity.failureReason = null;
+            return entity;
+        });
+        await this.em.save(event_publication_entity_1.EventPublicationEntity, entities);
+        return entities.map(toDomain);
+    }
+    async findById(id) {
+        const entity = await this.em.findOne(event_publication_entity_1.EventPublicationEntity, { where: { id } });
+        return entity ? toDomain(entity) : null;
+    }
+    async updateStatus(id, status, options = {}) {
+        // Build the SET clause inline: TypeORM's `.set()` accepts raw SQL
+        // fragments as `() => string`, so we can bump `completionAttempts`
+        // atomically without a separate `em.increment()` call.
+        await this.em
+            .createQueryBuilder()
+            .update(event_publication_entity_1.EventPublicationEntity)
+            .set({
+            status,
+            ...(options.completionDate !== undefined
+                ? { completionDate: options.completionDate }
+                : {}),
+            ...(options.failureReason !== undefined ? { failureReason: options.failureReason } : {}),
+            ...(options.lastResubmissionDate !== undefined
+                ? { lastResubmissionDate: options.lastResubmissionDate }
+                : {}),
+            ...(options.incrementAttempts
+                ? { completionAttempts: () => 'completion_attempts + 1' }
+                : {}),
+        })
+            .where('id = :id', { id })
+            .execute();
+    }
+    async tryClaim(id) {
+        // Atomic conditional update: only transitions the row when the
+        // current status is one the worker is allowed to claim. `affected`
+        // tells us whether we won the race — losers get 0 and back off.
+        const result = await this.em
+            .createQueryBuilder()
+            .update(event_publication_entity_1.EventPublicationEntity)
+            .set({
+            status: outbox_1.PublicationStatus.PROCESSING,
+            completionAttempts: () => 'completion_attempts + 1',
+        })
+            .where('id = :id AND status IN (:...statuses)', {
+            id,
+            statuses: [outbox_1.PublicationStatus.PUBLISHED, outbox_1.PublicationStatus.RESUBMITTED],
+        })
+            .execute();
+        return (result.affected ?? 0) > 0;
+    }
+    async findReadyForProcessing(limit) {
+        const entities = await this.em
+            .createQueryBuilder(event_publication_entity_1.EventPublicationEntity, 'p')
+            .where('p.status IN (:...statuses)', {
+            statuses: [outbox_1.PublicationStatus.PUBLISHED, outbox_1.PublicationStatus.RESUBMITTED],
+        })
+            .orderBy('p.publication_date', 'ASC')
+            .limit(limit)
+            .getMany();
+        return entities.map(toDomain);
+    }
+    async findStale(beforeDate, statuses) {
+        if (statuses.length === 0) {
+            return [];
+        }
+        const entities = await this.em.find(event_publication_entity_1.EventPublicationEntity, {
+            where: {
+                status: (0, typeorm_2.In)(statuses),
+                publicationDate: (0, typeorm_2.LessThan)(beforeDate),
+            },
+        });
+        return entities.map(toDomain);
+    }
+    async findCompleted(options) {
+        const where = {
+            status: outbox_1.PublicationStatus.COMPLETED,
+        };
+        if (options?.olderThan !== undefined) {
+            where.completionDate = (0, typeorm_2.LessThan)(options.olderThan);
+        }
+        const entities = await this.em.find(event_publication_entity_1.EventPublicationEntity, {
+            where,
+            ...(options?.limit !== undefined ? { take: options.limit } : {}),
+            order: { completionDate: 'DESC' },
+        });
+        return entities.map(toDomain);
+    }
+    async findIncomplete() {
+        const entities = await this.em.find(event_publication_entity_1.EventPublicationEntity, {
+            where: { status: (0, typeorm_2.Not)(outbox_1.PublicationStatus.COMPLETED) },
+        });
+        return entities.map(toDomain);
+    }
+    async findFailed(options) {
+        const where = {
+            status: outbox_1.PublicationStatus.FAILED,
+        };
+        if (options?.minAge !== undefined) {
+            where.publicationDate = (0, typeorm_2.LessThan)(new Date(Date.now() - options.minAge));
+        }
+        if (options?.maxAttempts !== undefined) {
+            where.completionAttempts = (0, typeorm_2.LessThanOrEqual)(options.maxAttempts);
+        }
+        const entities = await this.em.find(event_publication_entity_1.EventPublicationEntity, { where });
+        return entities.map(toDomain);
+    }
+    async deleteCompleted(olderThan) {
+        const where = {
+            status: outbox_1.PublicationStatus.COMPLETED,
+        };
+        if (olderThan !== undefined) {
+            where.completionDate = (0, typeorm_2.LessThan)(olderThan);
+        }
+        const result = await this.em.delete(event_publication_entity_1.EventPublicationEntity, where);
+        return result.affected ?? 0;
+    }
+    async archiveCompleted(id) {
+        // Deliberately does not open a nested TypeORM transaction — the
+        // ambient `@Transactional` scope (the processor always wraps the
+        // listener invocation in one) gives us atomicity between the
+        // archive insert and the hot-queue delete. If called outside a
+        // transaction, TypeORM executes both statements autocommit; the
+        // window of inconsistency is the round-trip between the two
+        // statements, which is acceptable for an archive operation.
+        const entity = await this.em.findOne(event_publication_entity_1.EventPublicationEntity, { where: { id } });
+        if (entity === null) {
+            throw new outbox_1.PublicationNotFoundError(id);
+        }
+        const archive = new event_publication_archive_entity_1.EventPublicationArchiveEntity();
+        archive.id = entity.id;
+        archive.listenerId = entity.listenerId;
+        archive.eventType = entity.eventType;
+        archive.serializedEvent = entity.serializedEvent;
+        archive.publicationDate = entity.publicationDate;
+        archive.status = entity.status;
+        archive.completionDate = entity.completionDate ?? new Date();
+        archive.lastResubmissionDate = entity.lastResubmissionDate;
+        archive.completionAttempts = entity.completionAttempts;
+        archive.failureReason = entity.failureReason;
+        await this.em.save(event_publication_archive_entity_1.EventPublicationArchiveEntity, archive);
+        await this.em.delete(event_publication_entity_1.EventPublicationEntity, { id });
+    }
+    async delete(id) {
+        await this.em.delete(event_publication_entity_1.EventPublicationEntity, { id });
+    }
+};
+exports.TypeOrmEventPublicationRepository = TypeOrmEventPublicationRepository;
+exports.TypeOrmEventPublicationRepository = TypeOrmEventPublicationRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Function, Object])
+], TypeOrmEventPublicationRepository);
+function toDomain(entity) {
+    return {
+        id: entity.id,
+        listenerId: entity.listenerId,
+        eventType: entity.eventType,
+        serializedEvent: entity.serializedEvent,
+        publicationDate: entity.publicationDate,
+        status: entity.status,
+        completionDate: entity.completionDate,
+        lastResubmissionDate: entity.lastResubmissionDate,
+        completionAttempts: entity.completionAttempts,
+        failureReason: entity.failureReason,
+    };
+}
+//# sourceMappingURL=typeorm-event-publication.repository.js.map

package/dist/repository/typeorm-event-publication.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeorm-event-publication.repository.js","sourceRoot":"","sources":["../../src/repository/typeorm-event-publication.repository.ts"],"names":[],"mappings":"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"}

package/dist/schema/event-publication-schema.d.ts

@@ -0,0 +1,30 @@
+import { type QueryRunner } from 'typeorm';
+/**
+ * Canonical table name for the hot queue. Exposed so downstream tools
+ * (e.g. custom queries, observability) can avoid hardcoding the string.
+ */
+export declare const EVENT_PUBLICATION_TABLE = "event_publication";
+/**
+ * Canonical table name for the archive trail. Used only by the
+ * `ARCHIVE` completion mode.
+ */
+export declare const EVENT_PUBLICATION_ARCHIVE_TABLE = "event_publication_archive";
+/**
+ * Create the hot and archive tables plus every index. Shared by
+ * {@link CreateEventPublication1700000000000} (the TypeORM migration)
+ * and `SchemaInitializer` (development-only auto-init) so the two paths
+ * cannot drift.
+ *
+ * Strict mode: fails if the tables already exist — callers are
+ * responsible for checking existence and skipping this call when
+ * needed.
+ */
+export declare function applyEventPublicationSchema(qr: QueryRunner): Promise<void>;
+/**
+ * Drop the archive first (to avoid referential surprises if a future
+ * revision adds a FK between the two) and then the hot table. Both
+ * drops are tolerant — `dropTable(..., true)` adds `IF EXISTS`, so
+ * running `down()` on a partially-applied schema still succeeds.
+ */
+export declare function revertEventPublicationSchema(qr: QueryRunner): Promise<void>;
+//# sourceMappingURL=event-publication-schema.d.ts.map

package/dist/schema/event-publication-schema.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVENT_PUBLICATION_ARCHIVE_TABLE = exports.EVENT_PUBLICATION_TABLE = void 0;
+exports.applyEventPublicationSchema = applyEventPublicationSchema;
+exports.revertEventPublicationSchema = revertEventPublicationSchema;
+const outbox_1 = require("@nestjs-transactional/outbox");
+const typeorm_1 = require("typeorm");
+/**
+ * Canonical table name for the hot queue. Exposed so downstream tools
+ * (e.g. custom queries, observability) can avoid hardcoding the string.
+ */
+exports.EVENT_PUBLICATION_TABLE = 'event_publication';
+/**
+ * Canonical table name for the archive trail. Used only by the
+ * `ARCHIVE` completion mode.
+ */
+exports.EVENT_PUBLICATION_ARCHIVE_TABLE = 'event_publication_archive';
+function buildHotTable() {
+    return new typeorm_1.Table({
+        name: exports.EVENT_PUBLICATION_TABLE,
+        columns: [
+            { name: 'id', type: 'uuid', isPrimary: true },
+            { name: 'listener_id', type: 'varchar', length: '512', isNullable: false },
+            { name: 'event_type', type: 'varchar', length: '256', isNullable: false },
+            { name: 'serialized_event', type: 'text', isNullable: false },
+            { name: 'publication_date', type: 'timestamptz', isNullable: false },
+            {
+                name: 'status',
+                type: 'varchar',
+                length: '32',
+                default: `'${outbox_1.PublicationStatus.PUBLISHED}'`,
+                isNullable: false,
+            },
+            { name: 'completion_date', type: 'timestamptz', isNullable: true },
+            { name: 'last_resubmission_date', type: 'timestamptz', isNullable: true },
+            { name: 'completion_attempts', type: 'int', default: 0, isNullable: false },
+            { name: 'failure_reason', type: 'text', isNullable: true },
+        ],
+    });
+}
+function buildArchiveTable() {
+    return new typeorm_1.Table({
+        name: exports.EVENT_PUBLICATION_ARCHIVE_TABLE,
+        columns: [
+            { name: 'id', type: 'uuid', isPrimary: true },
+            { name: 'listener_id', type: 'varchar', length: '512', isNullable: false },
+            { name: 'event_type', type: 'varchar', length: '256', isNullable: false },
+            { name: 'serialized_event', type: 'text', isNullable: false },
+            { name: 'publication_date', type: 'timestamptz', isNullable: false },
+            { name: 'status', type: 'varchar', length: '32', isNullable: false },
+            { name: 'completion_date', type: 'timestamptz', isNullable: false },
+            { name: 'last_resubmission_date', type: 'timestamptz', isNullable: true },
+            { name: 'completion_attempts', type: 'int', isNullable: false },
+            { name: 'failure_reason', type: 'text', isNullable: true },
+        ],
+    });
+}
+function buildHotIndexes() {
+    return [
+        new typeorm_1.TableIndex({
+            name: 'idx_event_publication_status_date',
+            columnNames: ['status', 'publication_date'],
+        }),
+        new typeorm_1.TableIndex({
+            name: 'idx_event_publication_status_listener',
+            columnNames: ['status', 'listener_id'],
+        }),
+        new typeorm_1.TableIndex({
+            name: 'idx_event_publication_event_type',
+            columnNames: ['event_type'],
+        }),
+        new typeorm_1.TableIndex({
+            name: 'idx_event_publication_completion_date',
+            columnNames: ['completion_date'],
+        }),
+    ];
+}
+function buildArchiveIndexes() {
+    return [
+        new typeorm_1.TableIndex({
+            name: 'idx_event_publication_archive_completion_date',
+            columnNames: ['completion_date'],
+        }),
+        new typeorm_1.TableIndex({
+            name: 'idx_event_publication_archive_listener',
+            columnNames: ['listener_id'],
+        }),
+        new typeorm_1.TableIndex({
+            name: 'idx_event_publication_archive_event_type',
+            columnNames: ['event_type'],
+        }),
+    ];
+}
+/**
+ * Create the hot and archive tables plus every index. Shared by
+ * {@link CreateEventPublication1700000000000} (the TypeORM migration)
+ * and `SchemaInitializer` (development-only auto-init) so the two paths
+ * cannot drift.
+ *
+ * Strict mode: fails if the tables already exist — callers are
+ * responsible for checking existence and skipping this call when
+ * needed.
+ */
+async function applyEventPublicationSchema(qr) {
+    await qr.createTable(buildHotTable());
+    for (const index of buildHotIndexes()) {
+        await qr.createIndex(exports.EVENT_PUBLICATION_TABLE, index);
+    }
+    await qr.createTable(buildArchiveTable());
+    for (const index of buildArchiveIndexes()) {
+        await qr.createIndex(exports.EVENT_PUBLICATION_ARCHIVE_TABLE, index);
+    }
+}
+/**
+ * Drop the archive first (to avoid referential surprises if a future
+ * revision adds a FK between the two) and then the hot table. Both
+ * drops are tolerant — `dropTable(..., true)` adds `IF EXISTS`, so
+ * running `down()` on a partially-applied schema still succeeds.
+ */
+async function revertEventPublicationSchema(qr) {
+    await qr.dropTable(exports.EVENT_PUBLICATION_ARCHIVE_TABLE, true);
+    await qr.dropTable(exports.EVENT_PUBLICATION_TABLE, true);
+}
+//# sourceMappingURL=event-publication-schema.js.map

package/dist/schema/event-publication-schema.js.map

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

package/dist/schema/schema-initialization-options.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Configuration for {@link SchemaInitializer}. Deliberately minimal —
+ * the initializer's sole job is to decide whether to create the
+ * `event_publication` schema at bootstrap time.
+ */
+export interface SchemaInitializationOptions {
+    /**
+     * When `true`, the initializer creates the `event_publication` and
+     * `event_publication_archive` tables on application bootstrap if
+     * they are missing. When `false` (the default), bootstrap is a
+     * no-op and the user is expected to have applied the TypeORM
+     * migration shipped by this package (or their own equivalent).
+     *
+     * **Development only.** Production systems should apply schema
+     * changes through a reviewed migration step, never at process
+     * startup.
+     */
+    readonly enabled: boolean;
+}
+/** DI token for {@link SchemaInitializationOptions}. */
+export declare const SCHEMA_INITIALIZATION_OPTIONS: unique symbol;
+/** Safe defaults — auto-init off, migrations preferred. */
+export declare const DEFAULT_SCHEMA_INITIALIZATION_OPTIONS: SchemaInitializationOptions;
+//# sourceMappingURL=schema-initialization-options.d.ts.map

package/dist/schema/schema-initialization-options.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SCHEMA_INITIALIZATION_OPTIONS = exports.SCHEMA_INITIALIZATION_OPTIONS = void 0;
+/** DI token for {@link SchemaInitializationOptions}. */
+exports.SCHEMA_INITIALIZATION_OPTIONS = Symbol('SCHEMA_INITIALIZATION_OPTIONS');
+/** Safe defaults — auto-init off, migrations preferred. */
+exports.DEFAULT_SCHEMA_INITIALIZATION_OPTIONS = {
+    enabled: false,
+};
+//# sourceMappingURL=schema-initialization-options.js.map

package/dist/schema/schema-initialization-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-initialization-options.js","sourceRoot":"","sources":["../../src/schema/schema-initialization-options.ts"],"names":[],"mappings":";;;AAoBA,wDAAwD;AAC3C,QAAA,6BAA6B,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC;AAErF,2DAA2D;AAC9C,QAAA,qCAAqC,GAAgC;IAChF,OAAO,EAAE,KAAK;CACf,CAAC"}

package/dist/schema/schema-initializer.d.ts

@@ -0,0 +1,31 @@
+import { type OnApplicationBootstrap } from '@nestjs/common';
+import type { DataSource } from 'typeorm';
+import type { SchemaInitializationOptions } from './schema-initialization-options';
+/**
+ * Development-time helper that creates the `event_publication` schema
+ * at application bootstrap, so developers can spin up a fresh app
+ * against an empty database without a separate migration step.
+ *
+ * **Not intended for production.** Production deployments should apply
+ * the schema via the TypeORM migration shipped by this package
+ * (`CreateEventPublication1700000000000`) or their own equivalent,
+ * and leave `enabled: false`.
+ *
+ * The equivalent Spring Modulith switch is
+ * `spring.modulith.events.jdbc.schema-initialization.enabled`.
+ */
+export declare class SchemaInitializer implements OnApplicationBootstrap {
+    private readonly dataSource;
+    private readonly options;
+    private readonly logger;
+    constructor(dataSource: DataSource, options: SchemaInitializationOptions);
+    onApplicationBootstrap(): Promise<void>;
+    /**
+     * Check for the hot table via `to_regclass` — Postgres-specific and
+     * respects the current `search_path`. Returns `null` when the table
+     * is missing, a regclass name (as text after the `::text` cast) when
+     * it exists.
+     */
+    private hotTableExists;
+}
+//# sourceMappingURL=schema-initializer.d.ts.map

package/dist/schema/schema-initializer.js

@@ -0,0 +1,72 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var SchemaInitializer_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaInitializer = void 0;
+const common_1 = require("@nestjs/common");
+const event_publication_schema_1 = require("./event-publication-schema");
+/**
+ * Development-time helper that creates the `event_publication` schema
+ * at application bootstrap, so developers can spin up a fresh app
+ * against an empty database without a separate migration step.
+ *
+ * **Not intended for production.** Production deployments should apply
+ * the schema via the TypeORM migration shipped by this package
+ * (`CreateEventPublication1700000000000`) or their own equivalent,
+ * and leave `enabled: false`.
+ *
+ * The equivalent Spring Modulith switch is
+ * `spring.modulith.events.jdbc.schema-initialization.enabled`.
+ */
+let SchemaInitializer = SchemaInitializer_1 = class SchemaInitializer {
+    dataSource;
+    options;
+    logger = new common_1.Logger(SchemaInitializer_1.name);
+    constructor(dataSource, options) {
+        this.dataSource = dataSource;
+        this.options = options;
+    }
+    async onApplicationBootstrap() {
+        if (!this.options.enabled) {
+            return;
+        }
+        if (await this.hotTableExists()) {
+            this.logger.debug(`Table '${event_publication_schema_1.EVENT_PUBLICATION_TABLE}' already exists — skipping auto schema init`);
+            return;
+        }
+        this.logger.log(`Initialising '${event_publication_schema_1.EVENT_PUBLICATION_TABLE}' schema (development auto-init)`);
+        const queryRunner = this.dataSource.createQueryRunner();
+        try {
+            await queryRunner.connect();
+            await (0, event_publication_schema_1.applyEventPublicationSchema)(queryRunner);
+            this.logger.log(`'${event_publication_schema_1.EVENT_PUBLICATION_TABLE}' schema initialised`);
+        }
+        finally {
+            await queryRunner.release();
+        }
+    }
+    /**
+     * Check for the hot table via `to_regclass` — Postgres-specific and
+     * respects the current `search_path`. Returns `null` when the table
+     * is missing, a regclass name (as text after the `::text` cast) when
+     * it exists.
+     */
+    async hotTableExists() {
+        const rows = await this.dataSource.query(`SELECT to_regclass($1)::text AS exists`, [event_publication_schema_1.EVENT_PUBLICATION_TABLE]);
+        return rows[0]?.exists != null;
+    }
+};
+exports.SchemaInitializer = SchemaInitializer;
+exports.SchemaInitializer = SchemaInitializer = SchemaInitializer_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Function, Object])
+], SchemaInitializer);
+//# sourceMappingURL=schema-initializer.js.map

package/dist/schema/schema-initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-initializer.js","sourceRoot":"","sources":["../../src/schema/schema-initializer.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAiF;AAGjF,yEAGoC;AAOpC;;;;;;;;;;;;GAYG;AAEI,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAIT;IACA;IAJF,MAAM,GAAG,IAAI,eAAM,CAAC,mBAAiB,CAAC,IAAI,CAAC,CAAC;IAE7D,YACmB,UAAsB,EACtB,OAAoC;QADpC,eAAU,GAAV,UAAU,CAAY;QACtB,YAAO,GAAP,OAAO,CAA6B;IACpD,CAAC;IAEJ,KAAK,CAAC,sBAAsB;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,MAAM,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,UAAU,kDAAuB,8CAA8C,CAChF,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,iBAAiB,kDAAuB,kCAAkC,CAC3E,CAAC;QAEF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAA,sDAA2B,EAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,kDAAuB,sBAAsB,CAAC,CAAC;QACrE,CAAC;gBAAS,CAAC;YACT,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CACtC,wCAAwC,EACxC,CAAC,kDAAuB,CAAC,CAC1B,CAAC;QACF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;IACjC,CAAC;CACF,CAAA;AA/CY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;;GACA,iBAAiB,CA+C7B"}