@sixthsummit/ship-api 0.0.0-stage → 4.1.1

package/lib/app/services/DrizzleEntityService.d.ts

@@ -0,0 +1,123 @@
+import { type SQL } from "drizzle-orm";
+import type { PgColumn, PgTable } from "drizzle-orm/pg-core";
+import type { ShipDb } from "../db/client.js";
+import type { DslQueryFilter, OrderClause, QueryOptions } from "../db/QueryOptions.js";
+import { type LifecycleHookContext, type LifecycleHooks } from "./hooks/LifecycleHooks.js";
+/**
+ * Generic CRUD/list/search base for Drizzle-backed services.
+ *
+ * Replaces v3's TypeORM `EntityService<T>`. Same surface (`get`, `getAll`,
+ * `list`, `count`, etc.); abstract hooks renamed to fit Drizzle (`getTable()`
+ * instead of `getEntityClass()`).
+ *
+ * **This batch (alpha-1, sub-batch 3b)** ships the read surface: `get`,
+ * `getAll`, `list`, `count`, soft-delete filtering, free-text search across
+ * `getDefaultSearchFields()`, and lifecycle-hook integration for
+ * `beforeQuery`. Mutation methods (`create`, `update`, `delete`) and the
+ * full lifecycle pair land in sub-batch 3c.
+ *
+ * Internally uses Drizzle's `db.select().from(table)` builder so the base
+ * class is testable against a fake Drizzle-shaped client. Subclasses that
+ * need nested relations should override the read methods to delegate to
+ * `db.query.<table>.findMany(...)` — that path is opt-in until the
+ * relational-query helpers in this base class mature.
+ */
+export interface ListResult<TRow> {
+    rows: TRow[];
+    total: number;
+}
+export declare abstract class DrizzleEntityService<TTable extends PgTable, TSchema extends Record<string, unknown> = Record<string, never>> {
+    protected readonly db: ShipDb<TSchema>;
+    constructor(db: ShipDb<TSchema>);
+    /** The Drizzle table this service operates on. */
+    protected abstract getTable(): TTable;
+    /** Relation keys to load by default. Currently advisory — used in v4.0 by
+     *  subclasses that override read methods to delegate to the relational
+     *  query builder. */
+    protected getDefaultRelations(): readonly string[];
+    /** Default order for `getAll` / `list`. Override per service. */
+    protected getDefaultOrder(): readonly OrderClause[];
+    /** Column names searched by free-text `?search=...`. Override per service. */
+    protected getDefaultSearchFields(): readonly string[];
+    /** Compose lifecycle hooks for this service. Override to register hooks
+     *  alongside framework-global ones. */
+    protected getHooks(): LifecycleHooks;
+    /**
+     * Subclass-overridable hook for setting defaults / coercing optional fields
+     * before persistence (translates v3 `EntityService.applyOptionalFields`).
+     * Distinct from lifecycle hooks: this runs unconditionally per service,
+     * before any composed `beforeCreate`/`beforeUpdate` hook.
+     */
+    protected applyOptionalFields(values: unknown): Promise<unknown>;
+    /**
+     * Subclass-overridable hook for resolving "find or create by ID" relation
+     * references before INSERT (translates v3 `EntityService.handleRelationships`).
+     * Default no-op.
+     */
+    protected resolveRelationIds(values: unknown): Promise<unknown>;
+    /** Fetch by primary-key `id`. Returns null when not found. Soft-deleted
+     *  rows are hidden unless `opts.includeDeleted: true`. */
+    get(id: string, opts?: QueryOptions): Promise<unknown | null>;
+    /** Fetch all rows matching the filter (no pagination). Default order applies. */
+    getAll(opts?: QueryOptions): Promise<unknown[]>;
+    /** Paginated list — returns rows + total count under the same filter. */
+    list(opts?: QueryOptions): Promise<ListResult<unknown>>;
+    /** Count of rows matching the filter (ignores limit/offset/order). */
+    count(opts?: QueryOptions): Promise<number>;
+    /**
+     * Insert a new row.
+     * Pipeline: `applyOptionalFields` → `resolveRelationIds` → auto-stamp
+     * `createdBy` from `RequestContext.userId` if column exists →
+     * `beforeCreate` hook chain → INSERT … RETURNING * → `afterCreate` hooks.
+     */
+    create(values: unknown): Promise<unknown>;
+    /**
+     * Update by primary-key `id` with a partial patch.
+     * Pipeline: load `prev` (404s if missing) → auto-stamp `updatedBy` →
+     * `beforeUpdate` hook chain (receives `prev` + `patch`) → UPDATE …
+     * RETURNING * → `afterUpdate` hooks (receive `prev` + `next` for diffing).
+     *
+     * `prev` is loaded *before* the write so audit / CDC consumers can compute
+     * diffs reliably even on tables without history triggers.
+     */
+    update(id: string, patch: unknown): Promise<unknown>;
+    /**
+     * Delete by primary-key `id`.
+     * Pipeline: load `prev` (404s if missing) → `beforeDelete` (may throw to
+     * abort) → soft-delete (UPDATE deleted_at = now() + updatedBy) when the
+     * table has a `deletedAt` column, otherwise hard DELETE → `afterDelete`.
+     */
+    delete(id: string): Promise<unknown>;
+    /**
+     * Compose user-filter + scoped clause + soft-delete clause into one `AND`
+     * expression. `undefined` when nothing applies.
+     */
+    protected composeWhere(userFilter: DslQueryFilter | undefined, extra: SQL | undefined, includeDeleted?: boolean): SQL | undefined;
+    /**
+     * Build a free-text search expression OR'ing `ilike '%query%'` across
+     * the columns returned by `getDefaultSearchFields()`. Returns `undefined`
+     * when there are no search fields or no query.
+     */
+    protected searchExpr(query: string | undefined): SQL | undefined;
+    /**
+     * Translate `OrderClause[]` into Drizzle `orderBy(...)` arguments. Falls
+     * back to `getDefaultOrder()` when the caller provides nothing.
+     */
+    protected resolveOrder(order: readonly OrderClause[] | undefined): SQL[];
+    /** Walk the configured hooks' `beforeQuery` (if any) over the user filter. */
+    protected runBeforeQuery(filter: DslQueryFilter | undefined): Promise<DslQueryFilter | undefined>;
+    /**
+     * Look up a column by property name on the configured table. Returns
+     * `undefined` for unknown names (callers should treat this as "skip").
+     */
+    protected getColumn(name: string): PgColumn | undefined;
+    /** Span-name prefix per service (override if you want a custom one). */
+    protected spanName(): string;
+    /**
+     * Auto-stamp `createdBy` / `updatedBy` from `RequestContext.userId` if the
+     * column exists on the table and the value isn't already set on the input.
+     * Returns a new object — does not mutate `values`.
+     */
+    protected stampActor(values: unknown, column: "createdBy" | "updatedBy", ctx: LifecycleHookContext): unknown;
+}
+//# sourceMappingURL=DrizzleEntityService.d.ts.map

