@datum-cloud/activity-ui 0.1.0

package/dist/lib/errors.d.ts

@@ -0,0 +1,50 @@
+export interface ApiErrorResponse {
+    requestId?: string;
+    code?: string;
+    error?: string;
+    reason?: string;
+    message?: string;
+    path?: string;
+}
+export declare class ApiError extends Error {
+    statusCode: number;
+    code?: string | undefined;
+    requestId?: string | undefined;
+    path?: string | undefined;
+    constructor(statusCode: number, code?: string | undefined, message?: string, requestId?: string | undefined, path?: string | undefined);
+    get friendlyTitle(): string;
+    get friendlyMessage(): string;
+    get suggestion(): string | null;
+    get severity(): 'warning' | 'error';
+}
+/**
+ * Represents a network error (connection refused, DNS failure, etc.)
+ */
+export declare class NetworkError extends Error {
+    constructor(message?: string);
+    get friendlyTitle(): string;
+    get friendlyMessage(): string;
+    get suggestion(): string | null;
+    get severity(): 'warning' | 'error';
+}
+export declare function parseApiError(status: number, body: string): ApiError;
+/**
+ * Represents a watch stream error (connection lost, stream closed, etc.)
+ */
+export declare class StreamError extends Error {
+    cause?: Error | undefined;
+    constructor(message?: string, cause?: Error | undefined);
+    get friendlyTitle(): string;
+    get friendlyMessage(): string;
+    get suggestion(): string | null;
+    get severity(): 'warning' | 'error';
+}
+/**
+ * Default error formatter that uses the friendly error properties if available,
+ * otherwise falls back to the error message.
+ */
+export declare function defaultErrorFormatter(error: Error): {
+    message: string;
+    technical?: string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,QAAS,SAAQ,KAAK;IAExB,UAAU,EAAE,MAAM;IAClB,IAAI,CAAC,EAAE,MAAM;IAEb,SAAS,CAAC,EAAE,MAAM;IAClB,IAAI,CAAC,EAAE,MAAM;gBAJb,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,YAAA,EACpB,OAAO,CAAC,EAAE,MAAM,EACT,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,IAAI,CAAC,EAAE,MAAM,YAAA;IAMtB,IAAI,aAAa,IAAI,MAAM,CAuB1B;IAED,IAAI,eAAe,IAAI,MAAM,CAuB5B;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,QAAQ,IAAI,SAAS,GAAG,OAAO,CAWlC;CACF;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,CAAC,EAAE,MAAM;IAK5B,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,QAAQ,IAAI,SAAS,GAAG,OAAO,CAElC;CACF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAapE;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACC,KAAK,CAAC,EAAE,KAAK;gBAAtC,OAAO,CAAC,EAAE,MAAM,EAAS,KAAK,CAAC,EAAE,KAAK,YAAA;IAKlD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,IAAI,QAAQ,IAAI,SAAS,GAAG,OAAO,CAElC;CACF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAqB3F"}

package/dist/lib/extractFieldPaths.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Utility for extracting field paths from JSON objects
+ * Used to populate autocomplete suggestions in CEL editors
+ */
+/**
+ * Recursively extract all field paths from a JSON object
+ *
+ * @param obj - The object to extract paths from
+ * @param prefix - Current path prefix (for recursion)
+ * @param maxDepth - Maximum nesting depth to traverse (default: 5)
+ * @returns Array of CEL-compatible field paths (using bracket notation for special keys)
+ *
+ * @example
+ * extractFieldPaths({ objectRef: { name: "foo" }, annotations: { "k8s.io/key": "val" } })
+ * // Returns: ["objectRef.name", 'annotations["k8s.io/key"]']
+ */
+export declare function extractFieldPaths(obj: unknown, prefix?: string, maxDepth?: number): string[];
+/**
+ * Extract field paths from multiple objects and return unique sorted paths
+ *
+ * @param objects - Array of objects to extract paths from
+ * @param maxDepth - Maximum nesting depth to traverse (default: 5)
+ * @returns Sorted array of unique field paths
+ *
+ * @example
+ * extractFieldPathsFromMany([
+ *   { verb: "create", objectRef: { name: "foo" } },
+ *   { verb: "update", objectRef: { namespace: "bar" } }
+ * ])
+ * // Returns: ["objectRef.name", "objectRef.namespace", "verb"]
+ */
+export declare function extractFieldPathsFromMany(objects: unknown[], maxDepth?: number): string[];
+//# sourceMappingURL=extractFieldPaths.d.ts.map

package/dist/lib/extractFieldPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractFieldPaths.d.ts","sourceRoot":"","sources":["../../src/lib/extractFieldPaths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,MAAM,SAAK,EACX,QAAQ,SAAI,GACX,MAAM,EAAE,CA+DV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAAE,EAClB,QAAQ,SAAI,GACX,MAAM,EAAE,CASV"}

package/dist/lib/utils.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/types/activity.d.ts

@@ -0,0 +1,366 @@
+/**
+ * TypeScript types for the Activity API (activity.miloapis.com/v1alpha1)
+ * Based on the Activity Stream System enhancement specification
+ */
+import type { ReactNode } from 'react';
+import type { ObjectMeta } from './index';
+/**
+ * Change source classification for activities
+ * - human: User actions, service accounts with `initiated-by: user` annotation
+ * - system: Controller reconciliation, operator actions, scheduled jobs
+ */
+export type ChangeSource = 'human' | 'system';
+/**
+ * Actor types in the activity system
+ */
+export type ActorType = 'user' | 'machine account' | 'controller';
+/**
+ * Origin types for activity records
+ */
+export type OriginType = 'audit' | 'event';
+/**
+ * Tenant scope levels
+ */
+export type TenantType = 'platform' | 'organization' | 'project' | 'user';
+/**
+ * Resource reference for linking to resources in the portal
+ */
+export interface ResourceRef {
+    apiGroup: string;
+    apiVersion?: string;
+    kind: string;
+    name: string;
+    namespace?: string;
+    uid?: string;
+}
+/**
+ * Context for resolving resource links
+ * Contains optional tenant information for multi-tenant portal navigation
+ */
+export interface ResourceLinkContext {
+    /** Current tenant context for scoped navigation */
+    tenant?: Tenant;
+}
+/**
+ * Actor who performed the action
+ */
+export interface Actor {
+    type: ActorType;
+    name: string;
+    uid: string;
+    email?: string;
+}
+/**
+ * Linkable entity in the summary for portal rendering
+ */
+export interface ActivityLink {
+    /** Text substring in summary that should be linked */
+    marker: string;
+    /** The resource to link to when the marker is clicked */
+    resource: ResourceRef;
+}
+/**
+ * Tenant scope for multi-tenant isolation
+ */
+export interface Tenant {
+    type: TenantType;
+    name: string;
+    /** Unique identifier - required for user-scoped tenants where routes use ID instead of name */
+    id?: string;
+}
+/**
+ * Field-level change with old and new values
+ */
+export interface FieldChange {
+    field: string;
+    old?: string;
+    new?: string;
+}
+/**
+ * Origin of the activity record for correlation
+ */
+export interface ActivityOrigin {
+    /** Source type: "audit" or "event" */
+    type: OriginType;
+    /** Correlation ID (auditID or event.metadata.uid) */
+    id: string;
+}
+/**
+ * Activity spec containing the translated activity data
+ */
+export interface ActivitySpec {
+    /** Human-readable description generated from ActivityPolicy templates */
+    summary: string;
+    /** Who initiated the change: "human" or "system" */
+    changeSource: ChangeSource;
+    /** The actor who performed the action */
+    actor: Actor;
+    /** The resource that was affected by this activity */
+    resource: ResourceRef;
+    /** Linkable entities in the summary for portal rendering */
+    links?: ActivityLink[];
+    /** Tenant scope for multi-tenant isolation */
+    tenant?: Tenant;
+    /** Field-level changes with old and new values */
+    changes?: FieldChange[];
+    /** Origin of this activity record for correlation */
+    origin: ActivityOrigin;
+}
+/**
+ * Activity resource representing a single translated activity record
+ */
+export interface Activity {
+    apiVersion: 'activity.miloapis.com/v1alpha1';
+    kind: 'Activity';
+    metadata: ObjectMeta;
+    spec: ActivitySpec;
+}
+/**
+ * Activity list response with pagination
+ */
+export interface ActivityList {
+    apiVersion: 'activity.miloapis.com/v1alpha1';
+    kind: 'ActivityList';
+    metadata?: {
+        continue?: string;
+        resourceVersion?: string;
+    };
+    items: Activity[];
+}
+/**
+ * Query parameters for listing activities
+ */
+export interface ActivityListParams {
+    /** CEL expression to filter activities */
+    filter?: string;
+    /** Filter by field values (Kubernetes standard) */
+    fieldSelector?: string;
+    /** Filter by labels */
+    labelSelector?: string;
+    /** Full-text search on activity summaries */
+    search?: string;
+    /** Start of time range (RFC3339 or relative like "now-24h") */
+    start?: string;
+    /** End of time range (RFC3339 or relative, default: now) */
+    end?: string;
+    /** Maximum results (1-1000, default 100) */
+    limit?: number;
+    /** Pagination cursor */
+    continue?: string;
+    /** Watch for changes */
+    watch?: boolean;
+    /** Start Watch from this version */
+    resourceVersion?: string;
+}
+/**
+ * Facet specification for querying distinct values
+ */
+export interface FacetSpec {
+    /** Field path to get distinct values for */
+    field: string;
+    /** Maximum values to return (1-100, default 20) */
+    limit?: number;
+}
+/**
+ * Facet value with count
+ */
+export interface FacetValue {
+    value: string;
+    count: number;
+}
+/**
+ * Facet result containing distinct values for a field
+ */
+export interface FacetResult {
+    field: string;
+    values: FacetValue[];
+}
+/**
+ * Activity facet query request spec
+ */
+export interface ActivityFacetQuerySpec {
+    /** Time range for the facet query */
+    timeRange?: {
+        start?: string;
+        end?: string;
+    };
+    /** CEL expression to filter activities before computing facets */
+    filter?: string;
+    /** List of facets to query (1-10 facets) */
+    facets: FacetSpec[];
+}
+/**
+ * Activity facet query status with results
+ */
+export interface ActivityFacetQueryStatus {
+    facets: FacetResult[];
+}
+/**
+ * Activity facet query resource
+ */
+export interface ActivityFacetQuery {
+    apiVersion: 'activity.miloapis.com/v1alpha1';
+    kind: 'ActivityFacetQuery';
+    spec: ActivityFacetQuerySpec;
+    status?: ActivityFacetQueryStatus;
+}
+/**
+ * Audit log facet query request spec
+ * Used to query distinct values from audit logs (API groups, resources, etc.)
+ */
+export interface AuditLogFacetsQuerySpec {
+    /** Time range for the facet query */
+    timeRange?: {
+        start?: string;
+        end?: string;
+    };
+    /** CEL expression to filter audit logs before computing facets */
+    filter?: string;
+    /** List of facets to query (1-10 facets) */
+    facets: FacetSpec[];
+}
+/**
+ * Audit log facet query status with results
+ */
+export interface AuditLogFacetsQueryStatus {
+    facets: FacetResult[];
+}
+/**
+ * Audit log facet query resource
+ * Used to discover available API groups and resources from actual audit log data
+ */
+export interface AuditLogFacetsQuery {
+    apiVersion: 'activity.miloapis.com/v1alpha1';
+    kind: 'AuditLogFacetsQuery';
+    spec: AuditLogFacetsQuerySpec;
+    status?: AuditLogFacetsQueryStatus;
+}
+/**
+ * Activity filter fields for autocomplete and help
+ */
+export interface ActivityFilterField {
+    name: string;
+    type: 'string' | 'enum' | 'timestamp';
+    description: string;
+    enumValues?: string[];
+    examples?: string[];
+}
+/**
+ * Available filter fields for activities
+ */
+/**
+ * ActivityQuery spec for querying historical activities
+ */
+export interface ActivityQuerySpec {
+    /** Start of time range (required) */
+    startTime: string;
+    /** End of time range (required) */
+    endTime: string;
+    /** Full-text search on summaries */
+    search?: string;
+    /** CEL filter expression (primary filtering mechanism) */
+    filter?: string;
+    /** Max results per page (default 100, max 1000) */
+    limit?: number;
+    /** Pagination cursor */
+    continue?: string;
+}
+/**
+ * ActivityQuery status with results
+ */
+export interface ActivityQueryStatus {
+    /** Matching activities, newest first */
+    results?: Activity[];
+    /** Pagination cursor for next page */
+    continue?: string;
+    /** Resolved start time (RFC3339) */
+    effectiveStartTime?: string;
+    /** Resolved end time (RFC3339) */
+    effectiveEndTime?: string;
+}
+/**
+ * ActivityQuery resource for historical queries
+ */
+export interface ActivityQuery {
+    apiVersion: 'activity.miloapis.com/v1alpha1';
+    kind: 'ActivityQuery';
+    metadata?: {
+        name?: string;
+    };
+    spec: ActivityQuerySpec;
+    status?: ActivityQueryStatus;
+}
+/**
+ * Watch event types from Kubernetes watch API
+ */
+export type WatchEventType = 'ADDED' | 'MODIFIED' | 'DELETED' | 'BOOKMARK' | 'ERROR';
+/**
+ * Watch event from the Kubernetes watch API
+ */
+export interface WatchEvent<T = Activity> {
+    type: WatchEventType;
+    object: T;
+}
+/**
+ * Status error returned in watch ERROR events
+ */
+export interface WatchErrorStatus {
+    apiVersion: 'v1';
+    kind: 'Status';
+    status: 'Failure';
+    message: string;
+    reason?: string;
+    code: number;
+}
+/**
+ * Function that resolves a ResourceRef to a navigation URL
+ * Returns a URL string to navigate to when the resource link is clicked
+ */
+export type ResourceLinkResolver = (resource: ResourceRef, context?: ResourceLinkContext) => string | undefined;
+/**
+ * Default resource link resolver that navigates to resource history
+ * Uses UID if available, otherwise falls back to apiGroup, kind, namespace, name
+ */
+export declare function defaultResourceLinkResolver(resource: ResourceRef, context?: ResourceLinkContext): string;
+/**
+ * Function that resolves a Tenant to a navigation URL
+ * Returns a URL string to navigate to when the tenant link is clicked, or undefined to not render as a link
+ */
+export type TenantLinkResolver = (tenant: Tenant) => string | undefined;
+/**
+ * Custom renderer for tenant badges
+ * Allows full customization of how tenants are displayed in the activity feed
+ */
+export type TenantRenderer = (tenant: Tenant) => ReactNode;
+/**
+ * Effective time range after query resolution
+ * Contains the actual start and end times used by the query (ISO 8601 format)
+ */
+export interface EffectiveTimeRange {
+    /** Resolved start time in ISO 8601 format (e.g., "2026-02-19T10:00:00Z") */
+    startTime: string;
+    /** Resolved end time in ISO 8601 format (e.g., "2026-02-26T10:00:00Z") */
+    endTime: string;
+}
+/**
+ * Callback invoked when a query resolves its effective time range
+ * Used by parent components to display or sync the actual time range used
+ */
+export type EffectiveTimeRangeCallback = (timeRange: EffectiveTimeRange) => void;
+/**
+ * Formatted error for display to users
+ * Contains a user-friendly message and optional technical details
+ */
+export interface FormattedError {
+    /** User-friendly error message */
+    message: string;
+    /** Technical details for advanced users */
+    technical?: string;
+}
+/**
+ * Function that formats errors for display
+ * Allows clients to customize error messaging
+ */
+export type ErrorFormatter = (error: Error) => FormattedError;
+export declare const ACTIVITY_FILTER_FIELDS: ActivityFilterField[];
+//# sourceMappingURL=activity.d.ts.map

package/dist/types/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/types/activity.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * TypeScript types for the Activity API (activity.miloapis.com/v1alpha1)
+ * Based on Kubernetes audit events and custom query resources
+ */
+export interface ObjectReference {
+    resource?: string;
+    namespace?: string;
+    name?: string;
+    uid?: string;
+    apiGroup?: string;
+    apiVersion?: string;
+    resourceVersion?: string;
+    subresource?: string;
+}
+export interface UserInfo {
+    username?: string;
+    uid?: string;
+    groups?: string[];
+    extra?: Record<string, string[]>;
+}
+export interface Event {
+    level?: string;
+    auditID?: string;
+    stage?: string;
+    requestURI?: string;
+    verb?: string;
+    user?: UserInfo;
+    impersonatedUser?: UserInfo;
+    sourceIPs?: string[];
+    userAgent?: string;
+    objectRef?: ObjectReference;
+    responseStatus?: {
+        metadata?: Record<string, unknown>;
+        status?: string;
+        message?: string;
+        reason?: string;
+        code?: number;
+    };
+    requestObject?: unknown;
+    responseObject?: unknown;
+    requestReceivedTimestamp?: string;
+    stageTimestamp?: string;
+    annotations?: Record<string, string>;
+}
+export type QueryPhase = 'Pending' | 'Running' | 'Completed' | 'Failed';
+export interface AuditLogQuerySpec {
+    /**
+     * CEL expression for filtering audit events
+     * Available fields:
+     * - timestamp: time.Time
+     * - ns: string (namespace)
+     * - verb: string
+     * - resource: string
+     * - user: string
+     * - level: string
+     * - stage: string
+     * - uid: string
+     * - requestURI: string
+     * - sourceIPs: []string
+     */
+    filter?: string;
+    /**
+     * Maximum number of results (default: 100, max: 1000)
+     */
+    limit?: number;
+    /**
+     * Cursor for pagination (copy from previous query's status.continue)
+     */
+    continue?: string;
+    /**
+     * Start time for the query (ISO 8601 timestamp)
+     * Required by the API
+     */
+    startTime?: string;
+    /**
+     * End time for the query (ISO 8601 timestamp)
+     * Required by the API
+     */
+    endTime?: string;
+}
+export interface AuditLogQueryStatus {
+    phase?: QueryPhase;
+    results?: Event[];
+    /** Pagination cursor - copy to spec.continue to get the next page */
+    continue?: string;
+    message?: string;
+}
+export interface ObjectMeta {
+    name?: string;
+    namespace?: string;
+    uid?: string;
+    resourceVersion?: string;
+    creationTimestamp?: string;
+    labels?: Record<string, string>;
+    annotations?: Record<string, string>;
+}
+export interface AuditLogQuery {
+    apiVersion: 'activity.miloapis.com/v1alpha1';
+    kind: 'AuditLogQuery';
+    metadata?: ObjectMeta;
+    spec: AuditLogQuerySpec;
+    status?: AuditLogQueryStatus;
+}
+export interface AuditLog {
+    apiVersion: 'activity.miloapis.com/v1alpha1';
+    kind: 'AuditLog';
+    metadata?: ObjectMeta;
+    event: Event;
+}
+export interface FilterField {
+    name: string;
+    type: 'string' | 'timestamp' | 'array' | 'number';
+    description: string;
+    examples?: string[];
+}
+export declare const FILTER_FIELDS: FilterField[];
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}