@archiva/archiva-nextjs 0.2.6 → 0.2.8

package/dist/chunk-SQG3CD5M.mjs

@@ -0,0 +1,275 @@
+// src/types.ts
+var ArchivaError = class extends Error {
+  constructor(params) {
+    super(params.message);
+    this.statusCode = params.statusCode;
+    this.code = params.code;
+    this.retryAfterSeconds = params.retryAfterSeconds;
+    this.details = params.details;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.archiva.app";
+function buildHeaders(apiKey, overrides) {
+  const headers = new Headers(overrides);
+  headers.set("X-Project-Key", apiKey);
+  return headers;
+}
+async function parseError(response) {
+  const retryAfterHeader = response.headers.get("Retry-After");
+  const retryAfterSeconds = retryAfterHeader ? Number(retryAfterHeader) : void 0;
+  let payload = void 0;
+  try {
+    payload = await response.json();
+  } catch {
+    payload = void 0;
+  }
+  const errorMessage = typeof payload === "object" && payload !== null && "error" in payload ? String(payload.error) : response.statusText;
+  let code = "HTTP_ERROR";
+  if (response.status === 401) {
+    code = "UNAUTHORIZED";
+  } else if (response.status === 403) {
+    code = "FORBIDDEN";
+  } else if (response.status === 413) {
+    code = "PAYLOAD_TOO_LARGE";
+  } else if (response.status === 429) {
+    code = "RATE_LIMITED";
+  } else if (response.status === 409) {
+    code = "IDEMPOTENCY_CONFLICT";
+  }
+  throw new ArchivaError({
+    statusCode: response.status,
+    code,
+    message: errorMessage,
+    retryAfterSeconds,
+    details: payload
+  });
+}
+function createRequestId() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+}
+function createIdempotencyKey() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return `idem_${crypto.randomUUID()}`;
+  }
+  return `idem_${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+}
+async function loadEvents(apiKey, params, baseUrl = DEFAULT_BASE_URL) {
+  const url = new URL(`${baseUrl}/api/events`);
+  if (params.entityId) {
+    url.searchParams.set("entityId", params.entityId);
+  }
+  if (params.actorId) {
+    url.searchParams.set("actorId", params.actorId);
+  }
+  if (params.entityType) {
+    url.searchParams.set("entityType", params.entityType);
+  }
+  if (params.actorType) {
+    url.searchParams.set("actorType", params.actorType);
+  }
+  if (params.limit) {
+    url.searchParams.set("limit", String(params.limit));
+  }
+  if (params.cursor) {
+    url.searchParams.set("cursor", params.cursor);
+  }
+  const response = await fetch(url.toString(), {
+    headers: buildHeaders(apiKey)
+  });
+  if (!response.ok) {
+    await parseError(response);
+  }
+  const payload = await response.json();
+  if (!payload || typeof payload !== "object" || !Array.isArray(payload.items)) {
+    throw new ArchivaError({
+      statusCode: response.status,
+      code: "HTTP_ERROR",
+      message: "Invalid response format",
+      details: payload
+    });
+  }
+  const items = payload.items.map((item) => {
+    if (typeof item !== "object" || item === null) {
+      throw new ArchivaError({
+        statusCode: response.status,
+        code: "HTTP_ERROR",
+        message: "Invalid item format in response",
+        details: item
+      });
+    }
+    const event = item;
+    return {
+      id: String(event.id ?? ""),
+      receivedAt: String(event.receivedAt ?? ""),
+      action: String(event.action ?? ""),
+      entityType: String(event.entityType ?? ""),
+      entityId: String(event.entityId ?? ""),
+      actorId: event.actorId !== null && event.actorId !== void 0 ? String(event.actorId) : null,
+      actorType: event.actorType && (event.actorType === "user" || event.actorType === "service" || event.actorType === "system") ? event.actorType : void 0,
+      actorDisplay: event.actorDisplay !== null && event.actorDisplay !== void 0 ? String(event.actorDisplay) : void 0,
+      source: event.source !== null && event.source !== void 0 ? String(event.source) : null
+    };
+  });
+  return {
+    items,
+    nextCursor: typeof payload.nextCursor === "string" ? payload.nextCursor : void 0
+  };
+}
+async function createEvent(apiKey, event, options, baseUrl = DEFAULT_BASE_URL) {
+  const idempotencyKey = options?.idempotencyKey ?? createIdempotencyKey();
+  const requestId = options?.requestId ?? createRequestId();
+  const headers = buildHeaders(apiKey, {
+    "Content-Type": "application/json",
+    "Idempotency-Key": idempotencyKey,
+    "X-Request-Id": requestId
+  });
+  const response = await fetch(`${baseUrl}/api/ingest/event`, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(event)
+  });
+  if (!response.ok) {
+    await parseError(response);
+  }
+  const payload = await response.json();
+  if (!payload || typeof payload !== "object" || typeof payload.eventId !== "string") {
+    throw new ArchivaError({
+      statusCode: response.status,
+      code: "HTTP_ERROR",
+      message: "Invalid response format",
+      details: payload
+    });
+  }
+  return {
+    eventId: payload.eventId,
+    replayed: response.status === 200
+  };
+}
+async function createEvents(apiKey, events, options, baseUrl = DEFAULT_BASE_URL) {
+  const results = await Promise.all(
+    events.map(
+      (event, index) => createEvent(
+        apiKey,
+        event,
+        {
+          ...options,
+          idempotencyKey: options?.idempotencyKey ? `${options.idempotencyKey}_${index}` : void 0
+        },
+        baseUrl
+      )
+    )
+  );
+  return {
+    eventIds: results.map((r) => r.eventId)
+  };
+}
+
+// src/actions.ts
+var DEFAULT_BASE_URL2 = "https://api.archiva.app";
+function getApiKey(apiKey) {
+  const resolvedKey = apiKey || process.env.ARCHIVA_SECRET_KEY;
+  if (!resolvedKey) {
+    throw new Error("ARCHIVA_SECRET_KEY environment variable is required, or provide apiKey prop to ArchivaProvider");
+  }
+  return resolvedKey;
+}
+async function loadEvents2(params, apiKey) {
+  const resolvedApiKey = getApiKey(apiKey);
+  return loadEvents(resolvedApiKey, params, DEFAULT_BASE_URL2);
+}
+async function createEvent2(event, options, apiKey) {
+  const resolvedApiKey = getApiKey(apiKey);
+  return createEvent(resolvedApiKey, event, options, DEFAULT_BASE_URL2);
+}
+async function createEvents2(events, options, apiKey) {
+  const resolvedApiKey = getApiKey(apiKey);
+  return createEvents(resolvedApiKey, events, options, DEFAULT_BASE_URL2);
+}
+
+// src/server/frontendTokens.ts
+import "server-only";
+var DEFAULT_API_BASE_URL = "https://api.archiva.app";
+async function createFrontendTokenGET(projectId, apiBaseUrl = DEFAULT_API_BASE_URL) {
+  const secretKey = process.env.ARCHIVA_SECRET_KEY;
+  if (!secretKey || secretKey.trim().length === 0) {
+    const exists = process.env.ARCHIVA_SECRET_KEY !== void 0;
+    throw new Error(
+      `ARCHIVA_SECRET_KEY environment variable is ${exists ? "empty" : "not configured"}. Please set it in your .env.local file (or .env) with a valid value and restart your Next.js dev server. The variable must be in the project root directory and must not be empty.`
+    );
+  }
+  const keyPrefix = secretKey.substring(0, 10);
+  console.log("[Archiva] Using API key prefix:", keyPrefix + "...", "Length:", secretKey.length);
+  const url = new URL(`${apiBaseUrl}/api/v1/frontend-tokens`);
+  const response = await fetch(url.toString(), {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${secretKey}`
+    },
+    body: JSON.stringify({
+      scopes: ["timeline:read"],
+      ...projectId && { projectId }
+    })
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ error: response.statusText }));
+    const errorMessage = error.error || `Failed to fetch frontend token: ${response.status}`;
+    if (errorMessage.includes("ARCHIVA_SECRET_KEY") || response.status === 401 || response.status === 403) {
+      throw new Error(
+        `Archiva API authentication failed. Check that your ARCHIVA_SECRET_KEY is valid and has the correct permissions. API error: ${errorMessage}`
+      );
+    }
+    throw new Error(errorMessage);
+  }
+  const data = await response.json();
+  if (!data.token || typeof data.expiresAt !== "number") {
+    throw new Error("Invalid token response format");
+  }
+  return {
+    token: data.token,
+    expiresAt: data.expiresAt
+  };
+}
+
+// src/server/handlers/createFrontendTokenRoute.ts
+import "server-only";
+import { NextResponse } from "next/server";
+var DEFAULT_API_BASE_URL2 = "https://api.archiva.app";
+function createFrontendTokenRoute(options) {
+  return async function GET2(request) {
+    try {
+      const searchParams = request.nextUrl.searchParams;
+      const projectId = searchParams.get("projectId") || void 0;
+      const apiBaseUrl = options?.apiBaseUrl || DEFAULT_API_BASE_URL2;
+      const tokenResponse = await createFrontendTokenGET(projectId, apiBaseUrl);
+      return NextResponse.json(tokenResponse);
+    } catch (error) {
+      console.error("Error fetching frontend token:", error);
+      const message = error instanceof Error ? error.message : "Internal server error";
+      const statusCode = message.includes("ARCHIVA_SECRET_KEY") ? 500 : 500;
+      return NextResponse.json(
+        { error: message },
+        { status: statusCode }
+      );
+    }
+  };
+}
+async function GET(request) {
+  const handler = createFrontendTokenRoute();
+  return handler(request);
+}
+
+export {
+  ArchivaError,
+  loadEvents2 as loadEvents,
+  createEvent2 as createEvent,
+  createEvents2 as createEvents,
+  createFrontendTokenGET,
+  createFrontendTokenRoute,
+  GET
+};

