@attrove/sdk 0.1.7 → 0.1.9

package/README.md

@@ -129,10 +129,62 @@ await attrove.conversations.updateSync([
 // List integrations
 const integrations = await attrove.integrations.list();
 
+// Get a single integration
+const integration = await attrove.integrations.get('integration-id');
+console.log(`${integration.provider}: last synced ${integration.last_synced_at}`);
+
 // Disconnect an integration
 await attrove.integrations.disconnect('integration-uuid');
 ```
 
+### Threads
+
+```typescript
+// Discover relevant threads via semantic search
+const { threads } = await attrove.threads.discover('Q4 budget discussion', {
+  integrationTypes: ['slack'],
+  afterDate: '2024-01-01T00:00:00Z',
+  limit: 5,
+});
+
+for (const thread of threads) {
+  console.log(`${thread.title} (score: ${thread.relevance_score})`);
+}
+
+// Analyze a thread for structured insights
+const analysis = await attrove.threads.analyze('conversation-uuid');
+console.log(analysis.summary);
+console.log(`Sentiment: ${analysis.sentiment}`);
+console.log(`Action items: ${analysis.action_items.length}`);
+console.log(`Decisions: ${analysis.decisions.length}`);
+```
+
+### Meetings
+
+```typescript
+// List meetings
+const { data: meetings } = await attrove.meetings.list({
+  expand: ['summary', 'action_items', 'attendees'],
+});
+
+// Get a single meeting
+const meeting = await attrove.meetings.get('meeting-id');
+
+// Update a meeting's summary or action items
+const updated = await attrove.meetings.update('meeting-id', {
+  summary: 'Revised meeting summary.',
+  shortSummary: 'Brief revision.',
+  actionItems: [
+    { description: 'Follow up with client', assignee: 'Alice' },
+  ],
+});
+
+// Regenerate the AI summary from the transcript
+const result = await attrove.meetings.regenerateSummary('meeting-id');
+console.log(result.summary);
+console.log(`Action items: ${result.action_items.length}`);
+```
+
 ## Server-to-Server (Admin) API
 
 Use the admin client for operations that require partner authentication:

package/cjs/admin-client.js

@@ -12,6 +12,7 @@ const index_js_1 = require("./errors/index.js");
 const index_js_2 = require("./types/index.js");
 const index_js_3 = require("./types/index.js");
 const constants_js_1 = require("./constants.js");
+const settings_js_1 = require("./resources/settings.js");
 /**
  * Validate the admin client configuration.
  *
@@ -130,28 +131,6 @@ class AdminUsersResource {
         // Route: POST /v1/users/:user_id/tokens with X-Auth-Type: partner header
         return this.http.post(`/v1/users/${userId}/tokens`, body);
     }
-    /**
-     * Delete a user.
-     *
-     * Permanently deletes a user and all associated data.
-     *
-     * @experimental This method is not yet implemented and will throw an error.
-     *
-     * @param userId - User ID (UUID format)
-     *
-     * @throws {Error} Always throws - not yet implemented
-     *
-     * @example
-     * ```ts
-     * // Not yet available
-     * const admin = Attrove.admin({ clientId, clientSecret });
-     * await admin.users.delete(userId);
-     * ```
-     */
-    async delete(userId) {
-        // TODO: Implement user deletion endpoint
-        throw new Error("User deletion not yet implemented. This feature is coming soon.");
-    }
 }
 exports.AdminUsersResource = AdminUsersResource;
 /**
@@ -217,6 +196,7 @@ class AttroveAdmin {
         });
         // Initialize resources
         this.users = new AdminUsersResource(this.http, this.config.clientId);
+        this.settings = new settings_js_1.AdminSettingsResource(this.http, this.config.clientId);
     }
 }
 exports.AttroveAdmin = AttroveAdmin;

package/cjs/client.js

@@ -13,6 +13,10 @@ const users_js_1 = require("./resources/users.js");
 const messages_js_1 = require("./resources/messages.js");
 const conversations_js_1 = require("./resources/conversations.js");
 const integrations_js_1 = require("./resources/integrations.js");
+const calendars_js_1 = require("./resources/calendars.js");
+const events_js_1 = require("./resources/events.js");
+const meetings_js_1 = require("./resources/meetings.js");
+const threads_js_1 = require("./resources/threads.js");
 const query_js_1 = require("./resources/query.js");
 const index_js_1 = require("./errors/index.js");
 const index_js_2 = require("./types/index.js");
@@ -114,6 +118,10 @@ class Attrove {
         this.messages = new messages_js_1.MessagesResource(this.http, this.config.userId);
         this.conversations = new conversations_js_1.ConversationsResource(this.http, this.config.userId);
         this.integrations = new integrations_js_1.IntegrationsResource(this.http, this.config.userId);
+        this.calendars = new calendars_js_1.CalendarsResource(this.http, this.config.userId);
+        this.events = new events_js_1.EventsResource(this.http, this.config.userId);
+        this.meetings = new meetings_js_1.MeetingsResource(this.http, this.config.userId);
+        this.threads = new threads_js_1.ThreadsResource(this.http, this.config.userId);
         this.queryResource = new query_js_1.QueryResource(this.http, this.config.userId);
     }
     /**
@@ -235,79 +243,5 @@ class Attrove {
             streaming.close();
         }
     }
-    /**
-     * Get meeting preparation brief.
-     *
-     * Retrieves context about attendees, recent conversations, and relevant
-     * information to help prepare for an upcoming meeting.
-     *
-     * @experimental This method is not yet implemented and will throw an error.
-     *
-     * @param meetingId - Meeting ID (UUID format)
-     * @returns Meeting brief with attendee info and relevant context
-     *
-     * @throws {Error} Always throws - not yet implemented
-     *
-     * @example
-     * ```ts
-     * // Not yet available
-     * const brief = await attrove.brief('meeting-uuid-here');
-     * console.log(brief.summary);
-     * console.log('Attendees:', brief.attendees);
-     * ```
-     */
-    async brief(meetingId) {
-        // TODO: Implement meeting brief endpoint
-        throw new Error("Meeting brief not yet implemented. This feature is coming soon.");
-    }
-    /**
-     * Get information about an entity (person, company, etc.).
-     *
-     * Retrieves profile information and interaction history for an entity
-     * identified from the user's communications.
-     *
-     * @experimental This method is not yet implemented and will throw an error.
-     *
-     * @param entityId - Entity ID (UUID format)
-     * @returns Entity profile with interaction history
-     *
-     * @throws {Error} Always throws - not yet implemented
-     *
-     * @example
-     * ```ts
-     * // Not yet available
-     * const entity = await attrove.entity('entity-uuid');
-     * console.log(`${entity.name}: ${entity.message_count} messages`);
-     * ```
-     */
-    async entity(entityId) {
-        // TODO: Implement entity endpoint
-        throw new Error("Entity lookup not yet implemented. This feature is coming soon.");
-    }
-    /**
-     * Get a conversation thread.
-     *
-     * Retrieves all messages in a specific conversation thread.
-     *
-     * @experimental This method is not yet implemented and will throw an error.
-     *
-     * @param conversationId - Conversation ID (UUID format)
-     * @returns Conversation thread with messages
-     *
-     * @throws {Error} Always throws - not yet implemented
-     *
-     * @example
-     * ```ts
-     * // Not yet available
-     * const thread = await attrove.thread('conversation-uuid-here');
-     * for (const msg of thread.messages) {
-     *   console.log(`${msg.sender_name}: ${msg.body_text}`);
-     * }
-     * ```
-     */
-    async thread(conversationId) {
-        // TODO: Implement thread endpoint
-        throw new Error("Thread retrieval not yet implemented. This feature is coming soon.");
-    }
 }
 exports.Attrove = Attrove;

package/cjs/constants.js

@@ -13,7 +13,7 @@ exports.getWsCloseReason = exports.WS_CLOSE_CODES = exports.RETRYABLE_STATUS_SET
  * Automatically synchronized with package.json during the release process.
  * For programmatic access, use `getVersion()` from './version'.
  */
-exports.SDK_VERSION = "0.1.7"; // auto-synced from package.json during release
+exports.SDK_VERSION = "0.1.9"; // auto-synced from package.json during release
 /**
  * Default API base URL for Attrove services.
  */

package/cjs/resources/calendars.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Calendars Resource
+ *
+ * Provides methods for listing, retrieving, and updating calendars
+ * from connected calendar integrations (e.g. Google Calendar).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarsResource = void 0;
+/**
+ * Calendars resource for managing calendar sync preferences.
+ *
+ * Users may have multiple calendars per integration (e.g. "Work", "Personal",
+ * "Holidays" in Google Calendar). By default only the primary calendar is
+ * active. Use `update()` to activate or deactivate calendars — only active
+ * calendars have their events synced.
+ */
+class CalendarsResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * List calendars with optional filtering.
+     *
+     * @param options - Filtering, pagination, and expansion options
+     * @returns Paginated list of calendars
+     * @throws {AuthenticationError} If the API key is invalid
+     * @throws {AuthorizationError} If the user lacks access
+     * @throws {NetworkError} If the request fails due to a network issue
+     *
+     * @example
+     * ```ts
+     * // List all calendars
+     * const { data } = await attrove.calendars.list();
+     *
+     * // List only active calendars
+     * const { data } = await attrove.calendars.list({ active: true });
+     *
+     * // List calendars for a specific integration
+     * const { data } = await attrove.calendars.list({ integrationId: '67890' });
+     * ```
+     */
+    async list(options = {}) {
+        const params = {};
+        if (options.integrationId) {
+            params.integration_id = options.integrationId;
+        }
+        if (options.active !== undefined) {
+            params.active = String(options.active);
+        }
+        if (options.limit !== undefined) {
+            params.limit = String(options.limit);
+        }
+        if (options.offset !== undefined) {
+            params.offset = String(options.offset);
+        }
+        if (options.expand?.length) {
+            params.expand = options.expand.join(",");
+        }
+        const response = await this.http.request(`/v1/users/${this.userId}/calendars`, { method: "GET" }, params);
+        return {
+            data: response.data,
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Get a single calendar by ID.
+     *
+     * @param id - Calendar ID
+     * @returns The requested calendar
+     * @throws {NotFoundError} If the calendar does not exist
+     * @throws {AuthenticationError} If the API key is invalid
+     * @throws {NetworkError} If the request fails due to a network issue
+     *
+     * @example
+     * ```ts
+     * const calendar = await attrove.calendars.get('12345');
+     * console.log(calendar.title, calendar.active);
+     * ```
+     */
+    async get(id) {
+        return this.http.get(`/v1/users/${this.userId}/calendars/${id}`);
+    }
+    /**
+     * Update a calendar's properties (e.g. toggle sync on/off).
+     *
+     * When a calendar is activated, its events begin syncing on the next
+     * sync cycle (within 5 minutes).
+     *
+     * @param id - Calendar ID
+     * @param options - Fields to update (currently only `active`)
+     * @returns The updated calendar
+     * @throws {NotFoundError} If the calendar does not exist
+     * @throws {ValidationError} If the options are invalid
+     * @throws {AuthenticationError} If the API key is invalid
+     * @throws {NetworkError} If the request fails due to a network issue
+     *
+     * @example
+     * ```ts
+     * // Activate a calendar for syncing
+     * const updated = await attrove.calendars.update('12345', { active: true });
+     *
+     * // Deactivate a calendar
+     * const updated = await attrove.calendars.update('12345', { active: false });
+     * ```
+     */
+    async update(id, options) {
+        return this.http.patch(`/v1/users/${this.userId}/calendars/${id}`, options);
+    }
+}
+exports.CalendarsResource = CalendarsResource;

package/cjs/resources/events.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Events Resource
+ *
+ * Provides methods for accessing calendar events from connected integrations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsResource = void 0;
+/**
+ * Events resource for accessing calendar event data.
+ *
+ * Provides methods for listing and retrieving calendar events from
+ * connected integrations (Google Calendar, etc.).
+ */
+class EventsResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * List calendar events with optional filtering.
+     *
+     * @param options - Filtering, pagination, and expansion options
+     * @returns Paginated list of calendar events
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ValidationError} If the filter parameters are invalid
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * // List upcoming events
+     * const { data, pagination } = await attrove.events.list({
+     *   startDate: '2025-01-15T00:00:00Z',
+     *   endDate: '2025-01-16T00:00:00Z',
+     * });
+     *
+     * // List events with attendee details
+     * const { data } = await attrove.events.list({
+     *   expand: ['attendees', 'description'],
+     * });
+     * ```
+     */
+    async list(options = {}) {
+        const params = {};
+        if (options.calendarId) {
+            params.calendar_id = options.calendarId;
+        }
+        if (options.startDate) {
+            params.start_date = options.startDate;
+        }
+        if (options.endDate) {
+            params.end_date = options.endDate;
+        }
+        if (options.limit !== undefined) {
+            params.limit = String(options.limit);
+        }
+        if (options.offset !== undefined) {
+            params.offset = String(options.offset);
+        }
+        if (options.expand?.length) {
+            params.expand = options.expand.join(",");
+        }
+        const response = await this.http.request(`/v1/users/${this.userId}/events`, { method: "GET" }, params);
+        return {
+            data: response.data,
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Get a single calendar event by ID.
+     *
+     * @param id - Event ID
+     * @returns The requested calendar event
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the event does not exist
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const event = await attrove.events.get('event-id');
+     * console.log(event.title, event.start_time);
+     * ```
+     */
+    async get(id) {
+        return this.http.get(`/v1/users/${this.userId}/events/${id}`);
+    }
+}
+exports.EventsResource = EventsResource;

package/cjs/resources/index.js

@@ -3,7 +3,7 @@
  * Resource exports
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueryResource = exports.IntegrationsResource = exports.ConversationsResource = exports.MessagesResource = exports.UsersResource = void 0;
+exports.AdminSettingsResource = exports.QueryResource = exports.ThreadsResource = exports.MeetingsResource = exports.EventsResource = exports.CalendarsResource = exports.IntegrationsResource = exports.ConversationsResource = exports.MessagesResource = exports.UsersResource = void 0;
 var users_js_1 = require("./users.js");
 Object.defineProperty(exports, "UsersResource", { enumerable: true, get: function () { return users_js_1.UsersResource; } });
 var messages_js_1 = require("./messages.js");
@@ -12,5 +12,15 @@ var conversations_js_1 = require("./conversations.js");
 Object.defineProperty(exports, "ConversationsResource", { enumerable: true, get: function () { return conversations_js_1.ConversationsResource; } });
 var integrations_js_1 = require("./integrations.js");
 Object.defineProperty(exports, "IntegrationsResource", { enumerable: true, get: function () { return integrations_js_1.IntegrationsResource; } });
+var calendars_js_1 = require("./calendars.js");
+Object.defineProperty(exports, "CalendarsResource", { enumerable: true, get: function () { return calendars_js_1.CalendarsResource; } });
+var events_js_1 = require("./events.js");
+Object.defineProperty(exports, "EventsResource", { enumerable: true, get: function () { return events_js_1.EventsResource; } });
+var meetings_js_1 = require("./meetings.js");
+Object.defineProperty(exports, "MeetingsResource", { enumerable: true, get: function () { return meetings_js_1.MeetingsResource; } });
+var threads_js_1 = require("./threads.js");
+Object.defineProperty(exports, "ThreadsResource", { enumerable: true, get: function () { return threads_js_1.ThreadsResource; } });
 var query_js_1 = require("./query.js");
 Object.defineProperty(exports, "QueryResource", { enumerable: true, get: function () { return query_js_1.QueryResource; } });
+var settings_js_1 = require("./settings.js");
+Object.defineProperty(exports, "AdminSettingsResource", { enumerable: true, get: function () { return settings_js_1.AdminSettingsResource; } });

package/cjs/resources/integrations.js

@@ -6,11 +6,12 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IntegrationsResource = void 0;
+const index_js_1 = require("../errors/index.js");
 /**
  * Integrations resource for managing connected services.
  *
- * Provides methods for listing and disconnecting integrations
- * (Gmail, Slack, Google Calendar, etc.).
+ * Provides methods for listing, retrieving, and disconnecting
+ * integrations (Gmail, Slack, Google Calendar, etc.).
  */
 class IntegrationsResource {
     constructor(http, userId) {
@@ -38,6 +39,35 @@ class IntegrationsResource {
         const response = await this.http.get(`/v1/users/${this.userId}`);
         return response.integrations;
     }
+    /**
+     * Get a single integration by ID.
+     *
+     * Returns detailed information including type, email, and last sync time.
+     *
+     * @param id - Integration ID
+     * @returns Detailed integration information
+     *
+     * @throws {ValidationError} If id is empty (client-side)
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the integration does not exist
+     * @throws {ServerError} If the server encounters an internal error
+     * @throws {TimeoutError} If the request times out
+     * @throws {RateLimitError} If the API rate limit is exceeded
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const integration = await attrove.integrations.get('integration-id');
+     * console.log(`${integration.provider}: ${integration.auth_status}`);
+     * console.log(`Last synced: ${integration.last_synced_at}`);
+     * ```
+     */
+    async get(id) {
+        if (!id) {
+            throw new index_js_1.ValidationError("id is required and must be a non-empty string");
+        }
+        return this.http.get(`/v1/users/${this.userId}/integrations/${id}`);
+    }
     /**
      * Disconnect an integration.
      *

package/cjs/resources/meetings.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * Meetings Resource
+ *
+ * Provides methods for accessing meetings with AI-generated summaries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetingsResource = void 0;
+const index_js_1 = require("../errors/index.js");
+/**
+ * Meetings resource for accessing meeting data with AI summaries.
+ *
+ * Provides methods for listing, retrieving, updating, and regenerating
+ * summaries for meetings from connected integrations (Google Meet, Zoom, Teams).
+ */
+class MeetingsResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * List meetings with optional filtering.
+     *
+     * @param options - Filtering, pagination, and expansion options
+     * @returns Paginated list of meetings
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ValidationError} If the filter parameters are invalid
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * // List recent meetings with summaries
+     * const { data, pagination } = await attrove.meetings.list({
+     *   expand: ['summary', 'action_items', 'attendees'],
+     * });
+     *
+     * // List meetings from a specific provider
+     * const { data } = await attrove.meetings.list({
+     *   provider: 'google_meet',
+     *   hasSummary: true,
+     * });
+     * ```
+     */
+    async list(options = {}) {
+        const params = {};
+        if (options.startDate) {
+            params.start_date = options.startDate;
+        }
+        if (options.endDate) {
+            params.end_date = options.endDate;
+        }
+        if (options.provider) {
+            params.provider = options.provider;
+        }
+        if (options.hasSummary !== undefined) {
+            params.has_summary = String(options.hasSummary);
+        }
+        if (options.limit !== undefined) {
+            params.limit = String(options.limit);
+        }
+        if (options.offset !== undefined) {
+            params.offset = String(options.offset);
+        }
+        if (options.expand?.length) {
+            params.expand = options.expand.join(",");
+        }
+        const response = await this.http.request(`/v1/users/${this.userId}/meetings`, { method: "GET" }, params);
+        return {
+            data: response.data,
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Get a single meeting by ID.
+     *
+     * @param id - Meeting ID
+     * @returns The requested meeting
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the meeting does not exist
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const meeting = await attrove.meetings.get('meeting-id');
+     * console.log(meeting.title, meeting.summary);
+     * ```
+     */
+    async get(id) {
+        return this.http.get(`/v1/users/${this.userId}/meetings/${id}`);
+    }
+    /**
+     * Update a meeting's summary and action items.
+     *
+     * @param id - Meeting ID
+     * @param options - Fields to update (summary, shortSummary, actionItems)
+     * @returns The updated meeting
+     *
+     * @throws {ValidationError} If id is empty or no fields are provided (client-side), or if the server rejects the update parameters
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the meeting does not exist
+     * @throws {ServerError} If the server encounters an internal error
+     * @throws {TimeoutError} If the request times out
+     * @throws {RateLimitError} If the API rate limit is exceeded
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const updated = await attrove.meetings.update('meeting-id', {
+     *   summary: 'Revised summary of the meeting.',
+     *   actionItems: [
+     *     { description: 'Follow up with client', assignee: 'Alice' },
+     *   ],
+     * });
+     * ```
+     */
+    async update(id, options) {
+        if (!id) {
+            throw new index_js_1.ValidationError("id is required and must be a non-empty string");
+        }
+        if (options.summary == null &&
+            options.shortSummary == null &&
+            options.actionItems == null) {
+            throw new index_js_1.ValidationError("At least one field (summary, shortSummary, or actionItems) must be provided");
+        }
+        const body = {};
+        if (options.summary != null) {
+            body.summary = options.summary;
+        }
+        if (options.shortSummary != null) {
+            body.short_summary = options.shortSummary;
+        }
+        if (options.actionItems != null) {
+            body.action_items = options.actionItems;
+        }
+        return this.http.patch(`/v1/users/${this.userId}/meetings/${id}`, body);
+    }
+    /**
+     * Regenerate the AI summary for a meeting from its transcript.
+     *
+     * Triggers server-side AI processing and may take longer than typical
+     * API calls. The response contains the newly generated summary without
+     * the full meeting object.
+     *
+     * @param id - Meeting ID
+     * @returns The regenerated summary, short summary, and action items
+     *
+     * @throws {ValidationError} If id is empty (client-side)
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the meeting does not exist
+     * @throws {ServerError} If the server encounters an internal error
+     * @throws {TimeoutError} If the request times out
+     * @throws {RateLimitError} If the API rate limit is exceeded
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const result = await attrove.meetings.regenerateSummary('meeting-id');
+     * console.log(result.summary);
+     * console.log(`Action items: ${result.action_items.length}`);
+     * ```
+     */
+    async regenerateSummary(id) {
+        if (!id) {
+            throw new index_js_1.ValidationError("id is required and must be a non-empty string");
+        }
+        return this.http.post(`/v1/users/${this.userId}/meetings/${id}/regenerate-summary`);
+    }
+}
+exports.MeetingsResource = MeetingsResource;