package/lib/app/services/DrizzleEntityService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrizzleEntityService.d.ts","sourceRoot":"","sources":["../../../src/app/services/DrizzleEntityService.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,KAAK,GAAG,EAET,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAK7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,UAAU,CAAC,IAAI;IAC9B,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,8BAAsB,oBAAoB,CACxC,MAAM,SAAS,OAAO,EACtB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEnD,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC;gBAAnB,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC;IAIlD,kDAAkD;IAClD,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,MAAM;IAErC;;yBAEqB;IACrB,SAAS,CAAC,mBAAmB,IAAI,SAAS,MAAM,EAAE;IAIlD,iEAAiE;IACjE,SAAS,CAAC,eAAe,IAAI,SAAS,WAAW,EAAE;IAInD,8EAA8E;IAC9E,SAAS,CAAC,sBAAsB,IAAI,SAAS,MAAM,EAAE;IAIrD;2CACuC;IACvC,SAAS,CAAC,QAAQ,IAAI,cAAc;IAIpC;;;;;OAKG;cACa,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAItE;;;;OAIG;cACa,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAMrE;8DAC0D;IACpD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAqBvE,iFAAiF;IAC3E,MAAM,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA0BzD,yEAAyE;IACnE,IAAI,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAUjE,sEAAsE;IAChE,KAAK,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBrD;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B/C;;;;;;;;OAQG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAqC1D;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoD1C;;;OAGG;IACH,SAAS,CAAC,YAAY,CACpB,UAAU,EAAE,cAAc,GAAG,SAAS,EACtC,KAAK,EAAE,GAAG,GAAG,SAAS,EACtB,cAAc,UAAQ,GACrB,GAAG,GAAG,SAAS;IAiBlB;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS;IAehE;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,GAAG,GAAG,EAAE;IAexE,8EAA8E;cAC9D,cAAc,CAC5B,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAStC;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAQvD,wEAAwE;IACxE,SAAS,CAAC,QAAQ,IAAI,MAAM;IAI5B;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAClB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,WAAW,GAAG,WAAW,EACjC,GAAG,EAAE,oBAAoB,GACxB,OAAO;CAUX"}

