bastian/boilerplate
Template
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

bump

Browse Source
This commit is contained in:
Bastian Wagner
2026-07-16 15:23:53 +02:00
parent 543e8273a7
commit c03b2e17f5
114 changed files with 7631 additions and 506 deletions
Download Patch File Download Diff File Expand all files Collapse all files

518
scripts/generate-api-client.mjs
View File

@@ -10,11 +10,525 @@ const files = new Map([
],
[
'packages/api-client/src/models.ts',
`// Generated from the backend OpenAPI contract. Do not edit manually.\nexport type Permission =\n | 'items.read'\n | 'items.create'\n | 'items.update'\n | 'items.delete'\n | 'users.read'\n | 'users.manage'\n | 'roles.read'\n | 'roles.manage'\n | 'audit.read'\n | 'sessions.readOwn'\n | 'sessions.revokeOwn'\n | 'sessions.manage';\n\nexport interface ApiErrorBody {\n status: number;\n code: string;\n message: string;\n requestId: string;\n validation?: { field: string; messages: string[] }[];\n}\n\nexport interface PageDto<T> {\n items: T[];\n total: number;\n page: number;\n pageSize: number;\n}\n\nexport interface UserDto {\n id: string;\n name: string;\n email: string | null;\n active: boolean;\n lastLoginAt: string | null;\n roles: RoleDto[];\n settings: { tablePageSize: number; sidebarExpanded: boolean };\n}\n\nexport interface RoleDto {\n id: string;\n name: string;\n protected: boolean;\n permissions: { id: Permission; description: string }[];\n users?: UserDto[];\n}\n\nexport interface ItemDto {\n id: string;\n name: string;\n description: string | null;\n status: 'draft' | 'active' | 'archived';\n version: number;\n createdAt: string;\n updatedAt: string;\n deletedAt: string | null;\n}\n\nexport interface SaveItemDto {\n name: string;\n description?: string;\n status: ItemDto['status'];\n version?: number;\n}\n\nexport interface SessionDto {\n id: string;\n createdAt: string;\n lastActivityAt: string;\n userAgent: string | null;\n approximateIp: string | null;\n current: boolean;\n revokedAt: string | null;\n}\n\nexport interface AuditLogDto {\n id: string;\n createdAt: string;\n actorUserId: string | null;\n action: string;\n targetType: string;\n targetId: string;\n metadata: Record<string, string | number | boolean | null> | null;\n requestId: string;\n}\n`,
`// Generated from the backend OpenAPI contract. Do not edit manually.
export type Permission =
| 'items.read'
| 'items.create'
| 'items.update'
| 'items.delete'
| 'users.read'
| 'users.manage'
| 'roles.read'
| 'roles.manage'
| 'audit.read'
| 'sessions.readOwn'
| 'sessions.revokeOwn'
| 'sessions.manage'
| 'notifications.readOwn'
| 'notifications.updateOwn'
| 'notifications.manage';
export interface ApiErrorBody {
status: number;
code: string;
message: string;
requestId: string;
validation?: { field: string; messages: string[] }[];
}
export interface PageDto<T> {
items: T[];
total: number;
page: number;
pageSize: number;
}
export interface UserDto {
id: string;
name: string;
email: string | null;
active: boolean;
lastLoginAt: string | null;
roles: RoleDto[];
settings: { tablePageSize: number; sidebarExpanded: boolean };
}
export interface AdminRoleSummaryDto {
id: string;
name: string;
system: boolean;
}
export interface AdminSessionDto {
id: string;
createdAt: string;
lastActivityAt: string;
userAgent: string | null;
approximateIp: string | null;
current: boolean;
expiresAt: string;
revokedAt: string | null;
}
export interface AdminUserListItemDto {
id: string;
name: string;
email: string | null;
active: boolean;
roles: AdminRoleSummaryDto[];
lastLoginAt: string | null;
createdAt: string;
activeSessionCount: number;
}
export interface AdminUserDetailDto extends AdminUserListItemDto {
effectivePermissions: Permission[];
sessions: AdminSessionDto[];
}
export interface RoleDto {
id: string;
name: string;
description: string;
system: boolean;
protected: boolean;
permissions: { id: Permission; description: string }[];
userCount?: number;
users?: UserDto[];
}
export interface ItemDto {
id: string;
name: string;
description: string | null;
status: 'draft' | 'active' | 'archived';
version: number;
createdAt: string;
updatedAt: string;
deletedAt: string | null;
}
export interface SaveItemDto {
name: string;
description?: string;
status: ItemDto['status'];
version?: number;
}
export interface SessionDto {
id: string;
createdAt: string;
lastActivityAt: string;
userAgent: string | null;
approximateIp: string | null;
current: boolean;
revokedAt: string | null;
}
export interface AuditLogDto {
id: string;
createdAt: string;
actorUserId: string | null;
action: string;
targetType: string;
targetId: string;
metadata: Record<string, string | number | boolean | null> | null;
requestId: string;
}
export type NotificationType =
| 'system'
| 'item.created'
| 'item.updated'
| 'user.role-changed';
export type NotificationStatusFilter = 'all' | 'read' | 'unread';
export interface NotificationDto {
id: string;
type: NotificationType;
title: string;
message: string;
link: string | null;
metadata: Record<string, string | number | boolean | null> | null;
read: boolean;
readAt: string | null;
createdAt: string;
}
export interface NotificationPageDto extends PageDto<NotificationDto> {
unreadCount: number;
}
export interface CreateNotificationDto {
userId: string;
type: NotificationType;
title: string;
message: string;
link?: string;
metadata?: Record<string, string | number | boolean | null>;
}
`,
],
[
'packages/api-client/src/api-client.service.ts',
`// Generated from the backend OpenAPI contract. Do not edit manually.\nimport { Injectable, inject } from '@angular/core';\nimport { HttpClient, HttpParams } from '@angular/common/http';\nimport type { Observable } from 'rxjs';\nimport type { AuditLogDto, ItemDto, PageDto, RoleDto, SaveItemDto, SessionDto, UserDto } from './models';\n\n@Injectable({ providedIn: 'root' })\nexport class ApiClientService {\n private readonly http = inject(HttpClient);\n private readonly base = '/api';\n\n me(): Observable<UserDto> { return this.http.get<UserDto>(\`\${this.base}/me\`, { withCredentials: true }); }\n updateSettings(body: { tablePageSize?: number; sidebarExpanded?: boolean }): Observable<UserDto> { return this.http.patch<UserDto>(\`\${this.base}/me/settings\`, body, { withCredentials: true }); }\n dashboard(): Observable<{ userCount: number; activeSessions: number; roleCount: number; itemCount: number }> { return this.http.get<{ userCount: number; activeSessions: number; roleCount: number; itemCount: number }>(\`\${this.base}/dashboard\`, { withCredentials: true }); }\n\n items(query: { search?: string; page?: number; pageSize?: number; sort?: string; direction?: string } = {}): Observable<PageDto<ItemDto>> {\n return this.http.get<PageDto<ItemDto>>(\`\${this.base}/items\`, { params: this.params(query), withCredentials: true });\n }\n item(id: string): Observable<ItemDto> { return this.http.get<ItemDto>(\`\${this.base}/items/\${id}\`, { withCredentials: true }); }\n createItem(body: SaveItemDto): Observable<ItemDto> { return this.http.post<ItemDto>(\`\${this.base}/items\`, body, { withCredentials: true }); }\n updateItem(id: string, body: Required<SaveItemDto>): Observable<ItemDto> { return this.http.put<ItemDto>(\`\${this.base}/items/\${id}\`, body, { withCredentials: true }); }\n deleteItem(id: string, version: number): Observable<void> { return this.http.delete<void>(\`\${this.base}/items/\${id}\`, { params: { version }, withCredentials: true }); }\n\n users(query: { search?: string; page?: number; pageSize?: number } = {}): Observable<PageDto<UserDto>> { return this.http.get<PageDto<UserDto>>(\`\${this.base}/users\`, { params: this.params(query), withCredentials: true }); }\n setUserActive(id: string, active: boolean): Observable<UserDto> { return this.http.patch<UserDto>(\`\${this.base}/users/\${id}/active\`, { active }, { withCredentials: true }); }\n setUserRoles(id: string, roleIds: string[]): Observable<UserDto> { return this.http.patch<UserDto>(\`\${this.base}/users/\${id}/roles\`, { roleIds }, { withCredentials: true }); }\n\n roles(): Observable<RoleDto[]> { return this.http.get<RoleDto[]>(\`\${this.base}/roles\`, { withCredentials: true }); }\n createRole(body: { name: string; permissions: string[] }): Observable<RoleDto> { return this.http.post<RoleDto>(\`\${this.base}/roles\`, body, { withCredentials: true }); }\n updateRole(id: string, body: { name: string; permissions: string[] }): Observable<RoleDto> { return this.http.put<RoleDto>(\`\${this.base}/roles/\${id}\`, body, { withCredentials: true }); }\n deleteRole(id: string): Observable<void> { return this.http.delete<void>(\`\${this.base}/roles/\${id}\`, { withCredentials: true }); }\n\n sessions(): Observable<SessionDto[]> { return this.http.get<SessionDto[]>(\`\${this.base}/sessions/own\`, { withCredentials: true }); }\n revokeSession(id: string): Observable<void> { return this.http.delete<void>(\`\${this.base}/sessions/own/\${id}\`, { withCredentials: true }); }\n revokeOtherSessions(): Observable<void> { return this.http.delete<void>(\`\${this.base}/sessions/own\`, { withCredentials: true }); }\n revokeUserSessions(userId: string): Observable<void> { return this.http.delete<void>(\`\${this.base}/sessions/users/\${userId}\`, { withCredentials: true }); }\n\n audit(page = 1, pageSize = 20): Observable<PageDto<AuditLogDto>> { return this.http.get<PageDto<AuditLogDto>>(\`\${this.base}/audit-log\`, { params: { page, pageSize }, withCredentials: true }); }\n\n private params(value: Record<string, string | number | undefined>): HttpParams {\n let params = new HttpParams();\n Object.entries(value).forEach(([key, entry]) => {\n if (entry !== undefined && entry !== '') params = params.set(key, String(entry));\n });\n return params;\n }\n}\n`,
`// Generated from the backend OpenAPI contract. Do not edit manually.
import { Injectable, inject } from '@angular/core';
import { HttpClient, HttpParams } from '@angular/common/http';
import type { Observable } from 'rxjs';
import type {
AuditLogDto,
AdminSessionDto,
AdminUserDetailDto,
AdminUserListItemDto,
CreateNotificationDto,
ItemDto,
NotificationDto,
NotificationPageDto,
NotificationStatusFilter,
PageDto,
Permission,
RoleDto,
SaveItemDto,
SessionDto,
UserDto,
} from './models';
@Injectable({ providedIn: 'root' })
export class ApiClientService {
private readonly http = inject(HttpClient);
private readonly base = '/api';
me(): Observable<UserDto> {
return this.http.get<UserDto>(\`\${this.base}/me\`, { withCredentials: true });
}
updateSettings(body: {
tablePageSize?: number;
sidebarExpanded?: boolean;
}): Observable<UserDto> {
return this.http.patch<UserDto>(\`\${this.base}/me/settings\`, body, {
withCredentials: true,
});
}
dashboard(): Observable<{
userCount: number;
activeSessions: number;
roleCount: number;
itemCount: number;
}> {
return this.http.get<{
userCount: number;
activeSessions: number;
roleCount: number;
itemCount: number;
}>(\`\${this.base}/dashboard\`, { withCredentials: true });
}
items(
query: {
search?: string;
page?: number;
pageSize?: number;
sort?: string;
direction?: string;
} = {},
): Observable<PageDto<ItemDto>> {
return this.http.get<PageDto<ItemDto>>(\`\${this.base}/items\`, {
params: this.params(query),
withCredentials: true,
});
}
item(id: string): Observable<ItemDto> {
return this.http.get<ItemDto>(\`\${this.base}/items/\${id}\`, {
withCredentials: true,
});
}
createItem(body: SaveItemDto): Observable<ItemDto> {
return this.http.post<ItemDto>(\`\${this.base}/items\`, body, {
withCredentials: true,
});
}
updateItem(id: string, body: Required<SaveItemDto>): Observable<ItemDto> {
return this.http.put<ItemDto>(\`\${this.base}/items/\${id}\`, body, {
withCredentials: true,
});
}
deleteItem(id: string, version: number): Observable<void> {
return this.http.delete<void>(\`\${this.base}/items/\${id}\`, {
params: { version },
withCredentials: true,
});
}
users(
query: { search?: string; page?: number; pageSize?: number } = {},
): Observable<PageDto<UserDto>> {
return this.http.get<PageDto<UserDto>>(\`\${this.base}/users\`, {
params: this.params(query),
withCredentials: true,
});
}
setUserActive(id: string, active: boolean): Observable<UserDto> {
return this.http.patch<UserDto>(
\`\${this.base}/users/\${id}/active\`,
{ active },
{ withCredentials: true },
);
}
setUserRoles(id: string, roleIds: string[]): Observable<UserDto> {
return this.http.patch<UserDto>(
\`\${this.base}/users/\${id}/roles\`,
{ roleIds },
{ withCredentials: true },
);
}
adminUsers(
query: {
search?: string;
active?: 'all' | 'active' | 'inactive';
roleId?: string;
sort?: 'name' | 'email' | 'lastLoginAt' | 'createdAt';
direction?: 'ASC' | 'DESC';
page?: number;
pageSize?: number;
} = {},
): Observable<PageDto<AdminUserListItemDto>> {
return this.http.get<PageDto<AdminUserListItemDto>>(\`\${this.base}/admin/users\`, {
params: this.params(query),
withCredentials: true,
});
}
adminUser(id: string): Observable<AdminUserDetailDto> {
return this.http.get<AdminUserDetailDto>(\`\${this.base}/admin/users/\${id}\`, {
withCredentials: true,
});
}
activateAdminUser(id: string): Observable<AdminUserDetailDto> {
return this.http.patch<AdminUserDetailDto>(
\`\${this.base}/admin/users/\${id}/activate\`,
{},
{ withCredentials: true },
);
}
deactivateAdminUser(id: string): Observable<AdminUserDetailDto> {
return this.http.patch<AdminUserDetailDto>(
\`\${this.base}/admin/users/\${id}/deactivate\`,
{},
{ withCredentials: true },
);
}
assignAdminUserRole(userId: string, roleId: string): Observable<AdminUserDetailDto> {
return this.http.post<AdminUserDetailDto>(
\`\${this.base}/admin/users/\${userId}/roles/\${roleId}\`,
{},
{ withCredentials: true },
);
}
removeAdminUserRole(userId: string, roleId: string): Observable<AdminUserDetailDto> {
return this.http.delete<AdminUserDetailDto>(
\`\${this.base}/admin/users/\${userId}/roles/\${roleId}\`,
{ withCredentials: true },
);
}
adminUserSessions(id: string): Observable<AdminSessionDto[]> {
return this.http.get<AdminSessionDto[]>(\`\${this.base}/admin/users/\${id}/sessions\`, {
withCredentials: true,
});
}
revokeAdminUserSession(userId: string, sessionId: string): Observable<void> {
return this.http.delete<void>(
\`\${this.base}/admin/users/\${userId}/sessions/\${sessionId}\`,
{ withCredentials: true },
);
}
revokeAdminUserSessions(userId: string): Observable<{ revoked: number }> {
return this.http.delete<{ revoked: number }>(
\`\${this.base}/admin/users/\${userId}/sessions\`,
{ withCredentials: true },
);
}
roles(): Observable<RoleDto[]> {
return this.http.get<RoleDto[]>(\`\${this.base}/roles\`, {
withCredentials: true,
});
}
createRole(body: { name: string; permissions: string[] }): Observable<RoleDto> {
return this.http.post<RoleDto>(\`\${this.base}/roles\`, body, {
withCredentials: true,
});
}
updateRole(
id: string,
body: { name: string; permissions: string[] },
): Observable<RoleDto> {
return this.http.put<RoleDto>(\`\${this.base}/roles/\${id}\`, body, {
withCredentials: true,
});
}
deleteRole(id: string): Observable<void> {
return this.http.delete<void>(\`\${this.base}/roles/\${id}\`, {
withCredentials: true,
});
}
adminRoles(): Observable<RoleDto[]> {
return this.http.get<RoleDto[]>(\`\${this.base}/admin/roles\`, {
withCredentials: true,
});
}
adminRole(id: string): Observable<RoleDto> {
return this.http.get<RoleDto>(\`\${this.base}/admin/roles/\${id}\`, {
withCredentials: true,
});
}
createAdminRole(body: {
name: string;
description?: string;
permissions: Permission[];
}): Observable<RoleDto> {
return this.http.post<RoleDto>(\`\${this.base}/admin/roles\`, body, {
withCredentials: true,
});
}
updateAdminRole(
id: string,
body: { name: string; description?: string; permissions: Permission[] },
): Observable<RoleDto> {
return this.http.put<RoleDto>(\`\${this.base}/admin/roles/\${id}\`, body, {
withCredentials: true,
});
}
deleteAdminRole(id: string): Observable<void> {
return this.http.delete<void>(\`\${this.base}/admin/roles/\${id}\`, {
withCredentials: true,
});
}
sessions(): Observable<SessionDto[]> {
return this.http.get<SessionDto[]>(\`\${this.base}/sessions/own\`, {
withCredentials: true,
});
}
revokeSession(id: string): Observable<void> {
return this.http.delete<void>(\`\${this.base}/sessions/own/\${id}\`, {
withCredentials: true,
});
}
revokeOtherSessions(): Observable<void> {
return this.http.delete<void>(\`\${this.base}/sessions/own\`, {
withCredentials: true,
});
}
revokeUserSessions(userId: string): Observable<void> {
return this.http.delete<void>(\`\${this.base}/sessions/users/\${userId}\`, {
withCredentials: true,
});
}
audit(page = 1, pageSize = 20): Observable<PageDto<AuditLogDto>> {
return this.http.get<PageDto<AuditLogDto>>(\`\${this.base}/audit-log\`, {
params: { page, pageSize },
withCredentials: true,
});
}
notifications(
query: {
page?: number;
pageSize?: number;
status?: NotificationStatusFilter;
} = {},
): Observable<NotificationPageDto> {
return this.http.get<NotificationPageDto>(\`\${this.base}/notifications\`, {
params: this.params(query),
withCredentials: true,
});
}
unreadNotificationCount(): Observable<{ count: number }> {
return this.http.get<{ count: number }>(
\`\${this.base}/notifications/unread-count\`,
{ withCredentials: true },
);
}
markNotificationRead(id: string): Observable<NotificationDto> {
return this.http.patch<NotificationDto>(
\`\${this.base}/notifications/\${id}/read\`,
{},
{ withCredentials: true },
);
}
markNotificationUnread(id: string): Observable<NotificationDto> {
return this.http.patch<NotificationDto>(
\`\${this.base}/notifications/\${id}/unread\`,
{},
{ withCredentials: true },
);
}
markAllNotificationsRead(): Observable<{ updated: number }> {
return this.http.patch<{ updated: number }>(
\`\${this.base}/notifications/read-all\`,
{},
{ withCredentials: true },
);
}
deleteNotification(id: string): Observable<void> {
return this.http.delete<void>(\`\${this.base}/notifications/\${id}\`, {
withCredentials: true,
});
}
createAdminNotification(
body: CreateNotificationDto,
): Observable<NotificationDto> {
return this.http.post<NotificationDto>(
\`\${this.base}/admin/notifications\`,
body,
{ withCredentials: true },
);
}
private params(value: Record<string, string | number | undefined>): HttpParams {
let params = new HttpParams();
Object.entries(value).forEach(([key, entry]) => {
if (entry !== undefined && entry !== '') params = params.set(key, String(entry));
});
return params;
}
}
`,
],
]);