package/dist/index-BJ8aJsbs.d.mts

@@ -0,0 +1,139 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+type EventChange = {
+    op: "set" | "unset" | "add" | "remove" | "replace" | string;
+    path: string;
+    before?: unknown;
+    after?: unknown;
+};
+type CreateEventInput = {
+    action: string;
+    entityType: string;
+    entityId: string;
+    actorType?: string;
+    actorId?: string;
+    actorDisplay?: string;
+    occurredAt?: string;
+    source?: string;
+    context?: Record<string, unknown>;
+    changes?: EventChange[];
+};
+type CreateEventOptions = {
+    idempotencyKey?: string;
+    requestId?: string;
+};
+type AuditEventListItem = {
+    id: string;
+    receivedAt: string;
+    action: string;
+    entityType: string;
+    entityId: string;
+    actorId: string | null;
+    actorType?: 'user' | 'service' | 'system';
+    actorDisplay?: string | null;
+    source: string | null;
+};
+type PageResult<T> = {
+    items: T[];
+    nextCursor?: string;
+};
+type LoadEventsParams = {
+    entityId?: string;
+    actorId?: string;
+    entityType?: string;
+    actorType?: 'user' | 'service' | 'system';
+    limit?: number;
+    cursor?: string;
+};
+declare class ArchivaError extends Error {
+    statusCode: number;
+    code: "UNAUTHORIZED" | "FORBIDDEN" | "PAYLOAD_TOO_LARGE" | "RATE_LIMITED" | "IDEMPOTENCY_CONFLICT" | "HTTP_ERROR";
+    retryAfterSeconds?: number;
+    details?: unknown;
+    constructor(params: {
+        statusCode: number;
+        code: "UNAUTHORIZED" | "FORBIDDEN" | "PAYLOAD_TOO_LARGE" | "RATE_LIMITED" | "IDEMPOTENCY_CONFLICT" | "HTTP_ERROR";
+        message: string;
+        retryAfterSeconds?: number;
+        details?: unknown;
+    });
+}
+
+/**
+ * Server action to load audit events
+ *
+ * @param params - Query parameters for filtering events
+ * @param apiKey - Optional API key (otherwise uses ARCHIVA_SECRET_KEY env var)
+ * @returns Paginated list of audit events
+ */
+declare function loadEvents(params: LoadEventsParams, apiKey?: string): Promise<PageResult<AuditEventListItem>>;
+/**
+ * Server action to create a single audit event
+ *
+ * @param event - Event data to create
+ * @param options - Optional idempotency and request ID options
+ * @param apiKey - Optional API key (otherwise uses ARCHIVA_SECRET_KEY env var)
+ * @returns Created event ID and replay status
+ */
+declare function createEvent(event: CreateEventInput, options?: CreateEventOptions, apiKey?: string): Promise<{
+    eventId: string;
+    replayed: boolean;
+}>;
+/**
+ * Server action to create multiple audit events (bulk)
+ *
+ * @param events - Array of events to create
+ * @param options - Optional idempotency and request ID options
+ * @param apiKey - Optional API key (otherwise uses ARCHIVA_SECRET_KEY env var)
+ * @returns Array of created event IDs
+ */
+declare function createEvents(events: CreateEventInput[], options?: CreateEventOptions, apiKey?: string): Promise<{
+    eventIds: string[];
+}>;
+
+interface FrontendTokenResponse {
+    token: string;
+    expiresAt: number;
+}
+/**
+ * Fetches a frontend token from the Archiva API
+ *
+ * @param projectId - Optional project ID for scoping
+ * @param apiBaseUrl - Archiva API base URL (defaults to https://api.archiva.app)
+ * @returns Frontend token response
+ */
+declare function createFrontendTokenGET(projectId?: string, apiBaseUrl?: string): Promise<FrontendTokenResponse>;
+
+/**
+ * Next.js route handler for GET /api/archiva/frontend-token
+ *
+ * This handler can be used in the host app's route file:
+ *
+ * ```ts
+ * // app/api/archiva/frontend-token/route.ts
+ * export { GET } from '@archiva/archiva-nextjs/server';
+ * ```
+ *
+ * Or with custom configuration:
+ *
+ * ```ts
+ * import { createFrontendTokenRoute } from '@archiva/archiva-nextjs/server';
+ *
+ * export const GET = createFrontendTokenRoute({
+ *   apiBaseUrl: process.env.ARCHIVA_API_URL,
+ * });
+ * ```
+ */
+declare function createFrontendTokenRoute(options?: {
+    apiBaseUrl?: string;
+}): (request: NextRequest) => Promise<NextResponse<FrontendTokenResponse> | NextResponse<{
+    error: string;
+}>>;
+/**
+ * Default GET handler (for direct export)
+ */
+declare function GET(request: NextRequest): Promise<NextResponse<FrontendTokenResponse> | NextResponse<{
+    error: string;
+}>>;
+
+export { ArchivaError as A, type CreateEventInput as C, type EventChange as E, type FrontendTokenResponse as F, GET as G, type LoadEventsParams as L, type PageResult as P, createEvents as a, createFrontendTokenGET as b, createEvent as c, createFrontendTokenRoute as d, type CreateEventOptions as e, type AuditEventListItem as f, loadEvents as l };

