@inneropen/marvin-sdk 1.10.6 → 1.11.0-next.2

package/dist/platform.cjs

@@ -29,6 +29,7 @@ __export(platform_exports, {
   CollectionsModule: () => CollectionsModule,
   EntriesModule: () => EntriesModule,
   EntryTypesModule: () => EntryTypesModule,
+  EventLogModule: () => EventLogModule,
   EventsModule: () => EventsModule,
   InvitesModule: () => InvitesModule,
   NotificationsModule: () => NotificationsModule,
@@ -995,6 +996,117 @@ var EventsModule = class {
   }
 };
 
+// src/platform/eventLog.ts
+var EventLogModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List events for the current workspace with optional filtering
+   *
+   * @param params - Query parameters for filtering events
+   * @returns List of event log summaries
+   *
+   * @example
+   * ```typescript
+   * // Get recent published entries
+   * const events = await marvin.platform.eventLog.list({
+   *   event_type: 'entry.published',
+   *   limit: 50
+   * });
+   *
+   * // Get events by user
+   * const userEvents = await marvin.platform.eventLog.list({
+   *   user_id: 'user-uuid',
+   *   start_date: '2026-07-01T00:00:00Z'
+   * });
+   * ```
+   */
+  async list(params) {
+    const queryParams = new URLSearchParams();
+    if (params?.event_type) queryParams.append("event_type", params.event_type);
+    if (params?.entity_type) queryParams.append("entity_type", params.entity_type);
+    if (params?.entity_id) queryParams.append("entity_id", params.entity_id);
+    if (params?.user_id) queryParams.append("user_id", params.user_id);
+    if (params?.start_date) queryParams.append("start_date", params.start_date);
+    if (params?.end_date) queryParams.append("end_date", params.end_date);
+    if (params?.limit) queryParams.append("limit", params.limit.toString());
+    if (params?.offset) queryParams.append("offset", params.offset.toString());
+    const query = queryParams.toString();
+    const url = query ? `/api/platform/events?${query}` : "/api/platform/events";
+    return this.http.get(url);
+  }
+  /**
+   * Get a single event by its event_id
+   *
+   * @param eventId - The event_id to retrieve
+   * @returns Complete event log entry with full payload
+   *
+   * @example
+   * ```typescript
+   * const event = await marvin.platform.eventLog.get('event-uuid');
+   * console.log(event.event_data); // Full JSONB payload
+   * ```
+   */
+  async get(eventId) {
+    return this.http.get(`/api/platform/events/${eventId}`);
+  }
+  /**
+   * Get complete event history for a specific entity (entry, asset, etc.)
+   *
+   * @param entityId - The UUID of the entity
+   * @param options - Optional entity type filter and pagination
+   * @returns List of events for this entity ordered by occurred_at descending
+   *
+   * @example
+   * ```typescript
+   * // Get complete timeline for an entry
+   * const entryHistory = await marvin.platform.eventLog.getEntityHistory('entry-uuid', {
+   *   entity_type: 'entry',
+   *   limit: 100
+   * });
+   * ```
+   */
+  async getEntityHistory(entityId, options) {
+    const queryParams = new URLSearchParams();
+    if (options?.entity_type) queryParams.append("entity_type", options.entity_type);
+    if (options?.limit) queryParams.append("limit", options.limit.toString());
+    if (options?.offset) queryParams.append("offset", options.offset.toString());
+    const query = queryParams.toString();
+    const url = query ? `/api/platform/events/entity/${entityId}?${query}` : `/api/platform/events/entity/${entityId}`;
+    return this.http.get(url);
+  }
+  /**
+   * Get activity history for a specific user in the current workspace
+   *
+   * @param userId - The UUID of the user
+   * @param options - Optional filters and pagination
+   * @returns List of events triggered by this user ordered by occurred_at descending
+   *
+   * @example
+   * ```typescript
+   * // Get user activity for the last week
+   * const userActivity = await marvin.platform.eventLog.getUserActivity('user-uuid', {
+   *   start_date: '2026-07-01T00:00:00Z',
+   *   event_type: 'entry.published',
+   *   limit: 50
+   * });
+   * ```
+   */
+  async getUserActivity(userId, options) {
+    const queryParams = new URLSearchParams();
+    if (options?.event_type) queryParams.append("event_type", options.event_type);
+    if (options?.start_date) queryParams.append("start_date", options.start_date);
+    if (options?.end_date) queryParams.append("end_date", options.end_date);
+    if (options?.limit) queryParams.append("limit", options.limit.toString());
+    if (options?.offset) queryParams.append("offset", options.offset.toString());
+    const query = queryParams.toString();
+    const url = query ? `/api/platform/events/user/${userId}?${query}` : `/api/platform/events/user/${userId}`;
+    return this.http.get(url);
+  }
+};
+
 // src/platform/auth.ts
 var AuthModule = class {
   constructor(http) {
@@ -1048,6 +1160,7 @@ var PlatformClient = class extends HttpClient {
   webhooks;
   user;
   events;
+  eventLog;
   session;
   theme;
   // Admin modules
@@ -1074,6 +1187,7 @@ var PlatformClient = class extends HttpClient {
     this.webhooks = new WebhooksModule(this);
     this.user = new UserModule(this);
     this.events = new EventsModule(this);
+    this.eventLog = new EventLogModule(this);
     this.session = new AuthModule(this);
     this.theme = new ThemeModule(this);
     this.adminUsers = new AdminUsersModule(this);
@@ -1095,6 +1209,7 @@ function createPlatformClient(config) {
   CollectionsModule,
   EntriesModule,
   EntryTypesModule,
+  EventLogModule,
   EventsModule,
   InvitesModule,
   NotificationsModule,

package/dist/platform.d.cts

@@ -859,7 +859,95 @@ interface components {
          *     Helps listeners understand the nature of `EventDocumentDataBase` content.
          * @enum {string}
          */
-        EventDocumentType: "generic" | "user" | "workspace" | "entry" | "collection" | "asset" | "webhook" | "member" | "invitation" | "api_token" | "deployment";
+        EventDocumentType: "generic" | "user" | "workspace" | "entry" | "collection" | "asset" | "webhook" | "member" | "invitation" | "api_token" | "api_client" | "entry_type" | "resource" | "deployment";
+        /**
+         * EventLogRead
+         * @description Schema for reading an event log entry.
+         */
+        EventLogRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Eventid
+             * Format: uuid4
+             */
+            eventId: string;
+            /** Eventtype */
+            eventType: string;
+            /**
+             * Occurredat
+             * Format: date-time
+             */
+            occurredAt: string;
+            /**
+             * Workspaceid
+             * Format: uuid4
+             */
+            workspaceId: string;
+            /** Userid */
+            userId?: string | null;
+            /** Entityid */
+            entityId?: string | null;
+            /** Entitytype */
+            entityType?: string | null;
+            /** Integrationid */
+            integrationId: string;
+            /** Operation */
+            operation?: string | null;
+            /** Eventdata */
+            eventData: {
+                [key: string]: unknown;
+            };
+            /** Messagetitle */
+            messageTitle: string;
+            /** Messagebody */
+            messageBody?: string | null;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+        };
+        /**
+         * EventLogSummary
+         * @description Summary schema for an event log entry (lighter payload).
+         */
+        EventLogSummary: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Eventid
+             * Format: uuid4
+             */
+            eventId: string;
+            /** Eventtype */
+            eventType: string;
+            /**
+             * Occurredat
+             * Format: date-time
+             */
+            occurredAt: string;
+            /**
+             * Workspaceid
+             * Format: uuid4
+             */
+            workspaceId: string;
+            /** Userid */
+            userId?: string | null;
+            /** Entityid */
+            entityId?: string | null;
+            /** Entitytype */
+            entityType?: string | null;
+            /** Messagetitle */
+            messageTitle: string;
+            /** Messagebody */
+            messageBody?: string | null;
+        };
         /**
          * EventNotifierOptionsPagination
          * @description Schema for paginated responses containing a list of event notifier option summaries.
@@ -2571,6 +2659,11 @@ type PlatformAPIClientWithToken = components['schemas']['APIClientWithToken'];
 type PlatformWorkspaceMember = components['schemas']['WorkspaceMembershipRead'];
 type PlatformWorkspaceMemberCreate = components['schemas']['WorkspaceMemberCreate'];
 type PlatformWorkspaceMemberUpdate = components['schemas']['WorkspaceMemberUpdate'];
+/**
+ * Event Log (Platform API - audit trail and event history)
+ */
+type EventLogEntry = components['schemas']['EventLogRead'];
+type EventLogSummary = components['schemas']['EventLogSummary'];
 
 /**
  * Entries Module - Platform API
@@ -3326,6 +3419,107 @@ declare class EventsModule {
     getOptions(): Promise<EventOption[]>;
 }
 
+/**
+ * Event Log Module - Platform API
+ *
+ * Query audit trail and event history
+ */
+
+interface EventLogQueryParams {
+    event_type?: string;
+    entity_type?: string;
+    entity_id?: string;
+    user_id?: string;
+    start_date?: string;
+    end_date?: string;
+    limit?: number;
+    offset?: number;
+}
+declare class EventLogModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List events for the current workspace with optional filtering
+     *
+     * @param params - Query parameters for filtering events
+     * @returns List of event log summaries
+     *
+     * @example
+     * ```typescript
+     * // Get recent published entries
+     * const events = await marvin.platform.eventLog.list({
+     *   event_type: 'entry.published',
+     *   limit: 50
+     * });
+     *
+     * // Get events by user
+     * const userEvents = await marvin.platform.eventLog.list({
+     *   user_id: 'user-uuid',
+     *   start_date: '2026-07-01T00:00:00Z'
+     * });
+     * ```
+     */
+    list(params?: EventLogQueryParams): Promise<EventLogSummary[]>;
+    /**
+     * Get a single event by its event_id
+     *
+     * @param eventId - The event_id to retrieve
+     * @returns Complete event log entry with full payload
+     *
+     * @example
+     * ```typescript
+     * const event = await marvin.platform.eventLog.get('event-uuid');
+     * console.log(event.event_data); // Full JSONB payload
+     * ```
+     */
+    get(eventId: string): Promise<EventLogEntry>;
+    /**
+     * Get complete event history for a specific entity (entry, asset, etc.)
+     *
+     * @param entityId - The UUID of the entity
+     * @param options - Optional entity type filter and pagination
+     * @returns List of events for this entity ordered by occurred_at descending
+     *
+     * @example
+     * ```typescript
+     * // Get complete timeline for an entry
+     * const entryHistory = await marvin.platform.eventLog.getEntityHistory('entry-uuid', {
+     *   entity_type: 'entry',
+     *   limit: 100
+     * });
+     * ```
+     */
+    getEntityHistory(entityId: string, options?: {
+        entity_type?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<EventLogSummary[]>;
+    /**
+     * Get activity history for a specific user in the current workspace
+     *
+     * @param userId - The UUID of the user
+     * @param options - Optional filters and pagination
+     * @returns List of events triggered by this user ordered by occurred_at descending
+     *
+     * @example
+     * ```typescript
+     * // Get user activity for the last week
+     * const userActivity = await marvin.platform.eventLog.getUserActivity('user-uuid', {
+     *   start_date: '2026-07-01T00:00:00Z',
+     *   event_type: 'entry.published',
+     *   limit: 50
+     * });
+     * ```
+     */
+    getUserActivity(userId: string, options?: {
+        event_type?: string;
+        start_date?: string;
+        end_date?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<EventLogSummary[]>;
+}
+
 /**
  * Auth Module - Platform API
  *
@@ -3417,6 +3611,7 @@ declare class PlatformClient extends HttpClient {
     webhooks: WebhooksModule;
     user: UserModule;
     events: EventsModule;
+    eventLog: EventLogModule;
     session: AuthModule;
     theme: ThemeModule;
     adminUsers: AdminUsersModule;
@@ -3429,4 +3624,4 @@ declare class PlatformClient extends HttpClient {
  */
 declare function createPlatformClient(config: PlatformClientConfig): PlatformClient;
 
-export { APIClientsModule, type AdminAboutInfo, AdminMaintenanceModule, AdminSystemModule, AdminUsersModule, type ApiToken, type ApiTokenCreate, type ApiTokenWithToken, type AppTheme, AssetsModule, AuthModule, type AuthToken, CollectionsModule, type EmailInvitationRequest, type EmailSettings, EntriesModule, EntryTypesModule, type EventOption, EventsModule, type InviteTokenCreate, type InviteTokenPagination, type InviteTokenSummary, InvitesModule, type MaintenanceStorageDetails, type MaintenanceSummary, type Notification, type NotificationCreate, type NotificationUpdate, NotificationsModule, type PasswordChange, type PasswordResetTokenRequest, type PasswordResetTokenResponse, type PlatformAPIClient, type PlatformAPIClientCreate, type PlatformAPIClientUpdate, type PlatformAPIClientWithToken, type PlatformAsset, type PlatformAssetUpdate, PlatformClient, type PlatformClientConfig, type PlatformCollection, type PlatformCollectionCreate, type PlatformCollectionUpdate, type PlatformEntry, type PlatformEntryCreate, type PlatformEntryType, type PlatformEntryUpdate, type PlatformResource, type PlatformResourceCreate, type PlatformResourceUpdate, type PlatformWorkspaceMember, type PlatformWorkspaceMemberCreate, type PlatformWorkspaceMemberUpdate, ResourcesModule, type SystemStatistics, ThemeModule, type UnlockUserRequest, type User, type UserCreate, UserModule, type UserPagination, type UserProfile, type UserProfileUpdate, type UserSummary, type UserUpdate, type Webhook, type WebhookCreate, type WebhookMethod, type WebhookPagination, type WebhookUpdate, WebhooksModule, type Workspace, type WorkspaceActivationRequest, type WorkspaceCreate, WorkspaceMembersModule, type WorkspacePreferences, type WorkspacePreferencesUpdate, type WorkspaceUpdate, type WorkspaceWithMembership, WorkspacesModule, createPlatformClient };
+export { APIClientsModule, type AdminAboutInfo, AdminMaintenanceModule, AdminSystemModule, AdminUsersModule, type ApiToken, type ApiTokenCreate, type ApiTokenWithToken, type AppTheme, AssetsModule, AuthModule, type AuthToken, CollectionsModule, type EmailInvitationRequest, type EmailSettings, EntriesModule, EntryTypesModule, type EventLogEntry, EventLogModule, type EventLogQueryParams, type EventLogSummary, type EventOption, EventsModule, type InviteTokenCreate, type InviteTokenPagination, type InviteTokenSummary, InvitesModule, type MaintenanceStorageDetails, type MaintenanceSummary, type Notification, type NotificationCreate, type NotificationUpdate, NotificationsModule, type PasswordChange, type PasswordResetTokenRequest, type PasswordResetTokenResponse, type PlatformAPIClient, type PlatformAPIClientCreate, type PlatformAPIClientUpdate, type PlatformAPIClientWithToken, type PlatformAsset, type PlatformAssetUpdate, PlatformClient, type PlatformClientConfig, type PlatformCollection, type PlatformCollectionCreate, type PlatformCollectionUpdate, type PlatformEntry, type PlatformEntryCreate, type PlatformEntryType, type PlatformEntryUpdate, type PlatformResource, type PlatformResourceCreate, type PlatformResourceUpdate, type PlatformWorkspaceMember, type PlatformWorkspaceMemberCreate, type PlatformWorkspaceMemberUpdate, ResourcesModule, type SystemStatistics, ThemeModule, type UnlockUserRequest, type User, type UserCreate, UserModule, type UserPagination, type UserProfile, type UserProfileUpdate, type UserSummary, type UserUpdate, type Webhook, type WebhookCreate, type WebhookMethod, type WebhookPagination, type WebhookUpdate, WebhooksModule, type Workspace, type WorkspaceActivationRequest, type WorkspaceCreate, WorkspaceMembersModule, type WorkspacePreferences, type WorkspacePreferencesUpdate, type WorkspaceUpdate, type WorkspaceWithMembership, WorkspacesModule, createPlatformClient };

package/dist/platform.d.ts

@@ -859,7 +859,95 @@ interface components {
          *     Helps listeners understand the nature of `EventDocumentDataBase` content.
          * @enum {string}
          */
-        EventDocumentType: "generic" | "user" | "workspace" | "entry" | "collection" | "asset" | "webhook" | "member" | "invitation" | "api_token" | "deployment";
+        EventDocumentType: "generic" | "user" | "workspace" | "entry" | "collection" | "asset" | "webhook" | "member" | "invitation" | "api_token" | "api_client" | "entry_type" | "resource" | "deployment";
+        /**
+         * EventLogRead
+         * @description Schema for reading an event log entry.
+         */
+        EventLogRead: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Eventid
+             * Format: uuid4
+             */
+            eventId: string;
+            /** Eventtype */
+            eventType: string;
+            /**
+             * Occurredat
+             * Format: date-time
+             */
+            occurredAt: string;
+            /**
+             * Workspaceid
+             * Format: uuid4
+             */
+            workspaceId: string;
+            /** Userid */
+            userId?: string | null;
+            /** Entityid */
+            entityId?: string | null;
+            /** Entitytype */
+            entityType?: string | null;
+            /** Integrationid */
+            integrationId: string;
+            /** Operation */
+            operation?: string | null;
+            /** Eventdata */
+            eventData: {
+                [key: string]: unknown;
+            };
+            /** Messagetitle */
+            messageTitle: string;
+            /** Messagebody */
+            messageBody?: string | null;
+            /** Createdat */
+            createdAt?: string | null;
+            /** Updateat */
+            updateAt?: string | null;
+        };
+        /**
+         * EventLogSummary
+         * @description Summary schema for an event log entry (lighter payload).
+         */
+        EventLogSummary: {
+            /**
+             * Id
+             * Format: uuid4
+             */
+            id: string;
+            /**
+             * Eventid
+             * Format: uuid4
+             */
+            eventId: string;
+            /** Eventtype */
+            eventType: string;
+            /**
+             * Occurredat
+             * Format: date-time
+             */
+            occurredAt: string;
+            /**
+             * Workspaceid
+             * Format: uuid4
+             */
+            workspaceId: string;
+            /** Userid */
+            userId?: string | null;
+            /** Entityid */
+            entityId?: string | null;
+            /** Entitytype */
+            entityType?: string | null;
+            /** Messagetitle */
+            messageTitle: string;
+            /** Messagebody */
+            messageBody?: string | null;
+        };
         /**
          * EventNotifierOptionsPagination
          * @description Schema for paginated responses containing a list of event notifier option summaries.
@@ -2571,6 +2659,11 @@ type PlatformAPIClientWithToken = components['schemas']['APIClientWithToken'];
 type PlatformWorkspaceMember = components['schemas']['WorkspaceMembershipRead'];
 type PlatformWorkspaceMemberCreate = components['schemas']['WorkspaceMemberCreate'];
 type PlatformWorkspaceMemberUpdate = components['schemas']['WorkspaceMemberUpdate'];
+/**
+ * Event Log (Platform API - audit trail and event history)
+ */
+type EventLogEntry = components['schemas']['EventLogRead'];
+type EventLogSummary = components['schemas']['EventLogSummary'];
 
 /**
  * Entries Module - Platform API
@@ -3326,6 +3419,107 @@ declare class EventsModule {
     getOptions(): Promise<EventOption[]>;
 }
 
+/**
+ * Event Log Module - Platform API
+ *
+ * Query audit trail and event history
+ */
+
+interface EventLogQueryParams {
+    event_type?: string;
+    entity_type?: string;
+    entity_id?: string;
+    user_id?: string;
+    start_date?: string;
+    end_date?: string;
+    limit?: number;
+    offset?: number;
+}
+declare class EventLogModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * List events for the current workspace with optional filtering
+     *
+     * @param params - Query parameters for filtering events
+     * @returns List of event log summaries
+     *
+     * @example
+     * ```typescript
+     * // Get recent published entries
+     * const events = await marvin.platform.eventLog.list({
+     *   event_type: 'entry.published',
+     *   limit: 50
+     * });
+     *
+     * // Get events by user
+     * const userEvents = await marvin.platform.eventLog.list({
+     *   user_id: 'user-uuid',
+     *   start_date: '2026-07-01T00:00:00Z'
+     * });
+     * ```
+     */
+    list(params?: EventLogQueryParams): Promise<EventLogSummary[]>;
+    /**
+     * Get a single event by its event_id
+     *
+     * @param eventId - The event_id to retrieve
+     * @returns Complete event log entry with full payload
+     *
+     * @example
+     * ```typescript
+     * const event = await marvin.platform.eventLog.get('event-uuid');
+     * console.log(event.event_data); // Full JSONB payload
+     * ```
+     */
+    get(eventId: string): Promise<EventLogEntry>;
+    /**
+     * Get complete event history for a specific entity (entry, asset, etc.)
+     *
+     * @param entityId - The UUID of the entity
+     * @param options - Optional entity type filter and pagination
+     * @returns List of events for this entity ordered by occurred_at descending
+     *
+     * @example
+     * ```typescript
+     * // Get complete timeline for an entry
+     * const entryHistory = await marvin.platform.eventLog.getEntityHistory('entry-uuid', {
+     *   entity_type: 'entry',
+     *   limit: 100
+     * });
+     * ```
+     */
+    getEntityHistory(entityId: string, options?: {
+        entity_type?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<EventLogSummary[]>;
+    /**
+     * Get activity history for a specific user in the current workspace
+     *
+     * @param userId - The UUID of the user
+     * @param options - Optional filters and pagination
+     * @returns List of events triggered by this user ordered by occurred_at descending
+     *
+     * @example
+     * ```typescript
+     * // Get user activity for the last week
+     * const userActivity = await marvin.platform.eventLog.getUserActivity('user-uuid', {
+     *   start_date: '2026-07-01T00:00:00Z',
+     *   event_type: 'entry.published',
+     *   limit: 50
+     * });
+     * ```
+     */
+    getUserActivity(userId: string, options?: {
+        event_type?: string;
+        start_date?: string;
+        end_date?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<EventLogSummary[]>;
+}
+
 /**
  * Auth Module - Platform API
  *
@@ -3417,6 +3611,7 @@ declare class PlatformClient extends HttpClient {
     webhooks: WebhooksModule;
     user: UserModule;
     events: EventsModule;
+    eventLog: EventLogModule;
     session: AuthModule;
     theme: ThemeModule;
     adminUsers: AdminUsersModule;
@@ -3429,4 +3624,4 @@ declare class PlatformClient extends HttpClient {
  */
 declare function createPlatformClient(config: PlatformClientConfig): PlatformClient;
 
-export { APIClientsModule, type AdminAboutInfo, AdminMaintenanceModule, AdminSystemModule, AdminUsersModule, type ApiToken, type ApiTokenCreate, type ApiTokenWithToken, type AppTheme, AssetsModule, AuthModule, type AuthToken, CollectionsModule, type EmailInvitationRequest, type EmailSettings, EntriesModule, EntryTypesModule, type EventOption, EventsModule, type InviteTokenCreate, type InviteTokenPagination, type InviteTokenSummary, InvitesModule, type MaintenanceStorageDetails, type MaintenanceSummary, type Notification, type NotificationCreate, type NotificationUpdate, NotificationsModule, type PasswordChange, type PasswordResetTokenRequest, type PasswordResetTokenResponse, type PlatformAPIClient, type PlatformAPIClientCreate, type PlatformAPIClientUpdate, type PlatformAPIClientWithToken, type PlatformAsset, type PlatformAssetUpdate, PlatformClient, type PlatformClientConfig, type PlatformCollection, type PlatformCollectionCreate, type PlatformCollectionUpdate, type PlatformEntry, type PlatformEntryCreate, type PlatformEntryType, type PlatformEntryUpdate, type PlatformResource, type PlatformResourceCreate, type PlatformResourceUpdate, type PlatformWorkspaceMember, type PlatformWorkspaceMemberCreate, type PlatformWorkspaceMemberUpdate, ResourcesModule, type SystemStatistics, ThemeModule, type UnlockUserRequest, type User, type UserCreate, UserModule, type UserPagination, type UserProfile, type UserProfileUpdate, type UserSummary, type UserUpdate, type Webhook, type WebhookCreate, type WebhookMethod, type WebhookPagination, type WebhookUpdate, WebhooksModule, type Workspace, type WorkspaceActivationRequest, type WorkspaceCreate, WorkspaceMembersModule, type WorkspacePreferences, type WorkspacePreferencesUpdate, type WorkspaceUpdate, type WorkspaceWithMembership, WorkspacesModule, createPlatformClient };
+export { APIClientsModule, type AdminAboutInfo, AdminMaintenanceModule, AdminSystemModule, AdminUsersModule, type ApiToken, type ApiTokenCreate, type ApiTokenWithToken, type AppTheme, AssetsModule, AuthModule, type AuthToken, CollectionsModule, type EmailInvitationRequest, type EmailSettings, EntriesModule, EntryTypesModule, type EventLogEntry, EventLogModule, type EventLogQueryParams, type EventLogSummary, type EventOption, EventsModule, type InviteTokenCreate, type InviteTokenPagination, type InviteTokenSummary, InvitesModule, type MaintenanceStorageDetails, type MaintenanceSummary, type Notification, type NotificationCreate, type NotificationUpdate, NotificationsModule, type PasswordChange, type PasswordResetTokenRequest, type PasswordResetTokenResponse, type PlatformAPIClient, type PlatformAPIClientCreate, type PlatformAPIClientUpdate, type PlatformAPIClientWithToken, type PlatformAsset, type PlatformAssetUpdate, PlatformClient, type PlatformClientConfig, type PlatformCollection, type PlatformCollectionCreate, type PlatformCollectionUpdate, type PlatformEntry, type PlatformEntryCreate, type PlatformEntryType, type PlatformEntryUpdate, type PlatformResource, type PlatformResourceCreate, type PlatformResourceUpdate, type PlatformWorkspaceMember, type PlatformWorkspaceMemberCreate, type PlatformWorkspaceMemberUpdate, ResourcesModule, type SystemStatistics, ThemeModule, type UnlockUserRequest, type User, type UserCreate, UserModule, type UserPagination, type UserProfile, type UserProfileUpdate, type UserSummary, type UserUpdate, type Webhook, type WebhookCreate, type WebhookMethod, type WebhookPagination, type WebhookUpdate, WebhooksModule, type Workspace, type WorkspaceActivationRequest, type WorkspaceCreate, WorkspaceMembersModule, type WorkspacePreferences, type WorkspacePreferencesUpdate, type WorkspaceUpdate, type WorkspaceWithMembership, WorkspacesModule, createPlatformClient };

package/dist/platform.js

@@ -775,6 +775,117 @@ var EventsModule = class {
   }
 };
 
+// src/platform/eventLog.ts
+var EventLogModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * List events for the current workspace with optional filtering
+   *
+   * @param params - Query parameters for filtering events
+   * @returns List of event log summaries
+   *
+   * @example
+   * ```typescript
+   * // Get recent published entries
+   * const events = await marvin.platform.eventLog.list({
+   *   event_type: 'entry.published',
+   *   limit: 50
+   * });
+   *
+   * // Get events by user
+   * const userEvents = await marvin.platform.eventLog.list({
+   *   user_id: 'user-uuid',
+   *   start_date: '2026-07-01T00:00:00Z'
+   * });
+   * ```
+   */
+  async list(params) {
+    const queryParams = new URLSearchParams();
+    if (params?.event_type) queryParams.append("event_type", params.event_type);
+    if (params?.entity_type) queryParams.append("entity_type", params.entity_type);
+    if (params?.entity_id) queryParams.append("entity_id", params.entity_id);
+    if (params?.user_id) queryParams.append("user_id", params.user_id);
+    if (params?.start_date) queryParams.append("start_date", params.start_date);
+    if (params?.end_date) queryParams.append("end_date", params.end_date);
+    if (params?.limit) queryParams.append("limit", params.limit.toString());
+    if (params?.offset) queryParams.append("offset", params.offset.toString());
+    const query = queryParams.toString();
+    const url = query ? `/api/platform/events?${query}` : "/api/platform/events";
+    return this.http.get(url);
+  }
+  /**
+   * Get a single event by its event_id
+   *
+   * @param eventId - The event_id to retrieve
+   * @returns Complete event log entry with full payload
+   *
+   * @example
+   * ```typescript
+   * const event = await marvin.platform.eventLog.get('event-uuid');
+   * console.log(event.event_data); // Full JSONB payload
+   * ```
+   */
+  async get(eventId) {
+    return this.http.get(`/api/platform/events/${eventId}`);
+  }
+  /**
+   * Get complete event history for a specific entity (entry, asset, etc.)
+   *
+   * @param entityId - The UUID of the entity
+   * @param options - Optional entity type filter and pagination
+   * @returns List of events for this entity ordered by occurred_at descending
+   *
+   * @example
+   * ```typescript
+   * // Get complete timeline for an entry
+   * const entryHistory = await marvin.platform.eventLog.getEntityHistory('entry-uuid', {
+   *   entity_type: 'entry',
+   *   limit: 100
+   * });
+   * ```
+   */
+  async getEntityHistory(entityId, options) {
+    const queryParams = new URLSearchParams();
+    if (options?.entity_type) queryParams.append("entity_type", options.entity_type);
+    if (options?.limit) queryParams.append("limit", options.limit.toString());
+    if (options?.offset) queryParams.append("offset", options.offset.toString());
+    const query = queryParams.toString();
+    const url = query ? `/api/platform/events/entity/${entityId}?${query}` : `/api/platform/events/entity/${entityId}`;
+    return this.http.get(url);
+  }
+  /**
+   * Get activity history for a specific user in the current workspace
+   *
+   * @param userId - The UUID of the user
+   * @param options - Optional filters and pagination
+   * @returns List of events triggered by this user ordered by occurred_at descending
+   *
+   * @example
+   * ```typescript
+   * // Get user activity for the last week
+   * const userActivity = await marvin.platform.eventLog.getUserActivity('user-uuid', {
+   *   start_date: '2026-07-01T00:00:00Z',
+   *   event_type: 'entry.published',
+   *   limit: 50
+   * });
+   * ```
+   */
+  async getUserActivity(userId, options) {
+    const queryParams = new URLSearchParams();
+    if (options?.event_type) queryParams.append("event_type", options.event_type);
+    if (options?.start_date) queryParams.append("start_date", options.start_date);
+    if (options?.end_date) queryParams.append("end_date", options.end_date);
+    if (options?.limit) queryParams.append("limit", options.limit.toString());
+    if (options?.offset) queryParams.append("offset", options.offset.toString());
+    const query = queryParams.toString();
+    const url = query ? `/api/platform/events/user/${userId}?${query}` : `/api/platform/events/user/${userId}`;
+    return this.http.get(url);
+  }
+};
+
 // src/platform/auth.ts
 var AuthModule = class {
   constructor(http) {
@@ -828,6 +939,7 @@ var PlatformClient = class extends HttpClient {
   webhooks;
   user;
   events;
+  eventLog;
   session;
   theme;
   // Admin modules
@@ -854,6 +966,7 @@ var PlatformClient = class extends HttpClient {
     this.webhooks = new WebhooksModule(this);
     this.user = new UserModule(this);
     this.events = new EventsModule(this);
+    this.eventLog = new EventLogModule(this);
     this.session = new AuthModule(this);
     this.theme = new ThemeModule(this);
     this.adminUsers = new AdminUsersModule(this);
@@ -874,6 +987,7 @@ export {
   CollectionsModule,
   EntriesModule,
   EntryTypesModule,
+  EventLogModule,
   EventsModule,
   InvitesModule,
   NotificationsModule,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneropen/marvin-sdk",
-  "version": "1.10.6",
+  "version": "1.11.0-next.2",
   "description": "Official TypeScript SDK for Marvin CMS",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -74,8 +74,12 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
     "@types/node": "^26.1.0",
     "openapi-typescript": "^7.13.0",
+    "semantic-release": "^25.0.5",
     "tsup": "^8.5.1"
   }
 }