package/lib/app/services/DrizzleEntityService.js

@@ -0,0 +1,342 @@
+import { and, asc, count as countAggregate, desc, eq, ilike, isNull, or, } from "drizzle-orm";
+import { NotFoundError } from "../../http/errors/NotFoundError.js";
+import { withSpan } from "../../observability/tracing.js";
+import { getRequestContext } from "../context/RequestContext.js";
+import { buildWhere } from "../db/buildWhere.js";
+import { composeHooks, } from "./hooks/LifecycleHooks.js";
+/** Fallback default order: newest first by `createdAt`. */
+const DEFAULT_ORDER = [{ field: "createdAt", direction: "desc" }];
+export class DrizzleEntityService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Relation keys to load by default. Currently advisory — used in v4.0 by
+     *  subclasses that override read methods to delegate to the relational
+     *  query builder. */
+    getDefaultRelations() {
+        return [];
+    }
+    /** Default order for `getAll` / `list`. Override per service. */
+    getDefaultOrder() {
+        return DEFAULT_ORDER;
+    }
+    /** Column names searched by free-text `?search=...`. Override per service. */
+    getDefaultSearchFields() {
+        return [];
+    }
+    /** Compose lifecycle hooks for this service. Override to register hooks
+     *  alongside framework-global ones. */
+    getHooks() {
+        return {};
+    }
+    /**
+     * Subclass-overridable hook for setting defaults / coercing optional fields
+     * before persistence (translates v3 `EntityService.applyOptionalFields`).
+     * Distinct from lifecycle hooks: this runs unconditionally per service,
+     * before any composed `beforeCreate`/`beforeUpdate` hook.
+     */
+    async applyOptionalFields(values) {
+        return values;
+    }
+    /**
+     * Subclass-overridable hook for resolving "find or create by ID" relation
+     * references before INSERT (translates v3 `EntityService.handleRelationships`).
+     * Default no-op.
+     */
+    async resolveRelationIds(values) {
+        return values;
+    }
+    // ────────────────────────────── Read API ───────────────────────────────
+    /** Fetch by primary-key `id`. Returns null when not found. Soft-deleted
+     *  rows are hidden unless `opts.includeDeleted: true`. */
+    async get(id, opts = {}) {
+        return withSpan(`${this.spanName()}.get`, async () => {
+            const table = this.getTable();
+            const idColumn = this.getColumn("id");
+            if (!idColumn) {
+                throw new Error(`${this.constructor.name}: getTable() must expose an "id" column`);
+            }
+            const userFilter = await this.runBeforeQuery(opts.where);
+            const where = this.composeWhere(userFilter, eq(idColumn, id), opts.includeDeleted);
+            const rows = (await this.db
+                .select()
+                .from(table)
+                .where(where)
+                .limit(1));
+            return rows[0] ?? null;
+        });
+    }
+    /** Fetch all rows matching the filter (no pagination). Default order applies. */
+    async getAll(opts = {}) {
+        return withSpan(`${this.spanName()}.getAll`, async () => {
+            const table = this.getTable();
+            const userFilter = await this.runBeforeQuery(opts.where);
+            const where = this.composeWhere(userFilter, this.searchExpr(opts.search), opts.includeDeleted);
+            const order = this.resolveOrder(opts.order);
+            let q = this.db.select().from(table);
+            if (where)
+                q = q.where(where);
+            if (order.length > 0)
+                q = q.orderBy(...order);
+            if (opts.limit !== undefined)
+                q = q.limit(opts.limit);
+            if (opts.offset !== undefined)
+                q = q.offset(opts.offset);
+            return (await q);
+        });
+    }
+    /** Paginated list — returns rows + total count under the same filter. */
+    async list(opts = {}) {
+        return withSpan(`${this.spanName()}.list`, async () => {
+            const [rows, total] = await Promise.all([
+                this.getAll(opts),
+                this.count({ where: opts.where, search: opts.search, includeDeleted: opts.includeDeleted }),
+            ]);
+            return { rows, total };
+        });
+    }
+    /** Count of rows matching the filter (ignores limit/offset/order). */
+    async count(opts = {}) {
+        return withSpan(`${this.spanName()}.count`, async () => {
+            const table = this.getTable();
+            const userFilter = await this.runBeforeQuery(opts.where);
+            const where = this.composeWhere(userFilter, this.searchExpr(opts.search), opts.includeDeleted);
+            let q = this.db.select({ value: countAggregate() }).from(table);
+            if (where)
+                q = q.where(where);
+            const rows = await q;
+            const v = rows[0]?.value ?? 0;
+            return typeof v === "string" ? Number.parseInt(v, 10) : v;
+        });
+    }
+    // ───────────────────────────── Mutate API ─────────────────────────────
+    /**
+     * Insert a new row.
+     * Pipeline: `applyOptionalFields` → `resolveRelationIds` → auto-stamp
+     * `createdBy` from `RequestContext.userId` if column exists →
+     * `beforeCreate` hook chain → INSERT … RETURNING * → `afterCreate` hooks.
+     */
+    async create(values) {
+        return withSpan(`${this.spanName()}.create`, async () => {
+            const ctx = (getRequestContext() ?? {});
+            const composed = composeHooks(this.getHooks());
+            let prepared = await this.applyOptionalFields(values);
+            prepared = await this.resolveRelationIds(prepared);
+            prepared = this.stampActor(prepared, "createdBy", ctx);
+            const beforeResult = await composed.beforeCreate?.(prepared, ctx);
+            if (beforeResult !== undefined)
+                prepared = beforeResult;
+            const inserted = (await this.db
+                .insert(this.getTable())
+                .values(prepared)
+                .returning());
+            const row = inserted[0];
+            if (row === undefined) {
+                throw new Error(`${this.constructor.name}.create: INSERT returned no rows`);
+            }
+            await composed.afterCreate?.(row, ctx);
+            return row;
+        });
+    }
+    /**
+     * Update by primary-key `id` with a partial patch.
+     * Pipeline: load `prev` (404s if missing) → auto-stamp `updatedBy` →
+     * `beforeUpdate` hook chain (receives `prev` + `patch`) → UPDATE …
+     * RETURNING * → `afterUpdate` hooks (receive `prev` + `next` for diffing).
+     *
+     * `prev` is loaded *before* the write so audit / CDC consumers can compute
+     * diffs reliably even on tables without history triggers.
+     */
+    async update(id, patch) {
+        return withSpan(`${this.spanName()}.update`, async () => {
+            const ctx = (getRequestContext() ?? {});
+            const composed = composeHooks(this.getHooks());
+            const prev = await this.get(id);
+            if (prev === null) {
+                throw new NotFoundError(`${this.constructor.name}: id "${id}" not found`);
+            }
+            let prepared = this.stampActor(patch, "updatedBy", ctx);
+            const beforeResult = await composed.beforeUpdate?.(prev, prepared, ctx);
+            if (beforeResult !== undefined)
+                prepared = beforeResult;
+            const idColumn = this.getColumn("id");
+            if (!idColumn) {
+                throw new Error(`${this.constructor.name}: getTable() must expose an "id" column`);
+            }
+            const updated = (await this.db
+                .update(this.getTable())
+                .set(prepared)
+                .where(eq(idColumn, id))
+                .returning());
+            const next = updated[0];
+            if (next === undefined) {
+                // Row vanished between the get() and the UPDATE — race condition.
+                throw new NotFoundError(`${this.constructor.name}: id "${id}" disappeared during update`);
+            }
+            await composed.afterUpdate?.(prev, next, ctx);
+            return next;
+        });
+    }
+    /**
+     * Delete by primary-key `id`.
+     * Pipeline: load `prev` (404s if missing) → `beforeDelete` (may throw to
+     * abort) → soft-delete (UPDATE deleted_at = now() + updatedBy) when the
+     * table has a `deletedAt` column, otherwise hard DELETE → `afterDelete`.
+     */
+    async delete(id) {
+        return withSpan(`${this.spanName()}.delete`, async () => {
+            const ctx = (getRequestContext() ?? {});
+            const composed = composeHooks(this.getHooks());
+            const prev = await this.get(id);
+            if (prev === null) {
+                throw new NotFoundError(`${this.constructor.name}: id "${id}" not found`);
+            }
+            await composed.beforeDelete?.(prev, ctx);
+            const idColumn = this.getColumn("id");
+            if (!idColumn) {
+                throw new Error(`${this.constructor.name}: getTable() must expose an "id" column`);
+            }
+            const deletedAtCol = this.getColumn("deletedAt");
+            let row;
+            if (deletedAtCol) {
+                // Soft delete
+                const updates = { deletedAt: new Date() };
+                if (ctx.userId !== undefined && this.getColumn("updatedBy")) {
+                    updates.updatedBy = ctx.userId;
+                }
+                const result = (await this.db
+                    .update(this.getTable())
+                    .set(updates)
+                    .where(eq(idColumn, id))
+                    .returning());
+                row = result[0];
+            }
+            else {
+                // Hard delete
+                const result = (await this.db
+                    .delete(this.getTable())
+                    .where(eq(idColumn, id))
+                    .returning());
+                row = result[0];
+            }
+            if (row === undefined) {
+                throw new NotFoundError(`${this.constructor.name}: id "${id}" disappeared during delete`);
+            }
+            await composed.afterDelete?.(row, ctx);
+            return row;
+        });
+    }
+    // ──────────────────────────── Helpers ──────────────────────────────────
+    /**
+     * Compose user-filter + scoped clause + soft-delete clause into one `AND`
+     * expression. `undefined` when nothing applies.
+     */
+    composeWhere(userFilter, extra, includeDeleted = false) {
+        const parts = [];
+        const userExpr = buildWhere(this.getTable(), userFilter);
+        if (userExpr)
+            parts.push(userExpr);
+        if (extra)
+            parts.push(extra);
+        if (!includeDeleted) {
+            const deletedAt = this.getColumn("deletedAt");
+            if (deletedAt)
+                parts.push(isNull(deletedAt));
+        }
+        if (parts.length === 0)
+            return undefined;
+        if (parts.length === 1)
+            return parts[0];
+        return and(...parts);
+    }
+    /**
+     * Build a free-text search expression OR'ing `ilike '%query%'` across
+     * the columns returned by `getDefaultSearchFields()`. Returns `undefined`
+     * when there are no search fields or no query.
+     */
+    searchExpr(query) {
+        if (!query)
+            return undefined;
+        const fields = this.getDefaultSearchFields();
+        if (fields.length === 0)
+            return undefined;
+        const like = `%${query}%`;
+        const exprs = [];
+        for (const name of fields) {
+            const col = this.getColumn(name);
+            if (col)
+                exprs.push(ilike(col, like));
+        }
+        if (exprs.length === 0)
+            return undefined;
+        if (exprs.length === 1)
+            return exprs[0];
+        return or(...exprs);
+    }
+    /**
+     * Translate `OrderClause[]` into Drizzle `orderBy(...)` arguments. Falls
+     * back to `getDefaultOrder()` when the caller provides nothing.
+     */
+    resolveOrder(order) {
+        const clauses = order && order.length > 0 ? order : this.getDefaultOrder();
+        const result = [];
+        for (const clause of clauses) {
+            const col = this.getColumn(clause.field);
+            if (!col)
+                continue;
+            const direction = clause.direction === "asc" ? asc(col) : desc(col);
+            // OrderClause's `nulls` is informational; Drizzle's asc/desc helpers
+            // don't expose nulls-first/last today. Subclasses override
+            // `getDefaultOrder()` and use raw `sql` if they need it.
+            result.push(direction);
+        }
+        return result;
+    }
+    /** Walk the configured hooks' `beforeQuery` (if any) over the user filter. */
+    async runBeforeQuery(filter) {
+        const hooks = this.getHooks();
+        if (!hooks.beforeQuery)
+            return filter;
+        const ctx = (getRequestContext() ?? {});
+        const composed = composeHooks(hooks);
+        const result = await composed.beforeQuery((filter ?? {}), ctx);
+        return (result ?? filter);
+    }
+    /**
+     * Look up a column by property name on the configured table. Returns
+     * `undefined` for unknown names (callers should treat this as "skip").
+     */
+    getColumn(name) {
+        const table = this.getTable();
+        const candidate = table[name];
+        if (!candidate)
+            return undefined;
+        if (typeof candidate.name !== "string")
+            return undefined;
+        return candidate;
+    }
+    /** Span-name prefix per service (override if you want a custom one). */
+    spanName() {
+        return this.constructor.name;
+    }
+    /**
+     * Auto-stamp `createdBy` / `updatedBy` from `RequestContext.userId` if the
+     * column exists on the table and the value isn't already set on the input.
+     * Returns a new object — does not mutate `values`.
+     */
+    stampActor(values, column, ctx) {
+        if (ctx.userId === undefined)
+            return values;
+        if (!this.getColumn(column))
+            return values;
+        if (typeof values !== "object" || values === null || Array.isArray(values)) {
+            return values;
+        }
+        const obj = values;
+        if (obj[column] !== undefined && obj[column] !== null)
+            return values;
+        return { ...obj, [column]: ctx.userId };
+    }
+}
+//# sourceMappingURL=DrizzleEntityService.js.map

