attlaz-client 1.66.0 → 1.68.0

package/dist/Model/User/UserActionFilter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Filters for the audit-log list. userIds is multi-value; entityId is a single prefixed entity id;
+ * timeFrom/timeTo bound the action time (inclusive). All optional.
+ */
+export interface UserActionFilter {
+    userIds?: string[];
+    entityId?: string;
+    timeFrom?: Date;
+    timeTo?: Date;
+}

package/dist/Model/User/UserActionFilter.js

@@ -0,0 +1 @@
+export {};

package/dist/Model/User/UserSummary.d.ts

@@ -0,0 +1,13 @@
+import { State } from '../State.js';
+export type UserSummaryType = 'user' | 'system';
+/**
+ * Display-safe view of a user (no email/PII). Resolved via UserEndpoint.getSummaries().
+ * `state` drives the badge (reuses the global State enum); `null` = not resolvable for this caller.
+ * `displayName` is always safe to show ("System", "Removed user", "Unknown user" for the edge cases).
+ */
+export declare class UserSummary {
+    id: string;
+    type: UserSummaryType;
+    state: State | null;
+    displayName: string;
+}

package/dist/Model/User/UserSummary.js

@@ -0,0 +1,11 @@
+/**
+ * Display-safe view of a user (no email/PII). Resolved via UserEndpoint.getSummaries().
+ * `state` drives the badge (reuses the global State enum); `null` = not resolvable for this caller.
+ * `displayName` is always safe to show ("System", "Removed user", "Unknown user" for the edge cases).
+ */
+export class UserSummary {
+    id;
+    type;
+    state;
+    displayName;
+}

package/dist/Service/UserActionEndpoint.d.ts

@@ -1,4 +1,6 @@
 import { UserAction } from '../Model/User/UserAction.js';
+import { UserActionFilter } from '../Model/User/UserActionFilter.js';
+import { UserSummary } from '../Model/User/UserSummary.js';
 import { CollectionResult } from '../Model/Result/CollectionResult.js';
 import { CursorPagination } from '../Model/Pagination/CursorPagination.js';
 import { Endpoint } from './Endpoint.js';
@@ -6,6 +8,9 @@ export declare class UserActionEndpoint extends Endpoint {
     getWorkspaceMemberActions(workspaceId: string, memberId: string, pagination?: CursorPagination | null): Promise<CollectionResult<UserAction>>;
     getUserActions(userId: string, pagination?: CursorPagination | null): Promise<CollectionResult<UserAction>>;
     getByResource(resourceId: string, resourceType: string, pagination?: CursorPagination | null): Promise<CollectionResult<UserAction>>;
-    getAll(pagination?: CursorPagination | null): Promise<CollectionResult<UserAction>>;
+    getAll(pagination?: CursorPagination | null, filter?: UserActionFilter | null): Promise<CollectionResult<UserAction>>;
+    /** Distinct users that appear in the audit log, resolved to display-safe summaries (for the user filter). */
+    getDistinctUsers(): Promise<UserSummary[]>;
+    private static parseSummary;
     private static parse;
 }

package/dist/Service/UserActionEndpoint.js

@@ -1,5 +1,7 @@
 import { Utils } from '../Utils.js';
 import { UserAction } from '../Model/User/UserAction.js';
+import { UserSummary } from '../Model/User/UserSummary.js';
+import { State } from '../Model/State.js';
 import { DataValueCollection } from '../Model/DataValueCollection.js';
 import { QueryString } from '../Http/Data/QueryString.js';
 import { Endpoint } from './Endpoint.js';
@@ -43,11 +45,39 @@ export class UserActionEndpoint extends Endpoint {
             throw error;
         }
     }