package/dist/index-BJ8aJsbs.d.ts

@@ -0,0 +1,139 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+type EventChange = {
+    op: "set" | "unset" | "add" | "remove" | "replace" | string;
+    path: string;
+    before?: unknown;
+    after?: unknown;
+};
+type CreateEventInput = {
+    action: string;
+    entityType: string;
+    entityId: string;
+    actorType?: string;
+    actorId?: string;
+    actorDisplay?: string;
+    occurredAt?: string;
+    source?: string;
+    context?: Record<string, unknown>;
+    changes?: EventChange[];
+};
+type CreateEventOptions = {
+    idempotencyKey?: string;
+    requestId?: string;
+};
+type AuditEventListItem = {
+    id: string;
+    receivedAt: string;
+    action: string;
+    entityType: string;
+    entityId: string;
+    actorId: string | null;
+    actorType?: 'user' | 'service' | 'system';
+    actorDisplay?: string | null;
+    source: string | null;
+};
+type PageResult<T> = {
+    items: T[];
+    nextCursor?: string;
+};
+type LoadEventsParams = {
+    entityId?: string;
+    actorId?: string;
+    entityType?: string;
+    actorType?: 'user' | 'service' | 'system';
+    limit?: number;
+    cursor?: string;
+};
+declare class ArchivaError extends Error {
+    statusCode: number;
+    code: "UNAUTHORIZED" | "FORBIDDEN" | "PAYLOAD_TOO_LARGE" | "RATE_LIMITED" | "IDEMPOTENCY_CONFLICT" | "HTTP_ERROR";
+    retryAfterSeconds?: number;
+    details?: unknown;
+    constructor(params: {
+        statusCode: number;
+        code: "UNAUTHORIZED" | "FORBIDDEN" | "PAYLOAD_TOO_LARGE" | "RATE_LIMITED" | "IDEMPOTENCY_CONFLICT" | "HTTP_ERROR";
+        message: string;
+        retryAfterSeconds?: number;
+        details?: unknown;
+    });
+}
+
+/**
+ * Server action to load audit events
+ *
+ * @param params - Query parameters for filtering events
+ * @param apiKey - Optional API key (otherwise uses ARCHIVA_SECRET_KEY env var)
+ * @returns Paginated list of audit events
+ */
+declare function loadEvents(params: LoadEventsParams, apiKey?: string): Promise<PageResult<AuditEventListItem>>;
+/**
+ * Server action to create a single audit event
+ *
+ * @param event - Event data to create
+ * @param options - Optional idempotency and request ID options
+ * @param apiKey - Optional API key (otherwise uses ARCHIVA_SECRET_KEY env var)
+ * @returns Created event ID and replay status
+ */
+declare function createEvent(event: CreateEventInput, options?: CreateEventOptions, apiKey?: string): Promise<{
+    eventId: string;
+    replayed: boolean;
+}>;
+/**
+ * Server action to create multiple audit events (bulk)
+ *
+ * @param events - Array of events to create
+ * @param options - Optional idempotency and request ID options
+ * @param apiKey - Optional API key (otherwise uses ARCHIVA_SECRET_KEY env var)
+ * @returns Array of created event IDs
+ */
+declare function createEvents(events: CreateEventInput[], options?: CreateEventOptions, apiKey?: string): Promise<{
+    eventIds: string[];
+}>;
+
+interface FrontendTokenResponse {
+    token: string;
+    expiresAt: number;
+}
+/**
+ * Fetches a frontend token from the Archiva API
+ *
+ * @param projectId - Optional project ID for scoping
+ * @param apiBaseUrl - Archiva API base URL (defaults to https://api.archiva.app)
+ * @returns Frontend token response
+ */
+declare function createFrontendTokenGET(projectId?: string, apiBaseUrl?: string): Promise<FrontendTokenResponse>;
+
+/**
+ * Next.js route handler for GET /api/archiva/frontend-token
+ *
+ * This handler can be used in the host app's route file:
+ *
+ * ```ts
+ * // app/api/archiva/frontend-token/route.ts
+ * export { GET } from '@archiva/archiva-nextjs/server';
+ * ```
+ *
+ * Or with custom configuration:
+ *
+ * ```ts
+ * import { createFrontendTokenRoute } from '@archiva/archiva-nextjs/server';
+ *
+ * export const GET = createFrontendTokenRoute({
+ *   apiBaseUrl: process.env.ARCHIVA_API_URL,
+ * });
+ * ```
+ */
+declare function createFrontendTokenRoute(options?: {
+    apiBaseUrl?: string;
+}): (request: NextRequest) => Promise<NextResponse<FrontendTokenResponse> | NextResponse<{
+    error: string;
+}>>;
+/**
+ * Default GET handler (for direct export)
+ */
+declare function GET(request: NextRequest): Promise<NextResponse<FrontendTokenResponse> | NextResponse<{
+    error: string;
+}>>;
+
+export { ArchivaError as A, type CreateEventInput as C, type EventChange as E, type FrontendTokenResponse as F, GET as G, type LoadEventsParams as L, type PageResult as P, createEvents as a, createFrontendTokenGET as b, createEvent as c, createFrontendTokenRoute as d, type CreateEventOptions as e, type AuditEventListItem as f, loadEvents as l };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 export { ArchivaProvider, ArchivaProviderProps } from './react/index.mjs';
-export { A as ArchivaError, f as AuditEventListItem, C as CreateEventInput, e as CreateEventOptions, E as EventChange, F as FrontendTokenResponse, G as GET, L as LoadEventsParams, P as PageResult, c as createEvent, a as createEvents, b as createFrontendTokenGET, d as createFrontendTokenRoute, l as loadEvents } from './index-D6XeJsvH.mjs';
+export { A as ArchivaError, f as AuditEventListItem, C as CreateEventInput, e as CreateEventOptions, E as EventChange, F as FrontendTokenResponse, G as GET, L as LoadEventsParams, P as PageResult, c as createEvent, a as createEvents, b as createFrontendTokenGET, d as createFrontendTokenRoute, l as loadEvents } from './index-BJ8aJsbs.mjs';
 import 'react/jsx-runtime';
 import 'react';
 import 'next/server';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { ArchivaProvider, ArchivaProviderProps } from './react/index.js';
