@archiva/archiva-nextjs 0.1.0

package/README.md

@@ -0,0 +1,166 @@
+# @archiva/archiva-nextjs
+
+Next.js SDK for Archiva - Server Actions and Timeline Component
+
+## Installation
+
+```bash
+npm install @archiva/archiva-nextjs
+# or
+pnpm add @archiva/archiva-nextjs
+# or
+yarn add @archiva/archiva-nextjs
+```
+
+## Setup
+
+Set the `ARCHIVA_SECRET_KEY` environment variable in your `.env.local` file:
+
+```env
+ARCHIVA_SECRET_KEY=pk_test_xxxxx
+```
+
+## Usage
+
+### ArchivaProvider (Server Component)
+
+Wrap your application (or specific routes) with the ArchivaProvider component:
+
+```tsx
+import { ArchivaProvider } from '@archiva/archiva-nextjs';
+
+export default function Layout({ children }) {
+  return (
+    <ArchivaProvider>
+      {children}
+    </ArchivaProvider>
+  );
+}
+```
+
+### Server Actions
+
+#### loadEvents
+
+Load audit events with filtering and pagination:
+
+```tsx
+import { loadEvents } from '@archiva/archiva-nextjs';
+
+// In a Server Component or Server Action
+const events = await loadEvents({
+  entityId: 'entity_123',
+  actorId: 'actor_456',
+  entityType: 'invoice',
+  limit: 25,
+  cursor: 'optional_cursor',
+});
+```
+
+#### createEvent
+
+Create a single audit event:
+
+```tsx
+import { createEvent } from '@archiva/archiva-nextjs';
+
+const result = await createEvent({
+  action: 'update',
+  entityType: 'invoice',
+  entityId: 'inv_123',
+  actorType: 'user',
+  actorId: 'usr_123',
+  actorDisplay: 'John Doe',
+  occurredAt: new Date().toISOString(),
+  source: 'web',
+  context: {
+    requestId: 'req_123',
+  },
+  changes: [
+    {
+      op: 'set',
+      path: 'status',
+      before: 'draft',
+      after: 'sent',
+    },
+  ],
+});
+```
+
+#### createEvents (Bulk)
+
+Create multiple events at once:
+
+```tsx
+import { createEvents } from '@archiva/archiva-nextjs';
+
+const result = await createEvents([
+  {
+    action: 'create',
+    entityType: 'invoice',
+    entityId: 'inv_123',
+    // ... other fields
+  },
+  {
+    action: 'update',
+    entityType: 'invoice',
+    entityId: 'inv_123',
+    // ... other fields
+  },
+]);
+```
+
+### Timeline Component (Client Component)
+
+Display a timeline of audit events:
+
+```tsx
+'use client';
+
+import { Timeline } from '@archiva/archiva-nextjs';
+
+export function InvoiceTimeline({ invoiceId }: { invoiceId: string }) {
+  return (
+    <Timeline
+      entityId={invoiceId}
+      entityType="invoice"
+      initialLimit={25}
+    />
+  );
+}
+```
+
+## API Reference
+
+### LoadEventsParams
+
+```ts
+type LoadEventsParams = {
+  entityId?: string;
+  actorId?: string;
+  entityType?: string;
+  limit?: number;
+  cursor?: string;
+};
+```
+
+### CreateEventInput
+
+```ts
+type CreateEventInput = {
+  action: string;
+  entityType: string;
+  entityId: string;
+  actorType?: string;
+  actorId?: string;
+  actorDisplay?: string;
+  occurredAt?: string;
+  source?: string;
+  context?: Record<string, unknown>;
+  changes?: EventChange[];
+};
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,125 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type ArchivaProviderProps = {
+    children: ReactNode;
+    apiKey?: string;
+};
+/**
+ * Server-only provider component for Archiva.
+ * This component validates the API key format and provides configuration
+ * for server actions (loadEvents, createEvents).
+ *
+ * The API key should be passed via props or set as ARCHIVA_SECRET_KEY environment variable.
+ */
+declare function ArchivaProvider({ children }: ArchivaProviderProps): react_jsx_runtime.JSX.Element;
+
+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;
+    source: string | null;
+};
+type PageResult<T> = {
+    items: T[];
+    nextCursor?: string;
+};
+type LoadEventsParams = {
+    entityId?: string;
+    actorId?: string;
+    entityType?: string;
+    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[];
+}>;
+
+type TimelineItem = {
+    id: string | number;
+    title: string;
+    description?: string;
+    timestamp: Date | string;
+    badge?: string | number;
+    data?: unknown;
+    className?: string;
+};
+type TimelineProps = {
+    entityId?: string;
+    actorId?: string;
+    entityType?: string;
+    initialLimit?: number;
+    className?: string;
+    emptyMessage?: string;
+    apiKey?: string;
+};
+declare function Timeline({ entityId, actorId, entityType, initialLimit, className, emptyMessage, apiKey, }: TimelineProps): react_jsx_runtime.JSX.Element;
+
+export { ArchivaError, ArchivaProvider, type ArchivaProviderProps, type AuditEventListItem, type CreateEventInput, type CreateEventOptions, type EventChange, type LoadEventsParams, type PageResult, Timeline, type TimelineItem, type TimelineProps, createEvent, createEvents, loadEvents };

package/dist/index.d.ts

@@ -0,0 +1,125 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type ArchivaProviderProps = {
+    children: ReactNode;
+    apiKey?: string;
+};
+/**
+ * Server-only provider component for Archiva.
+ * This component validates the API key format and provides configuration
+ * for server actions (loadEvents, createEvents).
+ *
+ * The API key should be passed via props or set as ARCHIVA_SECRET_KEY environment variable.
+ */
+declare function ArchivaProvider({ children }: ArchivaProviderProps): react_jsx_runtime.JSX.Element;
+
+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;
+    source: string | null;
+};
+type PageResult<T> = {
+    items: T[];
+    nextCursor?: string;
+};
+type LoadEventsParams = {
+    entityId?: string;
+    actorId?: string;
+    entityType?: string;
+    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[];
+}>;
+
+type TimelineItem = {
+    id: string | number;
+    title: string;
+    description?: string;
+    timestamp: Date | string;
+    badge?: string | number;
+    data?: unknown;
+    className?: string;
+};
+type TimelineProps = {
+    entityId?: string;
+    actorId?: string;
+    entityType?: string;
+    initialLimit?: number;
+    className?: string;
+    emptyMessage?: string;
+    apiKey?: string;
+};
+declare function Timeline({ entityId, actorId, entityType, initialLimit, className, emptyMessage, apiKey, }: TimelineProps): react_jsx_runtime.JSX.Element;
+
+export { ArchivaError, ArchivaProvider, type ArchivaProviderProps, type AuditEventListItem, type CreateEventInput, type CreateEventOptions, type EventChange, type LoadEventsParams, type PageResult, Timeline, type TimelineItem, type TimelineProps, createEvent, createEvents, loadEvents };

package/dist/index.js

@@ -0,0 +1,382 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.tsx
+var index_exports = {};
+__export(index_exports, {
+  ArchivaProvider: () => ArchivaProvider,
+  Timeline: () => Timeline,
+  createEvent: () => createEvent2,
+  createEvents: () => createEvents2,
+  loadEvents: () => loadEvents2
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/provider.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function ArchivaProvider({ children }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children });
+}
+
+// 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.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
+    });
+  }
+  return {
+    items: payload.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/timeline.tsx
+var React = __toESM(require("react"));
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function formatTimestamp(timestamp) {
+  const date = typeof timestamp === "string" ? new Date(timestamp) : timestamp;
+  return date.toLocaleDateString(void 0, {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "2-digit"
+  });
+}
+function eventToTimelineItem(event) {
+  return {
+    id: event.id,
+    title: event.action,
+    description: `${event.entityType} ${event.entityId}`,
+    timestamp: event.receivedAt,
+    badge: event.actorId ?? void 0,
+    data: event
+  };
+}
+function Timeline({
+  entityId,
+  actorId,
+  entityType,
+  initialLimit = 25,
+  className,
+  emptyMessage = "No events yet.",
+  apiKey
+}) {
+  const [items, setItems] = React.useState([]);
+  const [cursor, setCursor] = React.useState(void 0);
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const [hasMore, setHasMore] = React.useState(false);
+  const load = React.useCallback(async (options) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const params = {
+        entityId,
+        actorId,
+        entityType,
+        limit: initialLimit,
+        cursor: options?.reset ? void 0 : options?.currentCursor ?? cursor
+      };
+      const response = await loadEvents2(params, apiKey);
+      const newItems = response.items.map(eventToTimelineItem);
+      setItems((prev) => options?.reset ? newItems : [...prev, ...newItems]);
+      setCursor(response.nextCursor);
+      setHasMore(Boolean(response.nextCursor));
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [entityId, actorId, entityType, initialLimit, apiKey]);
+  React.useEffect(() => {
+    setCursor(void 0);
+    setItems([]);
+    void load({ reset: true });
+  }, [entityId, actorId, entityType, load]);
+  if (loading && items.length === 0) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: className || "", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { children: "Loading events..." }) });
+  }
+  if (error) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: className || "", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: { color: "red" }, children: [
+      "Error: ",
+      error
+    ] }) });
+  }
+  if (items.length === 0) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: className || "", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { children: emptyMessage }) });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: className || "", style: { width: "100%" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: { position: "relative" }, children: items.map((item, index) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+      "div",
+      {
+        style: {
+          position: "relative",
+          display: "flex",
+          gap: "1rem",
+          paddingBottom: index < items.length - 1 ? "2rem" : "0"
+        },
+        children: [
+          index < items.length - 1 && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+            "div",
+            {
+              style: {
+                position: "absolute",
+                left: "1.25rem",
+                top: "3rem",
+                height: "calc(100% - 3rem)",
+                width: "2px",
+                backgroundColor: "#e5e7eb"
+              }
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+            "div",
+            {
+              style: {
+                position: "relative",
+                zIndex: 10,
+                width: "2.5rem",
+                height: "2.5rem",
+                borderRadius: "50%",
+                backgroundColor: "#f3f4f6",
+                border: "2px solid #fff",
+                display: "flex",
+                alignItems: "center",
+                justifyContent: "center",
+                flexShrink: 0
+              },
+              children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+                "div",
+                {
+                  style: {
+                    width: "0.75rem",
+                    height: "0.75rem",
+                    borderRadius: "50%",
+                    backgroundColor: "#6b7280"
+                  }
+                }
+              )
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: { flex: 1, paddingBottom: "2rem" }, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: { display: "flex", alignItems: "start", justifyContent: "space-between", gap: "0.5rem" }, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: { flex: 1 }, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: "0.5rem" }, children: [
+              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("h4", { style: { fontWeight: 600, margin: 0 }, children: item.title }),
+              item.badge && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+                "span",
+                {
+                  style: {
+                    fontSize: "0.75rem",
+                    padding: "0.125rem 0.5rem",
+                    borderRadius: "0.375rem",
+                    backgroundColor: "#f3f4f6"
+                  },
+                  children: item.badge
+                }
+              )
+            ] }),
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { style: { fontSize: "0.875rem", color: "#6b7280", margin: "0.25rem 0 0 0" }, children: formatTimestamp(item.timestamp) }),
+            item.description && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { style: { fontSize: "0.875rem", color: "#6b7280", margin: "0.5rem 0 0 0" }, children: item.description })
+          ] }) }) })
+        ]
+      },
+      item.id
+    )) }),
+    hasMore && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { style: { marginTop: "1rem" }, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "button",
+      {
+        type: "button",
+        onClick: () => load(),
+        disabled: loading,
+        style: {
+          padding: "0.5rem 1rem",
+          backgroundColor: loading ? "#d1d5db" : "#3b82f6",
+          color: "white",
+          border: "none",
+          borderRadius: "0.375rem",
+          cursor: loading ? "not-allowed" : "pointer"
+        },
+        children: loading ? "Loading..." : "Load more"
+      }
+    ) })
+  ] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ArchivaProvider,
+  Timeline,
+  createEvent,
+  createEvents,
+  loadEvents
+});

package/dist/index.mjs

@@ -0,0 +1,341 @@
+// src/provider.tsx
+import { Fragment, jsx } from "react/jsx-runtime";
+function ArchivaProvider({ children }) {
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+
+// 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.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
+    });
+  }
+  return {
+    items: payload.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/timeline.tsx
+import * as React from "react";
+import { jsx as jsx2, jsxs } from "react/jsx-runtime";
+function formatTimestamp(timestamp) {
+  const date = typeof timestamp === "string" ? new Date(timestamp) : timestamp;
+  return date.toLocaleDateString(void 0, {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "2-digit"
+  });
+}
+function eventToTimelineItem(event) {
+  return {
+    id: event.id,
+    title: event.action,
+    description: `${event.entityType} ${event.entityId}`,
+    timestamp: event.receivedAt,
+    badge: event.actorId ?? void 0,
+    data: event
+  };
+}
+function Timeline({
+  entityId,
+  actorId,
+  entityType,
+  initialLimit = 25,
+  className,
+  emptyMessage = "No events yet.",
+  apiKey
+}) {
+  const [items, setItems] = React.useState([]);
+  const [cursor, setCursor] = React.useState(void 0);
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const [hasMore, setHasMore] = React.useState(false);
+  const load = React.useCallback(async (options) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const params = {
+        entityId,
+        actorId,
+        entityType,
+        limit: initialLimit,
+        cursor: options?.reset ? void 0 : options?.currentCursor ?? cursor
+      };
+      const response = await loadEvents2(params, apiKey);
+      const newItems = response.items.map(eventToTimelineItem);
+      setItems((prev) => options?.reset ? newItems : [...prev, ...newItems]);
+      setCursor(response.nextCursor);
+      setHasMore(Boolean(response.nextCursor));
+    } catch (err) {
+      setError(err.message);
+    } finally {
+      setLoading(false);
+    }
+  }, [entityId, actorId, entityType, initialLimit, apiKey]);
+  React.useEffect(() => {
+    setCursor(void 0);
+    setItems([]);
+    void load({ reset: true });
+  }, [entityId, actorId, entityType, load]);
+  if (loading && items.length === 0) {
+    return /* @__PURE__ */ jsx2("div", { className: className || "", children: /* @__PURE__ */ jsx2("div", { children: "Loading events..." }) });
+  }
+  if (error) {
+    return /* @__PURE__ */ jsx2("div", { className: className || "", children: /* @__PURE__ */ jsxs("div", { style: { color: "red" }, children: [
+      "Error: ",
+      error
+    ] }) });
+  }
+  if (items.length === 0) {
+    return /* @__PURE__ */ jsx2("div", { className: className || "", children: /* @__PURE__ */ jsx2("div", { children: emptyMessage }) });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: className || "", style: { width: "100%" }, children: [
+    /* @__PURE__ */ jsx2("div", { style: { position: "relative" }, children: items.map((item, index) => /* @__PURE__ */ jsxs(
+      "div",
+      {
+        style: {
+          position: "relative",
+          display: "flex",
+          gap: "1rem",
+          paddingBottom: index < items.length - 1 ? "2rem" : "0"
+        },
+        children: [
+          index < items.length - 1 && /* @__PURE__ */ jsx2(
+            "div",
+            {
+              style: {
+                position: "absolute",
+                left: "1.25rem",
+                top: "3rem",
+                height: "calc(100% - 3rem)",
+                width: "2px",
+                backgroundColor: "#e5e7eb"
+              }
+            }
+          ),
+          /* @__PURE__ */ jsx2(
+            "div",
+            {
+              style: {
+                position: "relative",
+                zIndex: 10,
+                width: "2.5rem",
+                height: "2.5rem",
+                borderRadius: "50%",
+                backgroundColor: "#f3f4f6",
+                border: "2px solid #fff",
+                display: "flex",
+                alignItems: "center",
+                justifyContent: "center",
+                flexShrink: 0
+              },
+              children: /* @__PURE__ */ jsx2(
+                "div",
+                {
+                  style: {
+                    width: "0.75rem",
+                    height: "0.75rem",
+                    borderRadius: "50%",
+                    backgroundColor: "#6b7280"
+                  }
+                }
+              )
+            }
+          ),
+          /* @__PURE__ */ jsx2("div", { style: { flex: 1, paddingBottom: "2rem" }, children: /* @__PURE__ */ jsx2("div", { style: { display: "flex", alignItems: "start", justifyContent: "space-between", gap: "0.5rem" }, children: /* @__PURE__ */ jsxs("div", { style: { flex: 1 }, children: [
+            /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: "0.5rem" }, children: [
+              /* @__PURE__ */ jsx2("h4", { style: { fontWeight: 600, margin: 0 }, children: item.title }),
+              item.badge && /* @__PURE__ */ jsx2(
+                "span",
+                {
+                  style: {
+                    fontSize: "0.75rem",
+                    padding: "0.125rem 0.5rem",
+                    borderRadius: "0.375rem",
+                    backgroundColor: "#f3f4f6"
+                  },
+                  children: item.badge
+                }
+              )
+            ] }),
+            /* @__PURE__ */ jsx2("p", { style: { fontSize: "0.875rem", color: "#6b7280", margin: "0.25rem 0 0 0" }, children: formatTimestamp(item.timestamp) }),
+            item.description && /* @__PURE__ */ jsx2("p", { style: { fontSize: "0.875rem", color: "#6b7280", margin: "0.5rem 0 0 0" }, children: item.description })
+          ] }) }) })
+        ]
+      },
+      item.id
+    )) }),
+    hasMore && /* @__PURE__ */ jsx2("div", { style: { marginTop: "1rem" }, children: /* @__PURE__ */ jsx2(
+      "button",
+      {
+        type: "button",
+        onClick: () => load(),
+        disabled: loading,
+        style: {
+          padding: "0.5rem 1rem",
+          backgroundColor: loading ? "#d1d5db" : "#3b82f6",
+          color: "white",
+          border: "none",
+          borderRadius: "0.375rem",
+          cursor: loading ? "not-allowed" : "pointer"
+        },
+        children: loading ? "Loading..." : "Load more"
+      }
+    ) })
+  ] });
+}
+export {
+  ArchivaProvider,
+  Timeline,
+  createEvent2 as createEvent,
+  createEvents2 as createEvents,
+  loadEvents2 as loadEvents
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@archiva/archiva-nextjs",
+  "version": "0.1.0",
+  "description": "Archiva Next.js SDK - Server Actions and Timeline Component",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.tsx --format esm,cjs --dts",
+    "test": "vitest run --config vitest.config.ts"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "next": ">=13"
+  },
+  "dependencies": {
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.19",
+    "@types/react": "^18.2.55",
+    "@types/react-dom": "^18.2.19",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.3.3",
+    "tsup": "^8.0.1",
+    "vitest": "^1.2.2"
+  }
+}