Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/packages/activity/src/logActivity.server.ts
T
2026-07-08 16:15:37 +02:00

55 lines
2.1 KiB
TypeScript

import { getDbClient } from "@hivegrid/db/client.server";
import type { Prisma } from "@hivegrid/db/prisma-browser";
import type { LogActivityInput } from "./types.js";
/**
* Minimal write surface `logActivity` needs. Satisfied by the full Prisma client
* AND by interactive-transaction clients, so callers can append an activity inside
* the same transaction as the action that triggered it.
*/
export type ActivityWriteClient = {
activity: {
create: (args: { data: Prisma.ActivityUncheckedCreateInput }) => Promise<{ id: string }>;
};
};
export type LogActivityOptions = {
/** Transaction/client to write through. Defaults to the shared db singleton. */
client?: ActivityWriteClient;
};
/**
* Append a user-facing activity to the central `Activity` stream (M045 / DoD #14).
*
* This is NOT the audit log — the tamper-evident `AuditEvent` (M001) is written
* separately (auto via Prisma middleware). `logActivity` records the human-readable,
* per-entity timeline shown to tenant users.
*/
export async function logActivity(input: LogActivityInput, options: LogActivityOptions = {}): Promise<{ id: string }> {
if (!input.tenantId) {
throw new Error("logActivity: tenantId is required");
}
if (!input.subjectId) {
throw new Error("logActivity: subjectId is required");
}
if (!input.summaryText || input.summaryText.trim().length === 0) {
throw new Error("logActivity: summaryText (Klartext-Zusammenfassung) is required");
}
const client = options.client ?? (getDbClient() as unknown as ActivityWriteClient);
return client.activity.create({
data: {
tenantId: input.tenantId,
actorUserId: input.actorUserId ?? null,
actorKind: input.actorKind,
activityType: input.activityType,
subjectType: input.subjectType,
subjectId: input.subjectId,
summaryText: input.summaryText,
relatedEntityRefs: input.relatedEntityRefs ? (input.relatedEntityRefs as unknown as Prisma.InputJsonValue) : undefined,
metadata: input.metadata ? (input.metadata as Prisma.InputJsonValue) : undefined,
},
});
}