@vibexp/api-client 0.80.0 → 0.81.0

package/dist/schema.d.ts

@@ -2806,6 +2806,123 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/admin/users/{id}/insights": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's resource counts
+         * @description Returns how many resources of each of the nine counted types (prompts,
+         *     memories, artifacts, blueprints, agents, feeds, feed items, comments,
+         *     attachments) the user authored: instance-wide totals, per team, and per
+         *     project for the four project-scoped types. Counts only — no titles, slugs or
+         *     content.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserInsights"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/users/{id}/resource-creation-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's resource creation series
+         * @description Returns how many resources of each type the user created per bucket over a
+         *     time range. Omitting the parameters yields the last 30 days at `day`
+         *     granularity, and the range rules match getAdminDashboardTimeseries. Every
+         *     bucket is present with an explicit 0 for every type.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserResourceCreationMetrics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/users/{id}/timeline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's resource timeline
+         * @description Returns an opaque, newest-first timeline of the resources the user created
+         *     or updated: resource type, action, team, project and the first 8 characters
+         *     of the resource id — never a title, slug or content. Cursor-paginated: pass
+         *     the previous page's `next_cursor` to continue.
+         *
+         *     `updated` events are APPROXIMATE, by construction of the data:
+         *
+         *     - Only the latest `updated_at` is stored, so a resource edited many times
+         *       appears as ONE `updated` event, at its latest edit.
+         *     - There is no `updated_by` column. The event means "a resource authored by
+         *       this user was last modified", not "this user edited it" — a teammate's
+         *       edit, or a system write that bumps `updated_at` (for example a blueprint
+         *       GitHub re-sync or a team-wide artifact type rename), shows up here too.
+         *     - An update is only reported when `updated_at` is more than one second after
+         *       `created_at`, so a never-edited resource produces no `updated` event.
+         *     - Agents, feed items and attachments only ever produce `created` events.
+         *
+         *     Deleted resources leave no trace (resources are hard-deleted).
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserTimeline"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/users/{id}/notification-preferences": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's notification preferences
+         * @description Returns the user's notification preferences, read-only. A user who has never
+         *     saved preferences gets the defaults with `is_default: true`.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserNotificationPreferences"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/{team_id}/comments": {
         parameters: {
             query?: never;
@@ -10950,6 +11067,147 @@ export interface components {
             /** Format: date-time */
             updated_at: string;
         };
+        /**
+         * @description How many PROJECT-SCOPED resources the user authored in one project. Only the
+         *     four types with a NOT NULL project_id are attributed to a project; every
+         *     other type is counted at the team level only.
+         */
+        AdminUserProjectResourceCounts: {
+            /** Format: uuid */
+            project_id: string;
+            /** @example Platform */
+            project_name: string;
+            counts: components["schemas"]["AdminProjectResourceCounts"];
+        };
+        /** @description How many resources the user authored in one team, with the per-project breakdown. */
+        AdminUserTeamResourceCounts: {
+            /** Format: uuid */
+            team_id: string;
+            /** @example Acme */
+            team_name: string;
+            /**
+             * @description Whether the user is still a member of the team. A former member's
+             *     authored resources stay in the team and are still counted here.
+             */
+            is_member: boolean;
+            counts: components["schemas"]["AdminResourceCounts"];
+            /** @description Per-project counts, ordered by project name. */
+            projects: components["schemas"]["AdminUserProjectResourceCounts"][];
+        };
+        /**
+         * @description Per-type counts of the resources one user authored, instance-wide, per team
+         *     and per project (GET /api/v1/admin/users/{id}/insights). For every type the
+         *     per-team counts sum to `totals`. An attachment whose author was deleted
+         *     (user_id set to NULL) counts for nobody.
+         */
+        AdminUserInsights: {
+            /** Format: uuid */
+            user_id: string;
+            totals: components["schemas"]["AdminResourceCounts"];
+            /** @description Teams the user authored at least one resource in, ordered by team name. */
+            teams: components["schemas"]["AdminUserTeamResourceCounts"][];
+        };
+        /** @description How many resources of each type the user created within one time bucket. */
+        AdminUserCreationPoint: {
+            /**
+             * Format: date-time
+             * @description Start of the bucket, in UTC.
+             */
+            bucket: string;
+            /** Format: int64 */
+            prompts: number;
+            /** Format: int64 */
+            memories: number;
+            /** Format: int64 */
+            artifacts: number;
+            /** Format: int64 */
+            blueprints: number;
+            /** Format: int64 */
+            agents: number;
+            /** Format: int64 */
+            feeds: number;
+            /** Format: int64 */
+            feed_items: number;
+            /** Format: int64 */
+            comments: number;
+            /** Format: int64 */
+            attachments: number;
+        };
+        /**
+         * @description Resources the user created per bucket, stacked by type
+         *     (GET /api/v1/admin/users/{id}/resource-creation-metrics). Every bucket in
+         *     the range is present with an explicit 0 for every type.
+         */
+        AdminUserResourceCreationMetrics: {
+            /**
+             * Format: date-time
+             * @description Inclusive start of the range actually used, snapped DOWN to the start of
+             *     its bucket (same rule as AdminTimeseriesResponse.from).
+             */
+            from: string;
+            /**
+             * Format: date-time
+             * @description Exclusive end of the range actually used (after defaulting); not snapped.
+             */
+            to: string;
+            /**
+             * @description Bucket size actually used.
+             * @enum {string}
+             */
+            granularity: "day" | "week" | "month";
+            /** @description One point per bucket, ascending by bucket. */
+            series: components["schemas"]["AdminUserCreationPoint"][];
+        };
+        /**
+         * @description One opaque timeline entry: which kind of resource the user created or last
+         *     updated, where, and when. Deliberately carries no title, slug or content —
+         *     only the first 8 characters of the resource id.
+         */
+        AdminUserTimelineEvent: {
+            /** @enum {string} */
+            resource_type: "prompt" | "memory" | "artifact" | "blueprint" | "agent" | "feed" | "feed_item" | "comment" | "attachment";
+            /** @enum {string} */
+            action: "created" | "updated";
+            /** Format: uuid */
+            team_id: string;
+            team_name: string;
+            /**
+             * Format: uuid
+             * @description Null for team-scoped resources and for feed items posted without a project.
+             */
+            project_id: string | null;
+            project_name: string | null;
+            /**
+             * @description First 8 characters of the resource id.
+             * @example 3f2a9c1e
+             */
+            resource_short_id: string;
+            /** Format: date-time */
+            occurred_at: string;
+        };
+        /** @description One page of a user's resource timeline, newest first. */
+        AdminUserTimelinePage: {
+            items: components["schemas"]["AdminUserTimelineEvent"][];
+            /** @description Opaque cursor for the next page; null on the last page. */
+            next_cursor: string | null;
+        };
+        /**
+         * @description A user's notification preferences, read-only
+         *     (GET /api/v1/admin/users/{id}/notification-preferences). When the user has
+         *     never saved preferences, the defaults are returned with `is_default: true`
+         *     and `updated_at: null`.
+         */
+        AdminUserNotificationPreferences: {
+            email_notification: components["schemas"]["EmailNotificationPreferences"];
+            notifications: components["schemas"]["NotificationPreferences"];
+            /**
+             * Format: date-time
+             * @description When the user last saved their preferences; null when defaults are returned.
+             */
+            updated_at: string | null;
+            /** @description True when the user has no stored preferences and the defaults are shown. */
+            is_default: boolean;
+        };
         ProjectResponse: components["schemas"]["Project"] & {
             /**
              * @description Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -11089,6 +11347,35 @@ export interface components {
              */
             data: string[];
         };
+        EmailNotificationPreferences: {
+            /**
+             * @description Receive platform announcement emails
+             * @example true
+             */
+            platform_announcement: boolean;
+            /**
+             * @description Receive account security emails
+             * @example true
+             */
+            account_security: boolean;
+            /**
+             * @description Receive new feature emails
+             * @example true
+             */
+            new_feature: boolean;
+            /**
+             * @description Receive marketing and promotional emails
+             * @example false
+             */
+            marketing_promotional: boolean;
+        };
+        NotificationPreferences: {
+            channels: components["schemas"]["NotificationChannelPreferences"];
+            /** @description Per-type delivery preferences keyed by notification type (e.g. "feed.item.created", "feed.reply.created") */
+            types: {
+                [key: string]: components["schemas"]["NotificationTypePreference"];
+            };
+        };
         PreferencesResponse: {
             preferences: components["schemas"]["Preferences"];
             /**
@@ -11398,28 +11685,6 @@ export interface components {
             range: "7d" | "14d" | "30d" | "60d" | "90d" | "180d";
             items: components["schemas"]["TopAccessedResourceItem"][];
         };
-        EmailNotificationPreferences: {
-            /**
-             * @description Receive platform announcement emails
-             * @example true
-             */
-            platform_announcement: boolean;
-            /**
-             * @description Receive account security emails
-             * @example true
-             */
-            account_security: boolean;
-            /**
-             * @description Receive new feature emails
-             * @example true
-             */
-            new_feature: boolean;
-            /**
-             * @description Receive marketing and promotional emails
-             * @example false
-             */
-            marketing_promotional: boolean;
-        };
         NotificationChannelPreferences: {
             /**
              * @description Enable in-app notifications globally
@@ -11445,13 +11710,6 @@ export interface components {
              */
             email: "instant" | "digest" | "none";
         };
-        NotificationPreferences: {
-            channels: components["schemas"]["NotificationChannelPreferences"];
-            /** @description Per-type delivery preferences keyed by notification type (e.g. "feed.item.created", "feed.reply.created") */
-            types: {
-                [key: string]: components["schemas"]["NotificationTypePreference"];
-            };
-        };
         Preferences: {
             email_notification: components["schemas"]["EmailNotificationPreferences"];
             notifications: components["schemas"]["NotificationPreferences"];
@@ -20903,6 +21161,221 @@ export interface operations {
             };
         };
     };
+    getAdminUserInsights: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The user's per-type resource counts */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserInsights"];
+                };
+            };
+            /** @description Bad request — malformed user id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown user id, or the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getAdminUserResourceCreationMetrics: {
+        parameters: {
+            query?: {
+                /** @description Inclusive start of the range. Defaults to 30 days before `to`. */
+                from?: string;
+                /** @description Exclusive end of the range. Defaults to now. */
+                to?: string;
+                /** @description Bucket size. */
+                granularity?: "day" | "week" | "month";
+            };
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Bucketed creation counts per type */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserResourceCreationMetrics"];
+                };
+            };
+            /**
+             * @description Bad request — malformed user id, `to` is not after `from`, the range
+             *     exceeds the maximum span, or `granularity` is outside its enum
+             */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown user id, or the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getAdminUserTimeline: {
+        parameters: {
+            query?: {
+                /** @description Opaque cursor from a previous page's `next_cursor`. */
+                cursor?: string;
+                /** @description Page size. */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One page of timeline events, newest first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserTimelinePage"];
+                };
+            };
+            /** @description Bad request — malformed user id, malformed cursor, or `limit` out of range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown user id, or the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getAdminUserNotificationPreferences: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The user's notification preferences */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserNotificationPreferences"];
+                };
+            };
+            /** @description Bad request — malformed user id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown user id, or the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listComments: {
         parameters: {
             query: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibexp/api-client",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "description": "Typed VibeXP API client generated from the OpenAPI spec (openapi-fetch main entrypoint, axios SDK at ./axios)",
   "license": "MIT",
   "repository": {