Matt
221ae5784e
Bundles the prior autonomous-session output that was sitting unstaged: - Em-dash sweep across src/ + tests/ (en-dash/em-dash to hyphen, ~2280 instances) - country-flag-icons rollout (CountryFlag component, replaces emoji glyphs that never rendered on Windows; lazy-loads the 3x2 SVG index as a single chunk after the per-subpath dynamic-import approach silently failed in webpack) - Admin IA Phase 1+2: 7-domain regroup, 41 to 38 pages, /admin/berths index, redirects (ocr to ai, reports to dashboard, invitations to users), docs/admin-ia-proposal.md - Per-template email tester (registry + endpoint + UI on Email admin page) - Cancel-document mode picker (delete-from-Documenso vs keep-for-audit) - Dashboard PDF report: 25 widgets, SVG charts, date-range picker, 11 resolvers - Customize-widgets per-region sortables at xl+ (charts/rails/feed); single flat sortable below xl when the layout stacks; per-viewport saved orders - Audit doc updates capturing each shipped item - Lint fixes: react-compiler immutability in DonutChart (reduce instead of let-reassign), set-state-in-effect disables in CountryFlag and UploadForSigning preview-bytes effect, unused 'confirm' destructures in interest contract + reservation tabs, unescaped apostrophe in test-template card copy
70 lines
2.2 KiB
TypeScript
70 lines
2.2 KiB
TypeScript
import { eq, sql } from 'drizzle-orm';
|
|
import type { PgTable, PgColumn } from 'drizzle-orm/pg-core';
|
|
import { db } from './index';
|
|
|
|
/**
|
|
* Drizzle transaction client type - the argument shape `db.transaction`'s
|
|
* callback receives. Exported so service helpers that take a `tx`
|
|
* parameter can spell the type instead of falling back to `any`.
|
|
*/
|
|
export type Tx = Parameters<Parameters<typeof db.transaction>[0]>[0];
|
|
|
|
/**
|
|
* Wraps a database operation in a transaction.
|
|
* Rolls back automatically on error.
|
|
*
|
|
* @example
|
|
* const result = await withTransaction(async (tx) => {
|
|
* await tx.insert(clients).values({ ... });
|
|
* await tx.insert(interests).values({ ... });
|
|
* return result;
|
|
* });
|
|
*/
|
|
export async function withTransaction<T>(callback: (tx: typeof db) => Promise<T>): Promise<T> {
|
|
return db.transaction(callback as unknown as Parameters<typeof db.transaction>[0]) as Promise<T>;
|
|
}
|
|
|
|
/**
|
|
* Soft-deletes a record by setting `archivedAt` to now.
|
|
* The table must have an `archivedAt` JS property mapping to the
|
|
* `archived_at` column.
|
|
*
|
|
* @example
|
|
* await softDelete(clients, clients.id, clientId);
|
|
*/
|
|
export async function softDelete<TTable extends PgTable>(
|
|
table: TTable,
|
|
idColumn: PgColumn,
|
|
id: string,
|
|
): Promise<void> {
|
|
// Drizzle's `.set()` API expects the JS property name (`archivedAt`),
|
|
// not the snake-case column name. The previous version passed
|
|
// `{ archived_at: ... }` which silently produced an empty SET clause
|
|
// (Drizzle skipped the unknown property) → `UPDATE ... where ...`
|
|
// syntax error from Postgres. Caught by QA: archive an interest
|
|
// with a berth attached → 500. Same fix in restore() below.
|
|
await db
|
|
.update(table)
|
|
.set({ archivedAt: sql`now()` } as Record<string, unknown>)
|
|
.where(eq(idColumn, id));
|
|
}
|
|
|
|
/**
|
|
* Restores a soft-deleted record by clearing `archivedAt`.
|
|
* The table must have an `archivedAt` JS property mapping to the
|
|
* `archived_at` column.
|
|
*
|
|
* @example
|
|
* await restore(clients, clients.id, clientId);
|
|
*/
|
|
export async function restore<TTable extends PgTable>(
|
|
table: TTable,
|
|
idColumn: PgColumn,
|
|
id: string,
|
|
): Promise<void> {
|
|
await db
|
|
.update(table)
|
|
.set({ archivedAt: null } as Record<string, unknown>)
|
|
.where(eq(idColumn, id));
|
|
}
|