-export { A as ArchivaError, f as AuditEventListItem, C as CreateEventInput, e as CreateEventOptions, E as EventChange, F as FrontendTokenResponse, G as GET, L as LoadEventsParams, P as PageResult, c as createEvent, a as createEvents, b as createFrontendTokenGET, d as createFrontendTokenRoute, l as loadEvents } from './index-D6XeJsvH.js';
+export { A as ArchivaError, f as AuditEventListItem, C as CreateEventInput, e as CreateEventOptions, E as EventChange, F as FrontendTokenResponse, G as GET, L as LoadEventsParams, P as PageResult, c as createEvent, a as createEvents, b as createFrontendTokenGET, d as createFrontendTokenRoute, l as loadEvents } from './index-BJ8aJsbs.js';
 import 'react/jsx-runtime';
 import 'react';
 import 'next/server';

package/dist/index.js

@@ -299,6 +299,9 @@ async function loadEvents(apiKey, params, baseUrl = DEFAULT_BASE_URL) {
   if (params.entityType) {
     url.searchParams.set("entityType", params.entityType);
   }
+  if (params.actorType) {
+    url.searchParams.set("actorType", params.actorType);
+  }
   if (params.limit) {
     url.searchParams.set("limit", String(params.limit));
   }
@@ -320,8 +323,30 @@ async function loadEvents(apiKey, params, baseUrl = DEFAULT_BASE_URL) {
       details: payload
     });
   }