-    async getAll(pagination = null) {
+    async getAll(pagination = null, filter = null) {
         const queryString = new QueryString('/audit-logs');
         queryString.addPagination(pagination);
+        if (filter !== null) {
+            if (filter.userIds !== undefined && filter.userIds.length > 0) {
+                queryString.set('user', filter.userIds);
+            }
+            if (filter.entityId !== undefined) {
+                queryString.set('entity', filter.entityId);
+            }
+            if (filter.timeFrom !== undefined) {
+                queryString.set('time_from', filter.timeFrom.toISOString());
+            }
+            if (filter.timeTo !== undefined) {
+                queryString.set('time_to', filter.timeTo.toISOString());
+            }
+        }
         return await this.requestCollection(queryString, UserActionEndpoint.parse, null, 'GET');
     }
+    /** Distinct users that appear in the audit log, resolved to display-safe summaries (for the user filter). */
+    async getDistinctUsers() {
+        const queryString = new QueryString('/audit-logs/users');
+        const result = await this.requestCollection(queryString, UserActionEndpoint.parseSummary, null, 'GET');
+        return result.getData();
+    }
+    static parseSummary(raw) {
+        const summary = new UserSummary();
+        summary.id = raw.id;
+        summary.type = raw.type;
+        summary.state = (raw.state === null || raw.state === undefined) ? null : State.fromString(raw.state);
+        summary.displayName = raw.display_name;
+        return summary;
+    }
     static parse(rawUserEvent) {
         const userAction = new UserAction();
         userAction.id = rawUserEvent.id;

package/dist/Service/UserEndpoint.d.ts

@@ -1,5 +1,6 @@
 import { UserAuthProvider } from '../Model/User/UserAuthProvider.js';
 import { User } from '../Model/User/User.js';
+import { UserSummary } from '../Model/User/UserSummary.js';
 import { CollectionResult } from '../Model/Result/CollectionResult.js';
 import { Endpoint } from './Endpoint.js';
 import { UserNotificationSession } from '../Model/User/UserNotificationSession.js';
@@ -7,6 +8,13 @@ import { CursorPagination } from '../Model/Pagination/CursorPagination.js';
 export declare class UserEndpoint extends Endpoint {
     getUser(): Promise<User | null>;
     removeAuthProvider(providerId: string): Promise<boolean>;
+    /**
+     * Resolve display-safe summaries for a set of user ids (e.g. to show "Requested by" names in a
+     * list). The server applies visibility rules and returns tombstones ("Unknown user" / "Removed
+     * user") rather than leaking anything the caller isn't allowed to see.
+     */
+    getSummaries(userIds: string[]): Promise<UserSummary[]>;
+    private static parseSummary;
     getAuthProviders(): Promise<CollectionResult<UserAuthProvider>>;
     getPermissions(): Promise<CollectionResult<{
         key: string;

package/dist/Service/UserEndpoint.js

@@ -1,5 +1,6 @@
 import { UserAuthProvider } from '../Model/User/UserAuthProvider.js';
 import { User } from '../Model/User/User.js';
+import { UserSummary } from '../Model/User/UserSummary.js';
 import { Endpoint } from './Endpoint.js';
 import { UserNotificationSession } from '../Model/User/UserNotificationSession.js';
 import { QueryString } from '../Http/Data/QueryString.js';
@@ -27,6 +28,28 @@ export class UserEndpoint extends Endpoint {
             throw e;
         }
     }
+    /**
+     * Resolve display-safe summaries for a set of user ids (e.g. to show "Requested by" names in a
+     * list). The server applies visibility rules and returns tombstones ("Unknown user" / "Removed
+     * user") rather than leaking anything the caller isn't allowed to see.
+     */
+    async getSummaries(userIds) {
+        if (userIds.length === 0) {
+            return [];
+        }
+        const queryString = new QueryString('/users/summaries');
+        queryString.set('id', userIds);
+        const result = await this.requestCollection(queryString, UserEndpoint.parseSummary, null, 'GET');
+        return result.getData();
+    }
+    static parseSummary(raw) {
+        const summary = new UserSummary();
+        summary.id = raw.id;
+        summary.type = raw.type;
+        summary.state = (raw.state === null || raw.state === undefined) ? null : State.fromString(raw.state);
+        summary.displayName = raw.display_name;
+        return summary;
+    }
     async getAuthProviders() {
         const cmd = '/users/auth/providers';
         const rawAuthProviders = await this.requestCollection(cmd, UserAuthProvider.parse);

package/dist/index.d.ts

@@ -129,6 +129,9 @@ export { FlowTemplate } from './Model/Flow/FlowTemplate.js';
 export { User } from './Model/User/User.js';
 export { UserAuthProvider } from './Model/User/UserAuthProvider.js';
 export { UserAction } from './Model/User/UserAction.js';
+export type { UserActionFilter } from './Model/User/UserActionFilter.js';
+export { UserSummary } from './Model/User/UserSummary.js';
+export type { UserSummaryType } from './Model/User/UserSummary.js';
 export { RunnerImage } from './Model/Runner/RunnerImage.js';
 export { CommandExecutionHistory } from './Model/Command/CommandExecutionHistory.js';
 export { CommandExecutionStatus } from './Model/Command/CommandExecutionStatus.js';

package/dist/index.js

@@ -117,6 +117,7 @@ export { FlowTemplate } from './Model/Flow/FlowTemplate.js';
 export { User } from './Model/User/User.js';
 export { UserAuthProvider } from './Model/User/UserAuthProvider.js';
 export { UserAction } from './Model/User/UserAction.js';
+export { UserSummary } from './Model/User/UserSummary.js';
 export { RunnerImage } from './Model/Runner/RunnerImage.js';
 export { CommandExecutionHistory } from './Model/Command/CommandExecutionHistory.js';
 export { CommandExecutionStatus } from './Model/Command/CommandExecutionStatus.js';

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.66.0";
+export declare const VERSION = "1.67.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.66.0";
+export const VERSION = "1.67.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "attlaz-client",
-  "version": "1.66.0",
+  "version": "1.68.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",