package/lib/app/services/DrizzleEntityService.js.map

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

package/lib/app/services/RedisProvider.d.ts

@@ -0,0 +1,52 @@
+import { Redis, type RedisOptions } from "ioredis";
+import { logger as defaultLogger } from "../../observability/logger.js";
+/**
+ * Connection-lifecycle wrapper around an ioredis client.
+ *
+ * One instance per service process; passed into `RedisCache`, `rateLimit`,
+ * `idempotency`, and BullMQ producers/workers. The connection is **lazy** —
+ * nothing happens until the first command, so unit tests that import code
+ * referencing the provider don't accidentally try to dial Redis.
+ *
+ * Configured per BullMQ's hard requirement (`maxRetriesPerRequest: null`)
+ * so the same client can drive both Cache and BullMQ. `enableReadyCheck`
+ * kept on so failures surface promptly via `/readyz` rather than as
+ * mysterious slow timeouts.
+ *
+ * Errors are logged via the framework pino logger but never crash the
+ * process — degraded operation is the framework default. `/readyz` (in
+ * a later batch) reports the unhealthy state so the load balancer pulls
+ * the pod out of rotation.
+ */
+export interface RedisProviderOptions {
+    /** Full URL form, e.g. `redis://default:secret@host:6379/0`. */
+    url?: string;
+    /** Or piecewise. Used when `url` is not provided. */
+    host?: string;
+    port?: number;
+    password?: string;
+    username?: string;
+    db?: number;
+    tls?: boolean;
+    /** Override the framework default pino logger. */
+    logger?: typeof defaultLogger;
+    /**
+     * Override any underlying ioredis option. Use sparingly — the framework
+     * already sets the BullMQ-required values; overriding them risks subtle
+     * breakage.
+     */
+    ioredis?: Partial<RedisOptions>;
+}
+export declare class RedisProvider {
+    readonly client: Redis;
+    private readonly logger;
+    private quitting;
+    constructor(opts?: RedisProviderOptions);
+    /** Connect (no-op if already connected). Surfaced for `/readyz` use. */
+    connect(): Promise<void>;
+    /** Graceful shutdown. Idempotent. */
+    quit(): Promise<void>;
+    /** Health-check probe — used by `/readyz` (next batch). */
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=RedisProvider.d.ts.map

package/lib/app/services/RedisProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisProvider.d.ts","sourceRoot":"","sources":["../../../src/app/services/RedisProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAExE;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,aAAa,CAAC;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACjC;AAKD,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,GAAE,oBAAyB;IAuC3C,wEAAwE;IAClE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,qCAAqC;IAC/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,2DAA2D;IACrD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAQ/B"}

package/lib/app/services/RedisProvider.js

@@ -0,0 +1,75 @@
+import { Redis } from "ioredis";
+import { logger as defaultLogger } from "../../observability/logger.js";
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_PORT = 6379;
+export class RedisProvider {
+    client;
+    logger;
+    quitting = false;
+    constructor(opts = {}) {
+        this.logger = opts.logger ?? defaultLogger;
+        const baseOptions = {
+            lazyConnect: true,
+            enableReadyCheck: true,
+            // BullMQ hard requirement: workers use blocking commands, so a
+            // bounded retry count would orphan jobs. Keep null. (BullMQ v5
+            // throws a clear error if this is anything else.)
+            maxRetriesPerRequest: null,
+            ...opts.ioredis,
+        };
+        if (opts.url) {
+            this.client = new Redis(opts.url, baseOptions);
+        }
+        else {
+            this.client = new Redis({
+                host: opts.host ?? DEFAULT_HOST,
+                port: opts.port ?? DEFAULT_PORT,
+                password: opts.password,
+                username: opts.username,
+                db: opts.db,
+                tls: opts.tls ? {} : undefined,
+                ...baseOptions,
+            });
+        }
+        this.client.on("error", (err) => {
+            // Silence the noisy "client lost connection during shutdown" path;
+            // log everything else.
+            if (this.quitting)
+                return;
+            this.logger.warn({ err }, "redis.error");
+        });
+        this.client.on("ready", () => {
+            this.logger.info("redis.ready");
+        });
+    }
+    /** Connect (no-op if already connected). Surfaced for `/readyz` use. */
+    async connect() {
+        if (this.client.status === "ready" || this.client.status === "connecting")
+            return;
+        await this.client.connect();
+    }
+    /** Graceful shutdown. Idempotent. */
+    async quit() {
+        if (this.quitting)
+            return;
+        this.quitting = true;
+        try {
+            await this.client.quit();
+        }
+        catch (err) {
+            // ioredis throws if the client is already disconnected; swallow.
+            this.logger.debug({ err }, "redis.quit.swallowed");
+        }
+    }
+    /** Health-check probe — used by `/readyz` (next batch). */
+    async ping() {
+        try {
+            const reply = await this.client.ping();
+            return reply === "PONG";
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=RedisProvider.js.map

package/lib/app/services/RedisProvider.js.map

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