+  const items = payload.items.map((item) => {
+    if (typeof item !== "object" || item === null) {
+      throw new ArchivaError({
+        statusCode: response.status,
+        code: "HTTP_ERROR",
+        message: "Invalid item format in response",
+        details: item
+      });
+    }
+    const event = item;
+    return {
+      id: String(event.id ?? ""),
+      receivedAt: String(event.receivedAt ?? ""),
+      action: String(event.action ?? ""),
+      entityType: String(event.entityType ?? ""),
+      entityId: String(event.entityId ?? ""),
+      actorId: event.actorId !== null && event.actorId !== void 0 ? String(event.actorId) : null,
+      actorType: event.actorType && (event.actorType === "user" || event.actorType === "service" || event.actorType === "system") ? event.actorType : void 0,
+      actorDisplay: event.actorDisplay !== null && event.actorDisplay !== void 0 ? String(event.actorDisplay) : void 0,
+      source: event.source !== null && event.source !== void 0 ? String(event.source) : null
+    };
+  });
   return {
-    items: payload.items,
+    items,
     nextCursor: typeof payload.nextCursor === "string" ? payload.nextCursor : void 0
   };
 }

package/dist/index.mjs

@@ -9,7 +9,7 @@ import {
   createFrontendTokenGET,
   createFrontendTokenRoute,
   loadEvents
-} from "./chunk-WW7LXHTM.mjs";
+} from "./chunk-SQG3CD5M.mjs";
 export {
   ArchivaError,
   ArchivaProvider,

package/dist/react/client.js

@@ -119,30 +119,32 @@ var CloudCogIcon = ({ className }) => /* @__PURE__ */ (0, import_jsx_runtime2.js
 );
 function eventToTimelineItem(event, getActorAvatar) {
   const actorId = event.actorId;
-  let actorType = "user";
+  const actorType = event.actorType || "user";
   let actorIdPart = actorId || "";
-  let actorDisplay = "";
-  if (actorId) {
+  if (actorId && actorId.includes(":")) {
+    const [, ...rest] = actorId.split(":");
+    actorIdPart = rest.join(":") || actorId;
+  }
+  let actorDisplay = event.actorDisplay || null;
+  if (!actorDisplay && actorId) {
     if (actorId.includes(":")) {
       const [type, ...rest] = actorId.split(":");
-      actorType = type === "service" || type === "system" ? type : "user";
-      actorIdPart = rest.join(":");
+      const idPart = rest.join(":");
       if (type === "service" || type === "system") {
-        actorDisplay = `${type.charAt(0).toUpperCase() + type.slice(1)} ${actorIdPart.charAt(0).toUpperCase() + actorIdPart.slice(1)}`;
+        actorDisplay = `${type.charAt(0).toUpperCase() + type.slice(1)} ${idPart.charAt(0).toUpperCase() + idPart.slice(1)}`;
       } else {
-        actorDisplay = actorIdPart.charAt(0).toUpperCase() + actorIdPart.slice(1);
+        actorDisplay = idPart.charAt(0).toUpperCase() + idPart.slice(1);
       }
     } else {
-      actorIdPart = actorId;
       actorDisplay = actorId.charAt(0).toUpperCase() + actorId.slice(1);
     }
-  } else {
+  }
+  if (!actorDisplay) {
     actorDisplay = "Unknown Actor";
-    actorIdPart = "unknown";
   }
   const userName = actorDisplay;
-  const userHandle = actorIdPart;
-  const initials = actorIdPart.charAt(0).toUpperCase();
+  const userHandle = actorIdPart || "unknown";
+  const initials = userHandle.charAt(0).toUpperCase();
   const actorAvatarOrIcon = actorId && getActorAvatar ? getActorAvatar(actorId) : void 0;
   let actorAvatar = void 0;
   let actorIcon = void 0;
@@ -189,6 +191,9 @@ async function fetchEventsWithRetry(apiBaseUrl, getToken, forceRefreshToken, par
   if (params.entityType) {
     url.searchParams.set("entityType", params.entityType);
   }
+  if (params.actorType) {
+    url.searchParams.set("actorType", params.actorType);
+  }
   if (params.limit) {
     url.searchParams.set("limit", String(params.limit));
   }
@@ -318,22 +323,18 @@ function SimpleAvatar({
     }
   );
 }
-function getActorType(actorId) {
-  if (!actorId) return "user";
-  if (actorId.includes(":")) {
-    const [type] = actorId.split(":");
-    if (type === "service" || type === "system") {
-      return type;
-    }
-  }
-  return "user";
-}
 function applyClientSideFilters(events, searchQuery, showSystemAndServices) {
   let filtered = events;
   if (!showSystemAndServices) {
     filtered = filtered.filter((event) => {
-      const actorType = getActorType(event.actorId);
-      return actorType === "user";
+      if (event.actorType) {
+        return event.actorType === "user";
+      }
+      if (event.actorId && event.actorId.includes(":")) {
+        const [type] = event.actorId.split(":");
+        return type !== "service" && type !== "system";
+      }
+      return true;
     });
   }
   if (!searchQuery.trim()) {
@@ -341,7 +342,7 @@ function applyClientSideFilters(events, searchQuery, showSystemAndServices) {
   }
   const query = searchQuery.toLowerCase();
   return filtered.filter((event) => {
-    return event.action.toLowerCase().includes(query) || event.entityType.toLowerCase().includes(query) || event.entityId.toLowerCase().includes(query) || event.actorId && event.actorId.toLowerCase().includes(query) || event.source && event.source.toLowerCase().includes(query);
+    return event.action.toLowerCase().includes(query) || event.entityType.toLowerCase().includes(query) || event.entityId.toLowerCase().includes(query) || event.actorId && event.actorId.toLowerCase().includes(query) || event.source && event.source.toLowerCase().includes(query) || event.actorDisplay && event.actorDisplay.toLowerCase().includes(query);
   });
 }
 function Timeline({
@@ -372,6 +373,8 @@ function Timeline({
           entityId,
           actorId,
           entityType,
+          // Filter by actorType on API side
+          actorType: showSystemAndServices ? void 0 : "user",
           limit: initialLimit,
           cursor: options?.reset ? void 0 : options?.currentCursor ?? cursor
         };
@@ -390,13 +393,13 @@ function Timeline({
         setLoading(false);
       }
     },
-    [entityId, actorId, entityType, initialLimit, apiBaseUrl, getToken, forceRefreshToken, cursor]
+    [entityId, actorId, entityType, initialLimit, apiBaseUrl, getToken, forceRefreshToken, cursor, showSystemAndServices]
   );
   React2.useEffect(() => {
     setCursor(void 0);
     setAllEvents([]);
     void load({ reset: true });
-  }, [entityId, actorId, entityType]);
+  }, [entityId, actorId, entityType, showSystemAndServices]);
   const filteredEvents = React2.useMemo(() => {
     return applyClientSideFilters(allEvents, searchQuery, showSystemAndServices);
   }, [allEvents, searchQuery, showSystemAndServices]);

package/dist/react/client.mjs

@@ -74,30 +74,32 @@ var CloudCogIcon = ({ className }) => /* @__PURE__ */ jsxs(
 );
 function eventToTimelineItem(event, getActorAvatar) {
   const actorId = event.actorId;
-  let actorType = "user";
+  const actorType = event.actorType || "user";
   let actorIdPart = actorId || "";
-  let actorDisplay = "";
-  if (actorId) {
+  if (actorId && actorId.includes(":")) {
+    const [, ...rest] = actorId.split(":");
+    actorIdPart = rest.join(":") || actorId;
+  }
+  let actorDisplay = event.actorDisplay || null;
+  if (!actorDisplay && actorId) {
     if (actorId.includes(":")) {
       const [type, ...rest] = actorId.split(":");
-      actorType = type === "service" || type === "system" ? type : "user";
-      actorIdPart = rest.join(":");
+      const idPart = rest.join(":");
       if (type === "service" || type === "system") {
-        actorDisplay = `${type.charAt(0).toUpperCase() + type.slice(1)} ${actorIdPart.charAt(0).toUpperCase() + actorIdPart.slice(1)}`;
+        actorDisplay = `${type.charAt(0).toUpperCase() + type.slice(1)} ${idPart.charAt(0).toUpperCase() + idPart.slice(1)}`;
       } else {
-        actorDisplay = actorIdPart.charAt(0).toUpperCase() + actorIdPart.slice(1);
+        actorDisplay = idPart.charAt(0).toUpperCase() + idPart.slice(1);
       }
     } else {
-      actorIdPart = actorId;
       actorDisplay = actorId.charAt(0).toUpperCase() + actorId.slice(1);
     }
-  } else {
+  }
+  if (!actorDisplay) {
     actorDisplay = "Unknown Actor";
-    actorIdPart = "unknown";
   }
   const userName = actorDisplay;
-  const userHandle = actorIdPart;
-  const initials = actorIdPart.charAt(0).toUpperCase();
+  const userHandle = actorIdPart || "unknown";
+  const initials = userHandle.charAt(0).toUpperCase();
   const actorAvatarOrIcon = actorId && getActorAvatar ? getActorAvatar(actorId) : void 0;
   let actorAvatar = void 0;
   let actorIcon = void 0;
@@ -144,6 +146,9 @@ async function fetchEventsWithRetry(apiBaseUrl, getToken, forceRefreshToken, par
   if (params.entityType) {
     url.searchParams.set("entityType", params.entityType);
   }
+  if (params.actorType) {
+    url.searchParams.set("actorType", params.actorType);
+  }
   if (params.limit) {
     url.searchParams.set("limit", String(params.limit));
   }
@@ -273,22 +278,18 @@ function SimpleAvatar({
     }
   );
 }
-function getActorType(actorId) {
-  if (!actorId) return "user";
-  if (actorId.includes(":")) {
-    const [type] = actorId.split(":");
-    if (type === "service" || type === "system") {
-      return type;
-    }
-  }
-  return "user";
-}
 function applyClientSideFilters(events, searchQuery, showSystemAndServices) {
   let filtered = events;
   if (!showSystemAndServices) {
     filtered = filtered.filter((event) => {
-      const actorType = getActorType(event.actorId);
-      return actorType === "user";
+      if (event.actorType) {
+        return event.actorType === "user";
+      }
+      if (event.actorId && event.actorId.includes(":")) {
+        const [type] = event.actorId.split(":");
+        return type !== "service" && type !== "system";
+      }
+      return true;
     });
   }
   if (!searchQuery.trim()) {
@@ -296,7 +297,7 @@ function applyClientSideFilters(events, searchQuery, showSystemAndServices) {
   }
   const query = searchQuery.toLowerCase();
   return filtered.filter((event) => {
-    return event.action.toLowerCase().includes(query) || event.entityType.toLowerCase().includes(query) || event.entityId.toLowerCase().includes(query) || event.actorId && event.actorId.toLowerCase().includes(query) || event.source && event.source.toLowerCase().includes(query);
+    return event.action.toLowerCase().includes(query) || event.entityType.toLowerCase().includes(query) || event.entityId.toLowerCase().includes(query) || event.actorId && event.actorId.toLowerCase().includes(query) || event.source && event.source.toLowerCase().includes(query) || event.actorDisplay && event.actorDisplay.toLowerCase().includes(query);
   });
 }
 function Timeline({
@@ -327,6 +328,8 @@ function Timeline({
           entityId,
           actorId,
           entityType,
+          // Filter by actorType on API side
+          actorType: showSystemAndServices ? void 0 : "user",
           limit: initialLimit,
           cursor: options?.reset ? void 0 : options?.currentCursor ?? cursor
         };
@@ -345,13 +348,13 @@ function Timeline({
         setLoading(false);
       }
     },
-    [entityId, actorId, entityType, initialLimit, apiBaseUrl, getToken, forceRefreshToken, cursor]
+    [entityId, actorId, entityType, initialLimit, apiBaseUrl, getToken, forceRefreshToken, cursor, showSystemAndServices]
   );
   React.useEffect(() => {
     setCursor(void 0);
     setAllEvents([]);
     void load({ reset: true });
-  }, [entityId, actorId, entityType]);
+  }, [entityId, actorId, entityType, showSystemAndServices]);
   const filteredEvents = React.useMemo(() => {
     return applyClientSideFilters(allEvents, searchQuery, showSystemAndServices);
   }, [allEvents, searchQuery, showSystemAndServices]);

package/dist/server/index.d.mts

@@ -1,2 +1,2 @@
-export { f as AuditEventListItem, C as CreateEventInput, e as CreateEventOptions, F as FrontendTokenResponse, G as GET, L as LoadEventsParams, P as PageResult, c as createEvent, a as createEvents, b as createFrontendTokenGET, d as createFrontendTokenRoute, l as loadEvents } from '../index-D6XeJsvH.mjs';
+export { f as AuditEventListItem, C as CreateEventInput, e as CreateEventOptions, F as FrontendTokenResponse, G as GET, L as LoadEventsParams, P as PageResult, c as createEvent, a as createEvents, b as createFrontendTokenGET, d as createFrontendTokenRoute, l as loadEvents } from '../index-BJ8aJsbs.mjs';
 import 'next/server';

package/dist/server/index.d.ts

@@ -1,2 +1,2 @@
-export { f as AuditEventListItem, C as CreateEventInput, e as CreateEventOptions, F as FrontendTokenResponse, G as GET, L as LoadEventsParams, P as PageResult, c as createEvent, a as createEvents, b as createFrontendTokenGET, d as createFrontendTokenRoute, l as loadEvents } from '../index-D6XeJsvH.js';
+export { f as AuditEventListItem, C as CreateEventInput, e as CreateEventOptions, F as FrontendTokenResponse, G as GET, L as LoadEventsParams, P as PageResult, c as createEvent, a as createEvents, b as createFrontendTokenGET, d as createFrontendTokenRoute, l as loadEvents } from '../index-BJ8aJsbs.js';
 import 'next/server';

package/dist/server/index.js

@@ -173,6 +173,9 @@ async function loadEvents(apiKey, params, baseUrl = DEFAULT_BASE_URL) {
   if (params.entityType) {
     url.searchParams.set("entityType", params.entityType);
   }
+  if (params.actorType) {
+    url.searchParams.set("actorType", params.actorType);
+  }
   if (params.limit) {
     url.searchParams.set("limit", String(params.limit));
   }
@@ -194,8 +197,30 @@ async function loadEvents(apiKey, params, baseUrl = DEFAULT_BASE_URL) {
       details: payload
     });
   }
+  const items = payload.items.map((item) => {
+    if (typeof item !== "object" || item === null) {
+      throw new ArchivaError({
+        statusCode: response.status,
+        code: "HTTP_ERROR",
+        message: "Invalid item format in response",
+        details: item
+      });
+    }
+    const event = item;
+    return {
+      id: String(event.id ?? ""),
+      receivedAt: String(event.receivedAt ?? ""),
+      action: String(event.action ?? ""),
+      entityType: String(event.entityType ?? ""),
+      entityId: String(event.entityId ?? ""),
+      actorId: event.actorId !== null && event.actorId !== void 0 ? String(event.actorId) : null,
+      actorType: event.actorType && (event.actorType === "user" || event.actorType === "service" || event.actorType === "system") ? event.actorType : void 0,
+      actorDisplay: event.actorDisplay !== null && event.actorDisplay !== void 0 ? String(event.actorDisplay) : void 0,
+      source: event.source !== null && event.source !== void 0 ? String(event.source) : null
+    };
+  });
   return {
-    items: payload.items,
+    items,
     nextCursor: typeof payload.nextCursor === "string" ? payload.nextCursor : void 0
   };
 }

package/dist/server/index.mjs

@@ -5,7 +5,7 @@ import {
   createFrontendTokenGET,
   createFrontendTokenRoute,
   loadEvents
-} from "../chunk-WW7LXHTM.mjs";
+} from "../chunk-SQG3CD5M.mjs";
 export {
   GET,
   createEvent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archiva/archiva-nextjs",
-  "version": "0.2.06",
+  "version": "0.2.08",
   "description": "Archiva Next.js SDK - Server Actions and Timeline Component",
   "main": "dist/index.js",
   "module": "dist/index.mjs",