@pattern-stack/codegen 0.26.1 → 0.27.1

package/dist/src/index.js

@@ -47,14 +47,18 @@ import {
   validatePatternProject
 } from "../chunk-K4BQQ2NN.js";
 import "../chunk-KVOWSC5S.js";
+import "../chunk-VCXOPBYY.js";
 import "../chunk-PRWIX6UW.js";
-import "../chunk-7XDB4OMR.js";
-import "../chunk-QXYKV4CE.js";
+import "../chunk-W4JYZSQK.js";
 import "../chunk-EO2QPOKH.js";
-import "../chunk-HLURWFIT.js";
+import "../chunk-SQDOBLBP.js";
+import "../chunk-YIVQ7KLS.js";
+import "../chunk-LG57S2SC.js";
+import "../chunk-IASPGFFK.js";
+import "../chunk-S5G3HO7N.js";
+import "../chunk-MZ6GV4YF.js";
 import "../chunk-HNWZFNKP.js";
 import "../chunk-AHV4GDYM.js";
-import "../chunk-SQDOBLBP.js";
 import "../chunk-43SBT72G.js";
 import "../chunk-4MF3HKJA.js";
 import "../chunk-TIZXQU26.js";
@@ -62,10 +66,6 @@ import "../chunk-JEINYUJH.js";
 import "../chunk-5TK7MEN4.js";
 import "../chunk-4KNXX6TI.js";
 import "../chunk-3CJFPU6Q.js";
-import "../chunk-QO35B6BN.js";
-import "../chunk-MZ6GV4YF.js";
-import "../chunk-LG57S2SC.js";
-import "../chunk-S5G3HO7N.js";
 import "../chunk-U64T4YZE.js";
 import "../chunk-2E224ZSN.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pattern-stack/codegen",
-  "version": "0.26.1",
+  "version": "0.27.1",
   "description": "Entity-driven code generation for full-stack TypeScript applications",
   "license": "MIT",
   "type": "module",

package/runtime/http/pagination.ts

