Files
Nexus/packages/api/src/router/resource-read-shared.ts
T
Hartmut b41c1d2501
CI / Architecture Guardrails (push) Successful in 2m38s
CI / Assistant Split Regression (push) Successful in 3m33s
CI / Typecheck (push) Successful in 3m51s
CI / Lint (push) Successful in 5m2s
CI / E2E Tests (push) Has been cancelled
CI / Fresh-Linux Docker Deploy (push) Has been cancelled
CI / Release Images (push) Has been cancelled
CI / Build (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
rename(phase 1): CapaKraken → Nexus across code, UI, docs, CI (#61)
rename(phase 1): CapaKraken → Nexus across code, UI, docs, CI (#61)

Co-authored-by: Hartmut Nörenberg <hn@hartmut-noerenberg.com>
Co-committed-by: Hartmut Nörenberg <hn@hartmut-noerenberg.com>
2026-05-21 16:28:40 +02:00

600 lines
18 KiB
TypeScript

import { FieldType, ResourceType } from "@nexus/shared";
import { TRPCError } from "@trpc/server";
import { z } from "zod";
import {
RESOURCE_DIRECTORY_SELECT,
RESOURCE_IDENTIFIER_DETAIL_SELECT,
RESOURCE_IDENTIFIER_SELECT,
RESOURCE_LIST_SELECT,
RESOURCE_SUMMARY_DETAIL_SELECT,
RESOURCE_SUMMARY_SELECT,
ROLE_BRIEF_SELECT,
} from "../db/selects.js";
import { buildDynamicFieldWhereClauses } from "./custom-field-filters.js";
import {
anonymizeResources,
anonymizeSearchMatches,
getAnonymizationDirectory,
resolveResourceIdsByDisplayedEids,
} from "../lib/anonymization.js";
import type { TRPCContext } from "../trpc.js";
import {
assertCanReadResource,
canReadAllResources,
type ResourceReadContext,
} from "../lib/resource-access.js";
function parseResourceCursor(
cursor: string | undefined,
): { displayName: string; id: string } | null {
if (!cursor) return null;
try {
const decoded = JSON.parse(cursor) as { displayName?: string; id?: string };
if (typeof decoded.displayName === "string" && typeof decoded.id === "string") {
return { displayName: decoded.displayName, id: decoded.id };
}
} catch {
return null;
}
return null;
}
function isBroadResourceLookupAllowed(ctx: Pick<TRPCContext, "dbUser" | "roleDefaults">): boolean {
return canReadAllResources(ctx);
}
export const ResourceDirectoryQuerySchema = z.object({
chapter: z.string().optional(),
chapters: z.array(z.string()).optional(),
isActive: z.boolean().optional().default(true),
search: z.string().optional(),
eids: z.array(z.string()).optional(),
countryIds: z.array(z.string()).optional(),
excludedCountryIds: z.array(z.string()).optional(),
includeWithoutCountry: z.boolean().optional().default(true),
resourceTypes: z.array(z.nativeEnum(ResourceType)).optional(),
excludedResourceTypes: z.array(z.nativeEnum(ResourceType)).optional(),
includeWithoutResourceType: z.boolean().optional().default(true),
rolledOff: z.boolean().optional(),
departed: z.boolean().optional(),
page: z.number().int().min(1).default(1),
limit: z.number().int().min(1).max(500).default(50),
cursor: z.string().optional(),
});
export const ResourceListQuerySchema = ResourceDirectoryQuerySchema.extend({
includeRoles: z.boolean().optional().default(false),
customFieldFilters: z
.array(
z.object({
key: z.string(),
value: z.string(),
type: z.nativeEnum(FieldType),
}),
)
.optional(),
});
export async function listStaffResources(
ctx: Pick<TRPCContext, "db">,
input: z.infer<typeof ResourceListQuerySchema>,
) {
const {
chapter,
chapters,
isActive,
search,
eids,
countryIds,
excludedCountryIds,
includeWithoutCountry,
resourceTypes,
excludedResourceTypes,
includeWithoutResourceType,
rolledOff,
departed,
page,
limit,
includeRoles,
cursor,
customFieldFilters,
} = input;
const parsedCursor = parseResourceCursor(cursor);
const cfConditions = buildDynamicFieldWhereClauses(customFieldFilters).map((dynamicFields) => ({
dynamicFields,
}));
type WhereClause = Record<string, unknown>;
const andClauses: WhereClause[] = [];
const chapterFilters = Array.from(new Set([...(chapter ? [chapter] : []), ...(chapters ?? [])]));
const directory = await getAnonymizationDirectory(ctx.db);
if (!eids) {
andClauses.push({ isActive });
}
if (eids && !directory) {
andClauses.push({ eid: { in: eids } });
}
if (chapterFilters.length === 1) {
andClauses.push({ chapter: chapterFilters[0] });
} else if (chapterFilters.length > 1) {
andClauses.push({ chapter: { in: chapterFilters } });
}
if (search && !directory) {
andClauses.push({
OR: [
{ displayName: { contains: search, mode: "insensitive" as const } },
{ eid: { contains: search, mode: "insensitive" as const } },
{ email: { contains: search, mode: "insensitive" as const } },
],
});
}
if (countryIds && countryIds.length > 0) {
const countryClauses: WhereClause[] = [{ countryId: { in: countryIds } }];
if (includeWithoutCountry) {
countryClauses.push({ countryId: null });
}
andClauses.push(countryClauses.length === 1 ? countryClauses[0]! : { OR: countryClauses });
}
if (excludedCountryIds && excludedCountryIds.length > 0) {
andClauses.push({ NOT: { countryId: { in: excludedCountryIds } } });
}
if (!includeWithoutCountry) {
andClauses.push({ NOT: { countryId: null } });
}
if (resourceTypes && resourceTypes.length > 0) {
const resourceTypeClauses: WhereClause[] = [{ resourceType: { in: resourceTypes } }];
if (includeWithoutResourceType) {
resourceTypeClauses.push({ resourceType: null });
}
andClauses.push(
resourceTypeClauses.length === 1 ? resourceTypeClauses[0]! : { OR: resourceTypeClauses },
);
}
if (excludedResourceTypes && excludedResourceTypes.length > 0) {
andClauses.push({ NOT: { resourceType: { in: excludedResourceTypes } } });
}
if (!includeWithoutResourceType) {
andClauses.push({ NOT: { resourceType: null } });
}
if (rolledOff !== undefined) {
andClauses.push({ rolledOff });
}
if (departed !== undefined) {
andClauses.push({ departed });
}
andClauses.push(...cfConditions);
const where = andClauses.length > 0 ? { AND: andClauses } : {};
if (directory) {
const rawResources = await (includeRoles
? ctx.db.resource.findMany({
where,
select: {
...RESOURCE_LIST_SELECT,
resourceRoles: {
include: { role: { select: ROLE_BRIEF_SELECT } },
},
},
orderBy: [{ displayName: "asc" }, { id: "asc" }],
})
: ctx.db.resource.findMany({
where,
select: RESOURCE_LIST_SELECT,
orderBy: [{ displayName: "asc" }, { id: "asc" }],
}));
const directoryResources = rawResources.map((resource) => ({
id: resource.id,
eid: resource.eid,
displayName: resource.displayName,
email: resource.email,
}));
const requestedIds = eids
? resolveResourceIdsByDisplayedEids(directoryResources, directory, eids)
: [];
const requestedIdSet = requestedIds.length > 0 ? new Set(requestedIds) : null;
const filteredResources = rawResources.filter((resource) => {
const alias = directory.byResourceId.get(resource.id);
if (requestedIdSet && !requestedIdSet.has(resource.id)) {
return false;
}
if (eids && eids.length > 0 && requestedIds.length === 0) {
return false;
}
if (
search &&
!anonymizeSearchMatches(
{
id: resource.id,
eid: resource.eid,
displayName: resource.displayName,
email: resource.email,
},
alias,
search,
)
) {
return false;
}
return true;
});
const anonymizedResources = anonymizeResources(filteredResources, directory).sort(
(left, right) => {
const displayNameCompare = left.displayName.localeCompare(right.displayName);
if (displayNameCompare !== 0) {
return displayNameCompare;
}
return left.id.localeCompare(right.id);
},
);
const total = anonymizedResources.length;
const afterCursor = parsedCursor
? anonymizedResources.filter(
(resource) =>
resource.displayName > parsedCursor.displayName ||
(resource.displayName === parsedCursor.displayName && resource.id > parsedCursor.id),
)
: anonymizedResources;
const skip = cursor ? 0 : (page - 1) * limit;
const paged = afterCursor.slice(skip, skip + limit + 1);
const hasMore = paged.length > limit;
const resources = hasMore ? paged.slice(0, limit) : paged;
const nextCursor = hasMore
? JSON.stringify({
displayName: resources[resources.length - 1]!.displayName,
id: resources[resources.length - 1]!.id,
})
: null;
return { resources, total, page, limit, nextCursor };
}
const skip = cursor ? 0 : (page - 1) * limit;
const orderBy = [{ displayName: "asc" as const }, { id: "asc" as const }];
const whereWithCursor = parsedCursor
? {
AND: [
...((where as { AND?: WhereClause[] }).AND ?? []),
{
OR: [
{ displayName: { gt: parsedCursor.displayName } },
{ displayName: parsedCursor.displayName, id: { gt: parsedCursor.id } },
],
},
],
}
: where;
const baseQuery = { where: whereWithCursor, skip, take: limit + 1, orderBy };
const [rawResources, total] = await Promise.all([
includeRoles
? ctx.db.resource.findMany({
...baseQuery,
select: {
...RESOURCE_LIST_SELECT,
resourceRoles: {
include: { role: { select: ROLE_BRIEF_SELECT } },
},
},
})
: ctx.db.resource.findMany({
...baseQuery,
select: RESOURCE_LIST_SELECT,
}),
ctx.db.resource.count({ where }),
]);
const hasMore = rawResources.length > limit;
const resources = hasMore ? rawResources.slice(0, limit) : rawResources;
const nextCursor = hasMore
? JSON.stringify({
displayName: resources[resources.length - 1]!.displayName,
id: resources[resources.length - 1]!.id,
})
: null;
return { resources, total, page, limit, nextCursor };
}
export async function listResourceDirectoryEntries(
ctx: Pick<TRPCContext, "db">,
input: z.infer<typeof ResourceDirectoryQuerySchema>,
) {
const {
chapter,
chapters,
isActive,
search,
eids,
countryIds,
excludedCountryIds,
includeWithoutCountry,
resourceTypes,
excludedResourceTypes,
includeWithoutResourceType,
rolledOff,
departed,
page,
limit,
cursor,
} = input;
const parsedCursor = parseResourceCursor(cursor);
type WhereClause = Record<string, unknown>;
const andClauses: WhereClause[] = [];
const chapterFilters = Array.from(new Set([...(chapter ? [chapter] : []), ...(chapters ?? [])]));
if (!eids) {
andClauses.push({ isActive });
} else {
andClauses.push({ eid: { in: eids } });
}
if (chapterFilters.length === 1) {
andClauses.push({ chapter: chapterFilters[0] });
} else if (chapterFilters.length > 1) {
andClauses.push({ chapter: { in: chapterFilters } });
}
if (search) {
andClauses.push({
OR: [
{ displayName: { contains: search, mode: "insensitive" as const } },
{ eid: { contains: search, mode: "insensitive" as const } },
],
});
}
if (countryIds && countryIds.length > 0) {
const countryClauses: WhereClause[] = [{ countryId: { in: countryIds } }];
if (includeWithoutCountry) {
countryClauses.push({ countryId: null });
}
andClauses.push(countryClauses.length === 1 ? countryClauses[0]! : { OR: countryClauses });
}
if (excludedCountryIds && excludedCountryIds.length > 0) {
andClauses.push({ NOT: { countryId: { in: excludedCountryIds } } });
}
if (!includeWithoutCountry) {
andClauses.push({ NOT: { countryId: null } });
}
if (resourceTypes && resourceTypes.length > 0) {
const resourceTypeClauses: WhereClause[] = [{ resourceType: { in: resourceTypes } }];
if (includeWithoutResourceType) {
resourceTypeClauses.push({ resourceType: null });
}
andClauses.push(
resourceTypeClauses.length === 1 ? resourceTypeClauses[0]! : { OR: resourceTypeClauses },
);
}
if (excludedResourceTypes && excludedResourceTypes.length > 0) {
andClauses.push({ NOT: { resourceType: { in: excludedResourceTypes } } });
}
if (!includeWithoutResourceType) {
andClauses.push({ NOT: { resourceType: null } });
}
if (rolledOff !== undefined) {
andClauses.push({ rolledOff });
}
if (departed !== undefined) {
andClauses.push({ departed });
}
const where = andClauses.length > 0 ? { AND: andClauses } : {};
const skip = cursor ? 0 : (page - 1) * limit;
const orderBy = [{ displayName: "asc" as const }, { id: "asc" as const }];
const whereWithCursor = parsedCursor
? {
AND: [
...((where as { AND?: WhereClause[] }).AND ?? []),
{
OR: [
{ displayName: { gt: parsedCursor.displayName } },
{ displayName: parsedCursor.displayName, id: { gt: parsedCursor.id } },
],
},
],
}
: where;
const [rawResources, total] = await Promise.all([
ctx.db.resource.findMany({
where: whereWithCursor,
select: RESOURCE_DIRECTORY_SELECT,
skip,
take: limit + 1,
orderBy,
}),
ctx.db.resource.count({ where }),
]);
const hasMore = rawResources.length > limit;
const resources = hasMore ? rawResources.slice(0, limit) : rawResources;
const nextCursor = hasMore
? JSON.stringify({
displayName: resources[resources.length - 1]!.displayName,
id: resources[resources.length - 1]!.id,
})
: null;
return { resources, total, page, limit, nextCursor };
}
function buildResourceSummaryWhere(input: {
search?: string;
country?: string;
metroCity?: string;
orgUnit?: string;
roleName?: string;
isActive: boolean;
}) {
const where: Record<string, unknown> = {};
if (input.isActive !== false) {
where.isActive = true;
}
if (input.search) {
where.OR = [
{ displayName: { contains: input.search, mode: "insensitive" as const } },
{ eid: { contains: input.search, mode: "insensitive" as const } },
{ chapter: { contains: input.search, mode: "insensitive" as const } },
];
}
if (input.country) {
where.country = {
OR: [
{ code: { equals: input.country, mode: "insensitive" as const } },
{ name: { contains: input.country, mode: "insensitive" as const } },
],
};
}
if (input.metroCity) {
where.metroCity = { name: { contains: input.metroCity, mode: "insensitive" as const } };
}
if (input.orgUnit) {
where.orgUnit = { name: { contains: input.orgUnit, mode: "insensitive" as const } };
}
if (input.roleName) {
where.areaRole = { name: { contains: input.roleName, mode: "insensitive" as const } };
}
return where;
}
function assertCanSearchResourceSummaries(ctx: Pick<TRPCContext, "dbUser" | "roleDefaults">) {
if (!canReadAllResources(ctx)) {
throw new TRPCError({
code: "FORBIDDEN",
message: "You need resource overview access to search resource summaries",
});
}
}
export async function readResourceSummariesSnapshot(
ctx: Pick<TRPCContext, "db" | "dbUser" | "roleDefaults">,
input: {
search?: string;
country?: string;
metroCity?: string;
orgUnit?: string;
roleName?: string;
isActive: boolean;
limit: number;
},
) {
assertCanSearchResourceSummaries(ctx);
return ctx.db.resource.findMany({
where: buildResourceSummaryWhere(input),
select: RESOURCE_SUMMARY_SELECT,
take: input.limit,
orderBy: { displayName: "asc" },
});
}
export async function readResourceSummaryDetailsSnapshot(
ctx: Pick<TRPCContext, "db" | "dbUser" | "roleDefaults">,
input: {
search?: string;
country?: string;
metroCity?: string;
orgUnit?: string;
roleName?: string;
isActive: boolean;
limit: number;
},
) {
assertCanSearchResourceSummaries(ctx);
return ctx.db.resource.findMany({
where: buildResourceSummaryWhere(input),
select: RESOURCE_SUMMARY_DETAIL_SELECT,
take: input.limit,
orderBy: { displayName: "asc" },
});
}
export async function resolveResourceIdentifierSnapshot(
ctx: ResourceReadContext,
identifier: string,
forbiddenMessage = "You can only view your own resource unless you have staff access",
) {
let resource = await ctx.db.resource.findUnique({
where: { id: identifier },
select: RESOURCE_IDENTIFIER_SELECT,
});
if (!resource) {
resource = await ctx.db.resource.findUnique({
where: { eid: identifier },
select: RESOURCE_IDENTIFIER_SELECT,
});
}
if (!resource) {
resource = await ctx.db.resource.findFirst({
where: { displayName: { equals: identifier, mode: "insensitive" } },
select: RESOURCE_IDENTIFIER_SELECT,
});
}
if (!resource && isBroadResourceLookupAllowed(ctx)) {
resource = await ctx.db.resource.findFirst({
where: { displayName: { contains: identifier, mode: "insensitive" } },
select: RESOURCE_IDENTIFIER_SELECT,
});
}
if (!resource && isBroadResourceLookupAllowed(ctx)) {
const words = identifier.split(/[\s,._\-/]+/).filter((word) => word.length >= 2);
if (words.length > 0) {
const candidates = await ctx.db.resource.findMany({
where: {
OR: words.map((word) => ({
displayName: { contains: word, mode: "insensitive" as const },
})),
},
select: RESOURCE_IDENTIFIER_SELECT,
take: 5,
});
if (candidates.length === 1) {
resource = candidates[0]!;
} else if (candidates.length > 1) {
return {
error: `Resource not found: "${identifier}". Did you mean one of these?`,
suggestions: candidates.map((candidate: (typeof candidates)[number]) => ({
id: candidate.id,
eid: candidate.eid,
name: candidate.displayName,
})),
} as const;
}
}
}
if (!resource) {
return { error: `Resource not found: ${identifier}` } as const;
}
await assertCanReadResource(ctx, resource.id, forbiddenMessage);
return resource;
}
export async function readResourceByIdentifierDetailSnapshot(
ctx: ResourceReadContext,
identifier: string,
) {
const resource = await resolveResourceIdentifierSnapshot(ctx, identifier);
if ("error" in resource) {
return resource;
}
const detail = await ctx.db.resource.findUnique({
where: { id: resource.id },
select: RESOURCE_IDENTIFIER_DETAIL_SELECT,
});
if (!detail) {
return { error: `Resource not found: ${identifier}` } as const;
}
return detail;
}