@@ -0,0 +1,233 @@
+/**
+ * Pagination envelope + ListQuery contract for generated entity list endpoints
+ * (pagination-by-default).
+ *
+ * Every generated `GET /<entities>` returns a {@link Page} envelope instead of
+ * a bare `T[]`. The request shape is {@link ListQuery} (page/cursor/pageSize +
+ * default sort) merged with arbitrary where-filters at the controller.
+ *
+ * Mirrors the in-repo precedent: the jobs subsystem's `JobRunPage`
+ * (`{ items, nextCursor }`) and its opaque keyset cursor codec
+ * (`runtime/subsystems/jobs/job-run-keyset-cursor.ts`). The entity envelope
+ * EXTENDS that minimal shape with `page/pageCount/total/pageSize` so a numbered
+ * UI (jump-to-page) works while `nextCursor` stays contract-stable for the
+ * later keyset upgrade.
+ *
+ * ENGINE NOTE (v1): the list use-case fetches by OFFSET (page-based). The
+ * `nextCursor` is computed from the last row and emitted from day one so the
+ * contract never changes, but cursor-REQUEST honoring (keyset seek) is a
+ * DEFERRED seam — see the TODO in the generated list use-case / the repository
+ * query branch. `ListQuery.cursor` is ACCEPTED (no validation error) even
+ * though v1 ignores it for fetching.
+ */
+
+import { z } from 'zod';
+
+// ============================================================================
+// Defaults + clamp
+// ============================================================================
+
+/** Default page size when `pageSize` is omitted. */
+export const DEFAULT_PAGE_SIZE = 50;
+/** Hard upper bound on page size to keep a single read bounded. */
+export const MAX_PAGE_SIZE = 200;
+/** Default page (1-based) when `page` is omitted. */
+export const DEFAULT_PAGE = 1;
+/** Default sort column. */
+export const DEFAULT_SORT_BY = 'created_at';
+/** Default sort direction. */
+export const DEFAULT_SORT_ORDER = 'desc' as const;
+
+/** Clamp a caller-supplied `pageSize` into `[1, MAX_PAGE_SIZE]`. */
+export function clampPageSize(pageSize: number | undefined): number {
+  if (typeof pageSize !== 'number' || !Number.isFinite(pageSize)) {
+    return DEFAULT_PAGE_SIZE;
+  }
+  const floored = Math.floor(pageSize);
+  if (floored < 1) return 1;
+  if (floored > MAX_PAGE_SIZE) return MAX_PAGE_SIZE;
+  return floored;
+}
+
+/** Clamp a caller-supplied `page` to a 1-based integer (floor 1). */
+export function clampPage(page: number | undefined): number {
+  if (typeof page !== 'number' || !Number.isFinite(page)) {
+    return DEFAULT_PAGE;
+  }
+  const floored = Math.floor(page);
+  return floored < 1 ? 1 : floored;
+}
+
+// ============================================================================
+// ListQuery schema (request)
+// ============================================================================
+
+/**
+ * Zod schema for the universal list query string. All keys optional —
+ * pagination works fully UNFILTERED (the default mode). `pageSize` is clamped
+ * (default 50, max 200) and `sort_order` defaults to `desc`. Arbitrary where
+ * filters are NOT modeled here (they're parsed/passed through at the controller
+ * via `.passthrough()`); this schema owns ONLY the pagination + sort knobs so
+ * the defaults + clamp land in one place.
+ *
+ * `cursor` is accepted but v1 ignores it for fetching (offset engine) — the
+ * keyset seek is the deferred seam. Passing a `nextCursor` back never errors.
+ */
+export const ListQuerySchema = z
+  .object({
+    page: z.coerce.number().int().optional(),
+    cursor: z.string().optional(),
+    pageSize: z.coerce.number().int().optional(),
+    sort_by: z.string().optional(),
+    sort_order: z.enum(['asc', 'desc']).optional(),
+  })
+  .passthrough();
+
+/** Parsed list query (pre-clamp). Use {@link resolveListQuery} to normalize. */
+export type ListQuery = z.infer<typeof ListQuerySchema>;
+
+/**
+ * Normalized pagination options resolved from a raw {@link ListQuery}: clamped
+ * `page`/`pageSize`, computed `offset`, and a defaulted sort. The generated
+ * list use-case feeds these straight into `service.list({ limit, offset, ... })`.
+ */
+export interface ResolvedListQuery {
+  page: number;
+  pageSize: number;
+  /** `(page - 1) * pageSize`. */
+  offset: number;
+  sortBy: string;
+  sortOrder: 'asc' | 'desc';
+  /** Opaque cursor as passed by the caller (v1: not honored — deferred seam). */
+  cursor?: string;
+}
+
+/**
+ * Resolve a raw list query into normalized, clamped pagination options.
+ * Defaults: page 1, pageSize 50 (max 200), sort `created_at desc`.
+ */
+export function resolveListQuery(query: ListQuery | undefined): ResolvedListQuery {
+  const page = clampPage(query?.page);
+  const pageSize = clampPageSize(query?.pageSize);
+  return {
+    page,
+    pageSize,
+    offset: (page - 1) * pageSize,
+    sortBy: query?.sort_by ?? DEFAULT_SORT_BY,
+    sortOrder: query?.sort_order ?? DEFAULT_SORT_ORDER,
+    cursor: query?.cursor,
+  };
+}
+
+// ============================================================================
+// Page envelope (response)
+// ============================================================================
+
+/**
+ * One page of a paginated list response. EXTENDS the jobs subsystem's minimal
+ * `{ items, nextCursor }` shape with the numbered-UI fields:
+ *
+ *   - `page`       — 1-based page number of THIS page.
+ *   - `pageCount`  — total number of pages (`ceil(total / pageSize)`, min 1).
+ *   - `total`      — total matching rows (reflects any where-filter).
+ *   - `pageSize`   — the (clamped) page size used.
+ *   - `nextCursor` — opaque keyset cursor of the LAST row, or `null` on the
+ *                    last page / empty result. Contract-stable from day one;
+ *                    v1 emits it but fetches by offset.
+ */
+export interface Page<T> {
+  items: T[];
+  page: number;
+  pageCount: number;
+  total: number;
+  pageSize: number;
+  nextCursor: string | null;
+}
+
+// ============================================================================
+// Opaque cursor codec (encodes (createdAt, id))
+// ============================================================================
+
+/** Keyset tuple a {@link Page.nextCursor} encodes. */
+export interface PageKeyset {
+  /** `created_at` of the last row on this page. */
+  createdAt: Date;
+  /** `id` (UUID) tie-break of the last row on this page. */
+  id: string;
+}
+
+/**
+ * Encode a `(createdAt, id)` keyset into an opaque, base64url cursor. The shape
+ * (a JSON tuple) is an implementation detail — never parse it outside this
+ * module. Mirrors `encodeKeysetCursor` in the jobs subsystem.
+ */
+export function encodeCursor(keyset: PageKeyset): string {
+  const tuple = [keyset.createdAt.toISOString(), keyset.id];
+  return Buffer.from(JSON.stringify(tuple), 'utf8').toString('base64url');
+}
+
+/**
+ * Decode an opaque cursor back into its `(createdAt, id)` keyset. Returns
+ * `null` for a malformed cursor so a caller can treat garbage as "start from
+ * the beginning" rather than throw on user-supplied data.
+ */
+export function decodeCursor(cursor: string): PageKeyset | null {
+  try {
+    const json = Buffer.from(cursor, 'base64url').toString('utf8');
+    const parsed = JSON.parse(json) as unknown;
+    if (!Array.isArray(parsed) || parsed.length !== 2) return null;
+    const [iso, id] = parsed;
+    if (typeof iso !== 'string' || typeof id !== 'string') return null;
+    const createdAt = new Date(iso);
+    if (Number.isNaN(createdAt.getTime())) return null;
+    return { createdAt, id };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Compute the `nextCursor` for a page of rows: the opaque cursor of the LAST
+ * row when more pages remain, else `null`. A row is expected to carry
+ * `createdAt: Date` and `id: string` (the default-sort keyset). Rows missing
+ * either field yield `null` (cursor not derivable — caller falls back to offset
+ * paging, which is the v1 engine anyway).
+ *
+ * @param rows      the items on this page (already fetched, in sort order)
+ * @param hasMore   whether more rows exist beyond this page
+ *                  (`offset + rows.length < total`)
+ */
+export function computeNextCursor(
+  rows: ReadonlyArray<unknown>,
+  hasMore: boolean,
+): string | null {
+  if (!hasMore || rows.length === 0) return null;
+  const last = rows[rows.length - 1] as { createdAt?: unknown; id?: unknown };
+  const createdAt = last?.createdAt;
+  const id = last?.id;
+  if (!(createdAt instanceof Date) || typeof id !== 'string') return null;
+  return encodeCursor({ createdAt, id });
+}
+
+/**
+ * Assemble a {@link Page} envelope from a fetched page of rows + the total
+ * matching count + the resolved query. Computes `pageCount` and `nextCursor`.
+ * The single place the envelope shape is constructed, so the generated list
+ * use-case stays a thin call.
+ */
+export function buildPage<T>(
+  items: T[],
+  total: number,
+  resolved: Pick<ResolvedListQuery, 'page' | 'pageSize' | 'offset'>,
+): Page<T> {
+  const pageCount = total === 0 ? 1 : Math.ceil(total / resolved.pageSize);
+  const hasMore = resolved.offset + items.length < total;
+  return {
+    items,
+    page: resolved.page,
+    pageCount,
+    total,
+    pageSize: resolved.pageSize,
+    nextCursor: computeNextCursor(items as ReadonlyArray<unknown>, hasMore),
+  };
+}

package/runtime/subsystems/events/event-bus.drizzle-backend.ts

@@ -30,7 +30,7 @@
  */
 import { randomUUID } from 'node:crypto';
 import { Injectable, OnModuleDestroy, OnModuleInit, Inject, Logger, Optional } from '@nestjs/common';
-import { eq, and, inArray, asc, desc, gte, lt, or, sql, type SQL } from 'drizzle-orm';
+import { eq, and, inArray, asc, desc, gte, lt, lte, or, sql, type SQL } from 'drizzle-orm';
 import type {
   DomainEvent,
   DrizzleTransaction,
@@ -584,10 +584,22 @@ export class DrizzleEventBus implements IEventBus, IEventReadPort, OnModuleInit,
   private async processBatch(): Promise<void> {
     const pools = this.opts.pools;
 
-    // Build WHERE: status='pending' [AND pool IN (...)]
+    // Build WHERE: status='pending' AND occurred_at <= now [AND pool IN (...)].
+    //
+    // The readiness gate (`occurred_at <= now`) is what makes a scheduler-
+    // materialised *future* slot wait. The EventScheduler pre-inserts the next
+    // slot with `occurred_at = slotStart` in the future and deliberately does
+    // NOT NOTIFY-wake the drainer for it (see materializeScheduledEvent: a
+    // future slot is claimed by polling once its `occurred_at` passes). Without
+    // this predicate the claim is status-only, so the very next poll grabs the
+    // future-dated row and stamps `processed_at = now()` early — surfacing rows
+    // that read "N minutes from now" yet are already processed, and firing
+    // scheduled triggers up to one interval ahead of their slot. Normal events
+    // publish with `occurred_at = now()`, so the gate is transparent to them.
+    const ready = lte(domainEvents.occurredAt, new Date());
     const whereClause: SQL<unknown> = pools && pools.length > 0
-      ? (and(eq(domainEvents.status, 'pending'), inArray(domainEvents.pool, pools)) as SQL<unknown>)
-      : eq(domainEvents.status, 'pending');
+      ? (and(eq(domainEvents.status, 'pending'), ready, inArray(domainEvents.pool, pools)) as SQL<unknown>)
+      : (and(eq(domainEvents.status, 'pending'), ready) as SQL<unknown>);
 
     // Claim a batch with FOR UPDATE SKIP LOCKED so multiple pollers don't
     // double-dispatch. The lock is released when the outer transaction

package/templates/entity/new/clean-lite-ps/controller.ejs.t

@@ -4,8 +4,12 @@ skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
 force: true
 ---
 <%- typeof generatedBanner !== 'undefined' ? generatedBanner : '' %>
-import { Controller, Get<% if (generateWrites) { %>, Post, Patch, Delete, Body, Headers<% } %>, NotFoundException, Param, ParseUUIDPipe } from '@nestjs/common';
-import { ApiBearerAuth, <% if (generateWrites) { %>ApiBody, <% } %>ApiOperation, ApiParam, ApiResponse } from '@nestjs/swagger';
+import { Controller, Get<% if (generateWrites) { %>, Post, Patch, Delete, Body, Headers<% } %>, NotFoundException, Param, ParseUUIDPipe, Query } from '@nestjs/common';
+import { ApiBearerAuth, <% if (generateWrites) { %>ApiBody, <% } %>ApiOperation, ApiParam, ApiQuery, ApiResponse } from '@nestjs/swagger';
+import { ZodValidationPipe } from '<%= typeof zodValidationPipeImport !== 'undefined' ? zodValidationPipeImport : '@shared/pipes/zod-validation.pipe' %>';
+import type { Page } from '<%= typeof paginationImport !== 'undefined' ? paginationImport : '@shared/http/pagination' %>';
+import { <%= classNames.listQuerySchema %> } from './dto/list-<%= entityNamePlural %>.query';
+import type { <%= classNames.listQueryDto %> } from './dto/list-<%= entityNamePlural %>.query';
 import { <%= classNames.findByIdUseCase %> } from './use-cases/find-<%= entityName %>-by-id.use-case';
 import { <%= classNames.listUseCase %> } from './use-cases/list-<%= entityNamePlural %>.use-case';
 <% if (eavEnabled) { -%>
@@ -13,7 +17,6 @@ import { <%= classNames.findByIdWithFieldsUseCase %> } from './use-cases/find-<%
 import { <%= classNames.listWithFieldsUseCase %> } from './use-cases/list-<%= entityNamePlural %>-with-fields.use-case';
 <% } -%>
 <% if (generateWrites) { -%>
-import { ZodValidationPipe } from '<%= typeof zodValidationPipeImport !== 'undefined' ? zodValidationPipeImport : '@shared/pipes/zod-validation.pipe' %>';
 import { <%= classNames.createUseCase %> } from './use-cases/create-<%= entityName %>.use-case';
 import { <%= classNames.updateUseCase %> } from './use-cases/update-<%= entityName %>.use-case';
 import { <%= classNames.deleteUseCase %> } from './use-cases/delete-<%= entityName %>.use-case';
@@ -47,14 +50,32 @@ export class <%= classNames.controller %> {
   ) {}
 
   @ApiOperation({ summary: 'List <%= entityNamePlural %>', operationId: 'list<%= classNames.entity %>s' })
+  @ApiQuery({ name: 'page', required: false, type: 'integer', description: '1-based page number (default 1).' })
+  @ApiQuery({ name: 'pageSize', required: false, type: 'integer', description: 'Page size (default 50, max 200).' })
+  @ApiQuery({ name: 'cursor', required: false, type: 'string', description: 'Opaque keyset cursor (accepted; v1 paginates by offset).' })
+  @ApiQuery({ name: 'sort_by', required: false, type: 'string', description: "Sort column (default 'created_at')." })
+  @ApiQuery({ name: 'sort_order', required: false, enum: ['asc', 'desc'], description: "Sort direction (default 'desc')." })
   @ApiResponse({
     status: 200,
-    schema: { type: 'array', items: { $ref: '#/components/schemas/<%= classNames.outputDto %>' } },
+    schema: {
+      type: 'object',
+      properties: {
+        items: { type: 'array', items: { $ref: '#/components/schemas/<%= classNames.outputDto %>' } },
+        page: { type: 'integer' },
+        pageCount: { type: 'integer' },
+        total: { type: 'integer' },
+        pageSize: { type: 'integer' },
+        nextCursor: { type: 'string', nullable: true },
+      },
+      required: ['items', 'page', 'pageCount', 'total', 'pageSize', 'nextCursor'],
+    },
   })
   @ApiResponse({ status: 401, schema: { $ref: '#/components/schemas/ErrorResponseDto' } })
   @Get()
-  async getAll(): Promise<<%= classNames.entity %>[]> {
-    return this.listUseCase.execute();
+  async getAll(
+    @Query(new ZodValidationPipe(<%= classNames.listQuerySchema %>)) query: <%= classNames.listQueryDto %>,
+  ): Promise<Page<<%= classNames.entity %>>> {
+    return this.listUseCase.execute(query);
   }
 <% if (eavEnabled) { %>
   @ApiOperation({

package/templates/entity/new/clean-lite-ps/dto/list-query.ejs.t

@@ -0,0 +1,22 @@
+---
+to: "<%= typeof clpOutputPaths !== 'undefined' ? clpOutputPaths.listQueryDto : null %>"
+skip_if: "<%= typeof clpOutputPaths === 'undefined' %>"
+force: true
+---
+<%- typeof generatedBanner !== 'undefined' ? generatedBanner : '' %>
+import { z } from 'zod';
+import { ListQuerySchema } from '<%= typeof paginationImport !== 'undefined' ? paginationImport : '@shared/http/pagination' %>';
+
+/**
+ * List query DTO for `GET /<%= entityNamePlural %>` (pagination-by-default).
+ *
+ * Re-exports the shared `ListQuerySchema` (page/cursor/pageSize/sort_by/
+ * sort_order + `.passthrough()` for arbitrary where-filters). pageSize is
+ * clamped (default 50, max 200) and the default sort is `created_at desc, id
+ * desc` — both applied in the list use-case via `resolveListQuery`. `cursor` is
+ * accepted but v1 ignores it for fetching (offset engine); the keyset seek is a
+ * deferred seam.
+ */
+export const <%= classNames.listQuerySchema %> = ListQuerySchema;
+
+export type <%= classNames.listQueryDto %> = z.infer<typeof <%= classNames.listQuerySchema %>>;

package/templates/entity/new/clean-lite-ps/index.ejs.t

@@ -19,3 +19,4 @@ export type { <%= classNames.entity %> } from './<%= entityName %>.entity';
 export type { <%= classNames.createDto %> } from './dto/create-<%= entityName %>.dto';
 export type { <%= classNames.updateDto %> } from './dto/update-<%= entityName %>.dto';
 export type { <%= classNames.outputDto %> } from './dto/<%= entityName %>-output.dto';
+export type { <%= classNames.listQueryDto %> } from './dto/list-<%= entityNamePlural %>.query';

package/templates/entity/new/clean-lite-ps/prompt-extension.js

@@ -1296,6 +1296,9 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
     createDto: `${moduleGroupDir}/${entityNamePlural}/dto/create-${entityName}.dto.ts`,
     updateDto: `${moduleGroupDir}/${entityNamePlural}/dto/update-${entityName}.dto.ts`,
     outputDto: `${moduleGroupDir}/${entityNamePlural}/dto/${entityName}-output.dto.ts`,
+    // Pagination-by-default: the universal list query DTO (page/cursor/pageSize
+    // + sort). Always emitted — the list endpoint is unconditional.
+    listQueryDto: `${moduleGroupDir}/${entityNamePlural}/dto/list-${entityNamePlural}.query.ts`,
     searchUseCase: searchQueryResolved
       ? `${moduleGroupDir}/${entityNamePlural}/use-cases/search-${entityNamePlural}.use-case.ts`
       : null,
@@ -1347,6 +1350,10 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
     createSchema: `Create${entityNamePascal}Schema`,
     updateSchema: `Update${entityNamePascal}Schema`,
     outputSchema: `${entityNamePascal}OutputSchema`,
+    // Pagination-by-default: list query DTO + schema (re-export of the shared
+    // ListQuerySchema). Named per-entity so the controller import is unambiguous.
+    listQueryDto: `List${entityNamePluralPascal}QueryDto`,
+    listQuerySchema: `List${entityNamePluralPascal}QuerySchema`,
   };
 
   // Fields for create DTO: exclude id, behavior-managed fields, and FK fields
@@ -1413,6 +1420,12 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
     baseLocals?.drizzleTokenImport ?? '@shared/constants/tokens';
   const drizzleTypeImport =
     baseLocals?.drizzleTypeImport ?? '@shared/types/drizzle';
+  // Pagination contract (pagination-by-default). Package mode → the runtime
+  // module `@pattern-stack/codegen/runtime/http/pagination`; vendored / default
+  // → the consumer-owned `@shared/http/pagination`. Threaded from prompt.js;
+  // unit tests that call buildCleanLitePsLocals directly get the @shared default.
+  const paginationImport =
+    baseLocals?.paginationImport ?? '@shared/http/pagination';
 
   return {
     // Clean-Lite-PS identity
@@ -1431,6 +1444,7 @@ export function buildCleanLitePsLocals(definition, baseLocals) {
     typedEventBusImport,
     drizzleTokenImport,
     drizzleTypeImport,
+    paginationImport,
 
     // Pattern — registry-driven (ADR-031)
     patternName,

package/templates/entity/new/clean-lite-ps/use-cases/list.ejs.t

@@ -4,14 +4,67 @@ force: true
 ---
 <%- typeof generatedBanner !== 'undefined' ? generatedBanner : '' %>
 import { Injectable } from '@nestjs/common';
+import { asc, desc, sql, type SQL } from 'drizzle-orm';
+import { buildPage, resolveListQuery, type ListQuery, type Page } from '<%= typeof paginationImport !== 'undefined' ? paginationImport : '@shared/http/pagination' %>';
 import { <%= classNames.service %> } from '../<%= entityName %>.service';
-import type { <%= classNames.entity %> } from '../<%= entityName %>.entity';
+import { <%= entityNamePlural %>, type <%= classNames.entity %> } from '../<%= entityName %>.entity';
 
+/**
+ * Paginated list use-case for <%= entityNamePlural %> (pagination-by-default).
+ *
+ * Composes `service.list({ where, limit, offset, orderBy })` + `service.count(where)`
+ * into a `Page<<%- classNames.entity %>>` envelope. Defaults: page 1,
+ * pageSize 50 (max 200), sort `created_at desc, id desc`. `total`/`pageCount`
+ * reflect the (optionally filtered) set, so pagination composes with where
+ * filters orthogonally — it works fully unfiltered too.
+ *
+ * v1 ENGINE = OFFSET. `nextCursor` is computed from the last row and emitted
+ * (contract-stable), but cursor-REQUEST honoring (keyset seek) is DEFERRED:
+ * `resolved.cursor` is accepted and ignored here. The keyset swap belongs in
+ * the marked seam below — fetch by `WHERE (created_at, id) < decodeCursor(cursor)`
+ * instead of `offset` — and is otherwise invisible to the controller/UI.
+ */
 @Injectable()
 export class <%= classNames.listUseCase %> {
   constructor(private readonly service: <%= classNames.service %>) {}
 
-  async execute(): Promise<<%= classNames.entity %>[]> {
-    return this.service.list();
+  async execute(query?: ListQuery): Promise<Page<<%= classNames.entity %>>> {
+    const resolved = resolveListQuery(query);
+
+    // Default sort: `created_at desc, id desc` (id is the stable keyset
+    // tie-break). A caller `sort_by` that names a real column is honored in the
+    // requested direction with the id tie-break appended; an unknown column
+    // falls back to the default. Composed as a single SQL fragment because the
+    // base repository's `orderBy` takes one expression.
+    const dir = resolved.sortOrder === 'asc' ? asc : desc;
+    const col = (<%= entityNamePlural %> as unknown as Record<string, unknown>)[
+      resolved.sortBy.replace(/_([a-z])/g, (_m: string, c: string) => c.toUpperCase())
+    ];
+    const orderBy: SQL =
+      col === undefined
+        ? sql`${desc(<%= entityNamePlural %>.createdAt)}, ${desc(<%= entityNamePlural %>.id)}`
+        : sql`${dir(col as never)}, ${desc(<%= entityNamePlural %>.id)}`;
+
+    // Arbitrary where-filters are NOT modeled in v1 (the ListQuery owns only
+    // pagination + sort); `where` stays undefined so the list is unfiltered by
+    // default. A future filter seam ANDs predicates here and passes the same
+    // `where` to both `list` and `count` so `total`/`pageCount` stay accurate.
+    const where: SQL | undefined = undefined;
+
+    // KEYSET SEAM (deferred — v1 fetches by offset). When the keyset upgrade
+    // lands, branch here on `resolved.cursor`: decode it and fetch by
+    // `WHERE (created_at, id) < (cursorCreatedAt, cursorId)` LIMIT pageSize,
+    // dropping the offset. The envelope + nextCursor below are unchanged.
+    const [items, total] = await Promise.all([
+      this.service.list({
+        where,
+        limit: resolved.pageSize,
+        offset: resolved.offset,
+        orderBy,
+      }),
+      this.service.count(where),
+    ]);
+
+    return buildPage(items, total, resolved);
   }
 }

package/templates/entity/new/prompt.js

@@ -1380,6 +1380,22 @@ export default {
     const typedEventBusImport = subsystemsImport(runtimeMode, 'events');
     const drizzleTokenImport = runtimeImport(runtimeMode, 'constants/tokens');
     const drizzleTypeImport = runtimeImport(runtimeMode, 'types/drizzle');
+    // Pagination contract (pagination-by-default). ASYMMETRIC by mode:
+    //   - package  → `@pattern-stack/codegen/runtime/http/pagination` (Page<T>,
+    //     ListQuerySchema, resolveListQuery, buildPage, cursor codec) — the
+    //     package-published runtime; swe-brain consumes this green.
+    //   - vendored → `@shared/http/page` (vendored to `src/shared/http/page.ts`
+    //     by project init's VENDORED_RUNTIME_FILES). DISTINCT from the consumer's
+    //     OPTIONAL `@shared/http/pagination` search contract ({items,total,limit,
+    //     offset}) — vendoring the Page<T> envelope to `/pagination` would
+    //     clobber it, so the list envelope lives at `/page`.
+    // Unlike most @shared/http/* files (which the package never owns), THIS one
+    // IS package-published — the list endpoint is unconditional, so its contract
+    // must ship with codegen (package mode) and be vendored (vendored mode).
+    const paginationImport =
+      runtimeMode === 'vendored'
+        ? '@shared/http/page'
+        : runtimeImport(runtimeMode, 'http/pagination');
     // Integration subsystem barrel (ADR-033.1 inline-sync `integration-source`
     // module — emitted only for entities with an inline `detection:` block).
     const integrationSubsystemImport = subsystemsImport(runtimeMode, 'integration');
@@ -1602,6 +1618,7 @@ export default {
       typedEventBusImport,
       drizzleTokenImport,
       drizzleTypeImport,
+      paginationImport,
       integrationSubsystemImport,
       withAnalyticsImport,
       integrationUpsertConfigImport,

package/dist/chunk-PNCOUFFI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../runtime/subsystems/events/event-bus.drizzle-backend.ts"],"sourcesContent":["/**\n * DrizzleEventBus — Postgres-backed event bus using the transactional outbox pattern.\n *\n * Events are inserted into the `domain_events` table within the caller's\n * Drizzle transaction. A background polling loop (started on module init)\n * reads unprocessed events and dispatches them to registered subscribers.\n *\n * When the transaction rolls back, the event is never persisted — no\n * phantom events.\n *\n * Pool awareness (EVT-4):\n * - On `publish`/`publishMany` the backend writes `metadata.pool`,\n *   `metadata.direction`, and `metadata.tenantId` into the first-class\n *   `pool` / `direction` / `tenant_id` columns (metadata JSON is still\n *   written unchanged for protocol stability).\n * - The drain loop filters by `opts.pools` when provided, so separate\n *   processes (e.g. one per `events_inbound` / `events_change` /\n *   `events_outbound`) can claim only their own lane. `pools: undefined`\n *   drains all pending rows (backwards-compatible behaviour).\n *\n * EVT-Q7: No stale-event sweeper. `FOR UPDATE SKIP LOCKED` is\n * self-healing — the row is only locked for the duration of the\n * enclosing polling transaction; the `status='processed'` update happens\n * within that same transaction. There is no `claimed_at` semantic (unlike\n * jobs), so no stale rows can exist.\n *\n * This backend is suitable until you need real-time fan-out or very high\n * throughput. At that point, swap the backend for Redis Streams or similar\n * via EventsModule.forRoot({ backend: '...' }) without touching use cases.\n */\nimport { randomUUID } from 'node:crypto';\nimport { Injectable, OnModuleDestroy, OnModuleInit, Inject, Logger, Optional } from '@nestjs/common';\nimport { eq, and, inArray, asc, desc, gte, lt, or, sql, type SQL } from 'drizzle-orm';\nimport type {\n  DomainEvent,\n  DrizzleTransaction,\n  IEventBus,\n  ScheduledEventSpec,\n} from './event-bus.protocol';\nimport type {\n  EventPage,\n  IEventReadPort,\n  ListEventsQuery,\n} from './event-read.protocol';\nimport {\n  clampEventLimit,\n  decodeEventCursor,\n  encodeEventCursor,\n} from './event-keyset-cursor';\nimport type { DrizzleClient } from '../../types/drizzle';\nimport { domainEvents, type DomainEventRecord } from './domain-events.schema';\nimport { DRIZZLE } from '../../constants/tokens';\nimport { EVENTS_MODULE_OPTIONS } from './events.tokens';\nimport type { EventsModuleOptions } from './events.module';\nimport { BRIDGE_OUTBOX_DRAIN_HOOK } from '../bridge/bridge.tokens';\nimport type { IBridgeOutboxDrainHook } from '../bridge/bridge.protocol';\nimport {\n  EVENTS_WAKE_CHANNEL,\n  PgNotifyListener,\n  pgNotify,\n} from '../jobs/pg-notify';\n\n/** How long to wait between polling cycles (ms). */\nconst POLL_INTERVAL_MS = 1_000;\n/** Max events claimed per polling cycle to bound memory usage. */\nconst POLL_BATCH_SIZE = 50;\n\n/**\n * Row shape built from `metadata` for writing into `domain_events`. Keeps\n * the per-event extraction logic in one place so publish/publishMany stay\n * in sync.\n */\nfunction toInsertValues(event: DomainEvent, multiTenant: boolean) {\n  const metadata = event.metadata ?? undefined;\n  const pool = (metadata?.['pool'] as string | undefined) ?? null;\n  const direction = (metadata?.['direction'] as string | undefined) ?? null;\n  // AUDIT-1: tier defaults to 'domain' when absent. The DB CHECK\n  // constraint (`domain_events_tier_routing_check`) enforces the\n  // tier ⇔ routing-fields invariant at the storage boundary; no\n  // JS-side assertion is needed here.\n  const tier = (metadata?.['tier'] as string | undefined) ?? 'domain';\n  const base = {\n    id: event.id,\n    type: event.type,\n    aggregateId: event.aggregateId,\n    aggregateType: event.aggregateType,\n    payload: event.payload,\n    occurredAt: event.occurredAt,\n    processedAt: null,\n    status: 'pending' as const,\n    metadata: event.metadata,\n    pool,\n    direction,\n    tier,\n  };\n  // EVT-8: `tenant_id` is a scaffold-time conditional column, emitted only\n  // when `events.multi_tenant: true`. Only write it when multi-tenancy is\n  // on — under single-tenant scaffolds the column does not exist, so the\n  // key must be omitted from the insert.\n  if (!multiTenant) return base;\n  const tenantId = (metadata?.['tenantId'] as string | undefined) ?? null;\n  return { ...base, tenantId };\n}\n\n/**\n * Project a raw `domain_events` row into the narrow `EventSummary` shape.\n * Shared with the memory backend via this helper kept module-local to each\n * backend (the events subsystem has no cross-backend projection file yet;\n * the two are byte-identical and small).\n */\nfunction toEventSummary(r: DomainEventRecord) {\n  const metadata = (r.metadata ?? undefined) as\n    | Record<string, unknown>\n    | undefined;\n  const rootRunId = metadata?.['rootRunId'];\n  return {\n    id: r.id,\n    type: r.type,\n    aggregateId: r.aggregateId,\n    aggregateType: r.aggregateType,\n    status: r.status,\n    pool: r.pool,\n    direction: r.direction,\n    tier: r.tier,\n    rootRunId: typeof rootRunId === 'string' ? rootRunId : null,\n    // EVT-8: `tenant_id` is a scaffold-time conditional column. Read it\n    // structurally so this projection typechecks against both the\n    // multi-tenant schema (column present) and the single-tenant schema\n    // (column absent → undefined → null).\n    tenantId: (r as { tenantId?: string | null }).tenantId ?? null,\n    occurredAt:\n      r.occurredAt instanceof Date\n        ? r.occurredAt\n        : new Date(r.occurredAt as unknown as string),\n    processedAt:\n      r.processedAt == null\n        ? null\n        : r.processedAt instanceof Date\n          ? r.processedAt\n          : new Date(r.processedAt as unknown as string),\n  };\n}\n\n/**\n * Postgres unique-violation (SQLSTATE 23505) test. Used by the scheduled-event\n * materialiser (ADR-039) to treat a slot-key collision as the\n * already-materialised no-op. Reads `.code` defensively across driver shapes\n * (node-postgres surfaces it on the error, some wrappers nest it on `.cause`).\n */\nfunction isUniqueViolation(err: unknown): boolean {\n  const code = (err as { code?: unknown; cause?: { code?: unknown } } | undefined);\n  return code?.code === '23505' || code?.cause?.code === '23505';\n}\n\n@Injectable()\nexport class DrizzleEventBus implements IEventBus, IEventReadPort, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(DrizzleEventBus.name);\n  private polling = false;\n  private pollTimer: ReturnType<typeof setTimeout> | null = null;\n  private readonly handlers = new Map<string, Set<(event: DomainEvent) => Promise<void>>>();\n  private readonly opts: EventsModuleOptions;\n\n  // LISTEN-NOTIFY-1 — dedicated wake listener + debounce state. `null` when\n  // `listenNotify` is off (the common case); polling is the only driver then.\n  private notifyListener: PgNotifyListener | null = null;\n  /** True while a wake-driven drain is in flight (debounce gate). */\n  private wakeDraining = false;\n  /** A notify arrived mid-drain → re-drain once when the current drain ends. */\n  private wakeRecheckPending = false;\n\n  constructor(\n    @Inject(DRIZZLE) private readonly db: DrizzleClient,\n    @Optional() @Inject(EVENTS_MODULE_OPTIONS) opts?: EventsModuleOptions,\n    /**\n     * Bridge subsystem hook (BRIDGE-4). Optional — when the bridge\n     * subsystem is not installed in the consuming app, this token is\n     * undefined and the drain skips the bridge block entirely (preserves\n     * EVT-4 baseline behaviour).\n     *\n     * When provided, `processEvent` is invoked once per drained event\n     * INSIDE the per-event tx, before `processed_at` is stamped. The\n     * hook owns all knowledge of `bridge_delivery + wrapper job_run`\n     * shapes; the events subsystem stays unaware of bridge schemas.\n     */\n    @Optional()\n    @Inject(BRIDGE_OUTBOX_DRAIN_HOOK)\n    private readonly bridgeHook: IBridgeOutboxDrainHook | null = null,\n  ) {\n    // Default so direct construction (e.g. integration tests not going\n    // through Nest DI) keeps working without an explicit options object.\n    this.opts = opts ?? { backend: 'drizzle' };\n  }\n\n  // ============================================================================\n  // Lifecycle\n  // ============================================================================\n\n  async onModuleInit(): Promise<void> {\n    this.polling = true;\n    this.schedulePoll();\n\n    // LISTEN-NOTIFY-1 — start the wake listener ALONGSIDE the poll timer. A\n    // notify for one of this drainer's pools triggers an immediate drain; the\n    // interval timer above stays the durability heartbeat. Startup is\n    // fire-and-forget — a connect failure self-heals via the listener's backoff.\n    if (this.opts.listenNotify) {\n      const pool = (this.db as unknown as { $client?: unknown }).$client;\n      if (!pool || typeof (pool as { connect?: unknown }).connect !== 'function') {\n        this.logger.warn(\n          `listen_notify enabled but the Drizzle client exposes no pg Pool ` +\n            `($client.connect missing) — falling back to interval polling only.`,\n        );\n      } else {\n        this.notifyListener = new PgNotifyListener({\n          channel: EVENTS_WAKE_CHANNEL,\n          pool: pool as { connect(): Promise<never> },\n          label: 'events',\n          onNotify: (payload) => this.onWake(payload),\n        });\n        await this.notifyListener.start();\n      }\n    }\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    this.polling = false;\n    if (this.pollTimer) {\n      clearTimeout(this.pollTimer);\n      this.pollTimer = null;\n    }\n    if (this.notifyListener) {\n      try {\n        await this.notifyListener.stop();\n      } catch (err) {\n        this.logger.error(`notify listener stop failed: ${err}`);\n      }\n      this.notifyListener = null;\n    }\n  }\n\n  /**\n   * Wake handler — a `codegen_events_wake` notification arrived. A pool-filtered\n   * drainer (`opts.pools` set) ignores payloads naming a pool it doesn't own; an\n   * all-pools drainer wakes for any. Debounced: a notify mid-drain just flags a\n   * re-check so a burst collapses to at most one extra drain (D3).\n   */\n  private onWake(payload: string): void {\n    if (!this.polling) return;\n    const pools = this.opts.pools;\n    if (pools && pools.length > 0 && !pools.includes(payload)) return;\n    if (this.wakeDraining) {\n      this.wakeRecheckPending = true;\n      return;\n    }\n    void this.drainOnWake();\n  }\n\n  private async drainOnWake(): Promise<void> {\n    this.wakeDraining = true;\n    try {\n      do {\n        this.wakeRecheckPending = false;\n        await this.processBatch();\n      } while (this.wakeRecheckPending && this.polling);\n    } catch (err) {\n      this.logger.error(`wake drain error: ${err}`);\n    } finally {\n      this.wakeDraining = false;\n    }\n  }\n\n  // ============================================================================\n  // IEventBus\n  // ============================================================================\n\n  async publish(event: DomainEvent, tx?: DrizzleTransaction): Promise<void> {\n    const client = (tx ?? this.db) as DrizzleClient;\n    const multiTenant = this.opts.multiTenant ?? false;\n    const values = toInsertValues(event, multiTenant);\n    await client.insert(domainEvents).values(values);\n    // LISTEN-NOTIFY-1 — wake the drainer on commit (D2: emitted through the same\n    // `client`, so a rolled-back publish emits no phantom wake). The pool is the\n    // payload; the drainer re-runs its own pool-filtered claim on wake.\n    await this.emitWakeNotify(client, [values.pool]);\n  }\n\n  async publishMany(events: DomainEvent[], tx?: DrizzleTransaction): Promise<void> {\n    if (events.length === 0) return;\n    const client = (tx ?? this.db) as DrizzleClient;\n    const multiTenant = this.opts.multiTenant ?? false;\n    const valuesList = events.map((e) => toInsertValues(e, multiTenant));\n    await client.insert(domainEvents).values(valuesList);\n    // De-dup pools so a batch into one lane emits a single wake.\n    await this.emitWakeNotify(client, valuesList.map((v) => v.pool));\n  }\n\n  /**\n   * Emit one in-tx `pg_notify(codegen_events_wake, <pool>)` per distinct pool in\n   * the just-inserted batch. No-op unless `listenNotify` is on. Best-effort: a\n   * notify failure is non-fatal (interval polling still drains the rows), so we\n   * log + swallow rather than failing the publish.\n   */\n  private async emitWakeNotify(\n    client: DrizzleClient,\n    pools: Array<string | null>,\n  ): Promise<void> {\n    if (!this.opts.listenNotify) return;\n    const distinct = new Set(pools.map((p) => p ?? ''));\n    for (const pool of distinct) {\n      try {\n        await pgNotify(client, EVENTS_WAKE_CHANNEL, pool);\n      } catch (err) {\n        this.logger.warn(\n          `pg_notify(${EVENTS_WAKE_CHANNEL}, '${pool}') failed: ${err} ` +\n            `(non-fatal — interval polling still drains the outbox).`,\n        );\n      }\n    }\n  }\n\n  async findById(eventId: string): Promise<DomainEvent | null> {\n    const rows = await this.db\n      .select()\n      .from(domainEvents)\n      .where(eq(domainEvents.id, eventId))\n      .limit(1);\n    const row = rows[0];\n    if (!row) return null;\n    return {\n      id: row.id,\n      type: row.type,\n      aggregateId: row.aggregateId,\n      aggregateType: row.aggregateType,\n      payload: row.payload as Record<string, unknown>,\n      occurredAt:\n        row.occurredAt instanceof Date\n          ? row.occurredAt\n          : new Date(row.occurredAt as unknown as string),\n      metadata: (row.metadata ?? undefined) as\n        | Record<string, unknown>\n        | undefined,\n    };\n  }\n\n  subscribe<T extends DomainEvent = DomainEvent>(\n    eventType: string,\n    handler: (event: T) => Promise<void>,\n  ): () => void {\n    if (!this.handlers.has(eventType)) {\n      this.handlers.set(eventType, new Set());\n    }\n    const set = this.handlers.get(eventType)!;\n    const h = handler as (event: DomainEvent) => Promise<void>;\n    set.add(h);\n    return () => {\n      set.delete(h);\n    };\n  }\n\n  // ============================================================================\n  // ADR-039 — scheduled-event materialisation (time as an event source)\n  // ============================================================================\n\n  /**\n   * Insert one scheduled tick event idempotently. The slot key is stamped onto\n   * `metadata.scheduleSlot`; `ON CONFLICT DO NOTHING` against the partial UNIQUE\n   * expression index `idx_domain_events_schedule_slot` makes a duplicate insert\n   * a no-op — the DB constraint is the exactly-one-event-per-slot invariant.\n   *\n   * Reuses the standard outbox row shape (pool/direction/metadata) so the\n   * existing drain carries the tick like any other event. A LISTEN/NOTIFY wake\n   * fires for an immediately-due tick (boot/catch-up rows whose slot is already\n   * in the past); a future slot is claimed by polling once `occurred_at` passes.\n   */\n  async materializeScheduledEvent(\n    spec: ScheduledEventSpec,\n  ): Promise<{ created: boolean }> {\n    const multiTenant = this.opts.multiTenant ?? false;\n    const metadata: Record<string, unknown> = {\n      pool: spec.pool,\n      direction: spec.direction,\n      scheduleSlot: spec.slotKey,\n      triggerSource: 'schedule',\n    };\n    const base = {\n      id: randomUUID(),\n      type: spec.type,\n      // Payload-free scheduled fact (the dealbrain strict-producer pattern).\n      aggregateId: spec.type,\n      aggregateType: spec.type,\n      payload: {} as Record<string, unknown>,\n      occurredAt: spec.slotStart,\n      processedAt: null,\n      status: 'pending' as const,\n      metadata,\n      pool: spec.pool,\n      direction: spec.direction,\n      tier: 'domain' as const,\n    };\n    const values = multiTenant ? { ...base, tenantId: null } : base;\n\n    // The idempotency guard is the partial UNIQUE expression index\n    // `idx_domain_events_schedule_slot` on (type, metadata->>'scheduleSlot').\n    // Use a BARE (no-target) `ON CONFLICT DO NOTHING`: Drizzle 0.45's typed\n    // `onConflictDoNothing({ target })` only accepts columns so it can't NAME\n    // the expression index, but the no-arg form emits target-less\n    // `ON CONFLICT DO NOTHING`, which Postgres applies to ANY unique\n    // constraint/index — including this expression index. `.returning({ id })`\n    // then gives us the rowcount discriminator: zero rows back == the slot was\n    // already materialised (DO NOTHING fired), so `created: false`. This keeps\n    // the happy path off the exception channel — a repeat materialise no longer\n    // raises SQLSTATE 23505, so Postgres logs no scary `duplicate key value\n    // violates unique constraint` ERROR line on every colliding boot/tick.\n    //\n    // The unique-violation catch is retained as a fallback for the genuine\n    // concurrent-insert race window (two sessions clear the conflict check and\n    // both attempt the insert in the same instant) and for backends whose\n    // driver surfaces a 23505 rather than honouring DO NOTHING; in both cases\n    // it collapses to the same `created: false` no-op.\n    let inserted: Array<{ id: string }>;\n    try {\n      inserted = await this.db\n        .insert(domainEvents)\n        .values(values)\n        .onConflictDoNothing()\n        .returning({ id: domainEvents.id });\n    } catch (err) {\n      if (isUniqueViolation(err)) return { created: false };\n      throw err;\n    }\n    if (inserted.length === 0) return { created: false };\n\n    // Wake the drainer for an already-due tick. A future slot waits for polling.\n    if (spec.slotStart.getTime() <= Date.now()) {\n      await this.emitWakeNotify(this.db, [spec.pool]);\n    }\n    return { created: true };\n  }\n\n  /** Most recent scheduled tick's `occurred_at` (epoch ms) for `type`, or null.\n   *  Read by the scheduler's catch-up backfill. */\n  async lastScheduledSlotMs(type: string): Promise<number | null> {\n    const rows = await this.db\n      .select({ occurredAt: domainEvents.occurredAt })\n      .from(domainEvents)\n      .where(\n        and(\n          eq(domainEvents.type, type),\n          sql`${domainEvents.metadata} ->> 'triggerSource' = 'schedule'`,\n        ),\n      )\n      .orderBy(desc(domainEvents.occurredAt))\n      .limit(1);\n    const row = rows[0];\n    if (!row?.occurredAt) return null;\n    return row.occurredAt instanceof Date\n      ? row.occurredAt.getTime()\n      : new Date(row.occurredAt as unknown as string).getTime();\n  }\n\n  // ============================================================================\n  // IEventReadPort (OBS-LIST-1)\n  // ============================================================================\n\n  async listEvents(query: ListEventsQuery = {}): Promise<EventPage> {\n    const limit = clampEventLimit(query.limit);\n    const conditions: SQL<unknown>[] = [];\n\n    if (query.poolId) conditions.push(eq(domainEvents.pool, query.poolId));\n    if (query.direction)\n      conditions.push(eq(domainEvents.direction, query.direction));\n    if (query.since) conditions.push(gte(domainEvents.occurredAt, query.since));\n    if (query.rootRunId) {\n      // Filter on the JSON correlation id: metadata->>'rootRunId'.\n      conditions.push(\n        sql`${domainEvents.metadata}->>'rootRunId' = ${query.rootRunId}`,\n      );\n    }\n    // EVT-8: `tenant_id` is a scaffold-time conditional column (emitted only\n    // under `events.multi_tenant: true`). Guard the filter behind the same\n    // `multiTenant` flag, and read the column structurally so this backend\n    // typechecks against both the multi-tenant schema (column present) and\n    // the single-tenant schema (column absent). When multi-tenancy is off\n    // there is no `tenant_id` column to filter on.\n    if (this.opts.multiTenant && query.tenantId !== undefined) {\n      const tenantIdColumn = (\n        domainEvents as unknown as { tenantId: typeof domainEvents.pool }\n      ).tenantId;\n      conditions.push(\n        query.tenantId === null\n          ? (sql`${tenantIdColumn} is null` as SQL<unknown>)\n          : eq(tenantIdColumn, query.tenantId),\n      );\n    }\n\n    // Keyset seek: WHERE (occurred_at, id) < (cursorOccurredAt, cursorId).\n    if (query.cursor) {\n      const keyset = decodeEventCursor(query.cursor);\n      if (keyset) {\n        conditions.push(\n          or(\n            lt(domainEvents.occurredAt, keyset.occurredAt),\n            and(\n              eq(domainEvents.occurredAt, keyset.occurredAt),\n              lt(domainEvents.id, keyset.id),\n            ),\n          )!,\n        );\n      }\n    }\n\n    const rows = (await this.db\n      .select()\n      .from(domainEvents)\n      .where(conditions.length > 0 ? and(...conditions) : undefined)\n      .orderBy(desc(domainEvents.occurredAt), desc(domainEvents.id))\n      .limit(limit + 1)) as DomainEventRecord[];\n\n    const hasMore = rows.length > limit;\n    const page = hasMore ? rows.slice(0, limit) : rows;\n    const items = page.map(toEventSummary);\n    const last = page[page.length - 1];\n    const nextCursor =\n      hasMore && last\n        ? encodeEventCursor({ occurredAt: last.occurredAt, id: last.id })\n        : null;\n\n    return { items, nextCursor };\n  }\n\n  // ============================================================================\n  // Polling\n  // ============================================================================\n\n  /**\n   * Test-only hook. Runs exactly one drain cycle and returns. Production\n   * code goes through `onModuleInit` → `schedulePoll`, which calls the\n   * same `processBatch` under a timer.\n   */\n  async drainOnce(): Promise<void> {\n    await this.processBatch();\n  }\n\n  private schedulePoll(): void {\n    if (!this.polling) return;\n    this.pollTimer = setTimeout(async () => {\n      try {\n        await this.processBatch();\n      } catch (err) {\n        this.logger.error(`Poll cycle error: ${err}`);\n      } finally {\n        this.schedulePoll();\n      }\n    }, POLL_INTERVAL_MS);\n  }\n\n  /**\n   * Drain one batch (BRIDGE-4 restructure of EVT-4).\n   *\n   * Two-phase per drained event:\n   *\n   *   1. **Per-event transaction** — bridge fanout (`bridgeHook.processEvent`)\n   *      + `processed_at` stamp. Both write through the same `tx`. A throw\n   *      inside the tx (only infra-level failures should reach here, since\n   *      the hook tolerates null direction and registry misses inline)\n   *      rolls back the bridge inserts AND the `processed_at` stamp; the\n   *      event re-claims on the next drain cycle. Bridge `UNIQUE\n   *      (event_id, trigger_id)` makes the retry idempotent.\n   *\n   *   2. **After commit** — dispatch in-process subscribers (`IEventBus.subscribe`\n   *      handlers). This deliberately runs OUTSIDE the per-event tx (lead\n   *      decision 2026-04-22): subscribers are best-effort and must not\n   *      gate forward progress or roll back bridge fanout. Subscriber\n   *      errors are caught + logged; `processed_at` is already committed.\n   *      The old `MAX_RETRIES=3` in-process retry loop and the\n   *      `failed`-stamping path were removed in BRIDGE-4 along with their\n   *      coupling.\n   *\n   * The `processed_at` UPDATE carries `AND status='pending'` (BRIDGE-4\n   * tightening — without it, a hypothetical double-claim could double-stamp\n   * the timestamp). The per-event tx + `FOR UPDATE SKIP LOCKED` claim\n   * make this defensive belt-and-suspenders.\n   */\n  private async processBatch(): Promise<void> {\n    const pools = this.opts.pools;\n\n    // Build WHERE: status='pending' [AND pool IN (...)]\n    const whereClause: SQL<unknown> = pools && pools.length > 0\n      ? (and(eq(domainEvents.status, 'pending'), inArray(domainEvents.pool, pools)) as SQL<unknown>)\n      : eq(domainEvents.status, 'pending');\n\n    // Claim a batch with FOR UPDATE SKIP LOCKED so multiple pollers don't\n    // double-dispatch. The lock is released when the outer transaction\n    // commits — which is fine because the immediately-following per-event\n    // tx flips status='processed' under its own `AND status='pending'`\n    // guard, so a re-claim of the same row in a subsequent batch is a\n    // no-op UPDATE.\n    const rows = await this.db.transaction(async (tx) => {\n      return tx\n        .select()\n        .from(domainEvents)\n        .where(whereClause)\n        .orderBy(asc(domainEvents.occurredAt))\n        .limit(POLL_BATCH_SIZE)\n        .for('update', { skipLocked: true });\n    }) as Array<typeof domainEvents.$inferSelect>;\n\n    for (const row of rows) {\n      const event: DomainEvent = {\n        id: row.id,\n        type: row.type,\n        aggregateId: row.aggregateId,\n        aggregateType: row.aggregateType,\n        payload: row.payload as Record<string, unknown>,\n        occurredAt: row.occurredAt instanceof Date ? row.occurredAt : new Date(row.occurredAt as unknown as string),\n        metadata: (row.metadata ?? undefined) as Record<string, unknown> | undefined,\n      };\n\n      // Phase 1 — per-event tx: bridge fanout + processed_at stamp.\n      try {\n        await this.db.transaction(async (tx) => {\n          if (this.bridgeHook) {\n            await this.bridgeHook.processEvent(event, tx);\n          }\n          await tx\n            .update(domainEvents)\n            .set({ status: 'processed', processedAt: new Date() })\n            .where(\n              and(\n                eq(domainEvents.id, event.id),\n                eq(domainEvents.status, 'pending'),\n              ),\n            );\n        });\n      } catch (err) {\n        // Infra-level failure inside the per-event tx — bridge inserts\n        // and processed_at both rolled back. Log and move on; the next\n        // drain cycle re-claims the row. UNIQUE on bridge_delivery makes\n        // the retry idempotent.\n        this.logger.error(\n          `Per-event tx failed for event id=${event.id} type=${event.type}: ${err}`,\n        );\n        continue;\n      }\n\n      // Phase 2 — best-effort subscriber dispatch. Errors are logged\n      // and discarded; processed_at is already committed. Subscribers\n      // are observability + cache-busts + small ancillary work; they\n      // must not gate forward progress.\n      try {\n        await this.dispatch(event);\n      } catch (err) {\n        this.logger.error(\n          `Subscriber dispatch failed for event id=${event.id} type=${event.type} ` +\n            `(processed_at already committed; failure does not retry): ${err}`,\n        );\n      }\n    }\n  }\n\n  private async dispatch(event: DomainEvent): Promise<void> {\n    const set = this.handlers.get(event.type);\n    if (!set) return;\n\n    let firstError: unknown;\n    for (const handler of set) {\n      try {\n        await handler(event);\n      } catch (err) {\n        this.logger.error(\n          `Handler error for event type \"${event.type}\" (id: ${event.id}): ${err}`,\n        );\n        if (firstError === undefined) {\n          firstError = err;\n        }\n      }\n    }\n\n    if (firstError !== undefined) {\n      throw firstError;\n    }\n  }\n}\n"],"mappings":"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","names":[]}