@attrove/sdk 0.1.3 → 0.1.4

package/types/src/resources/integrations.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Integrations Resource
+ *
+ * Provides methods for managing connected integrations (Gmail, Slack, etc.).
+ */
+import { HttpClient } from '../utils/fetch';
+import { Integration } from '../types';
+/**
+ * Integrations resource for managing connected services.
+ *
+ * Provides methods for listing and disconnecting integrations
+ * (Gmail, Slack, Google Calendar, etc.).
+ */
+export declare class IntegrationsResource {
+    private readonly http;
+    private readonly userId;
+    constructor(http: HttpClient, userId: string);
+    /**
+     * List all integrations for the user.
+     *
+     * Note: This returns the same data as `users.get().integrations`.
+     * Use this method when you only need integration data.
+     *
+     * @returns Array of connected integrations
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const integrations = await attrove.integrations.list();
+     * console.log(integrations.map(i => `${i.provider}: ${i.auth_status}`));
+     * ```
+     */
+    list(): Promise<Integration[]>;
+    /**
+     * Disconnect an integration.
+     *
+     * This will:
+     * - Revoke OAuth tokens where possible
+     * - Stop syncing data from this integration
+     * - Remove the integration record
+     *
+     * Note: Historical data that was already synced is retained.
+     *
+     * @param id - Integration ID (UUID format)
+     * @returns Confirmation of deletion
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the integration does not exist
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const { deleted } = await attrove.integrations.disconnect('integration-uuid');
+     * console.log(deleted ? 'Disconnected' : 'Already removed');
+     * ```
+     */
+    disconnect(id: string): Promise<{
+        deleted: boolean;
+    }>;
+}
+//# sourceMappingURL=integrations.d.ts.map

package/types/src/resources/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/integrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM;IAGjC;;;;;;;;;;;;;;;;OAgBG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAOpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAK5D"}

package/types/src/resources/messages.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Messages Resource
+ *
+ * Provides methods for accessing messages from connected integrations.
+ */
+import { HttpClient } from '../utils/fetch';
+import { Message, Pagination, ListMessagesOptions } from '../types';
+/**
+ * Paginated messages response.
+ */
+export interface MessagesPage {
+    data: Message[];
+    pagination: Pagination;
+}
+/**
+ * Messages resource for accessing message data.
+ *
+ * Provides methods for listing and retrieving messages from
+ * connected integrations (Gmail, Slack, etc.).
+ */
+export declare class MessagesResource {
+    private readonly http;
+    private readonly userId;
+    constructor(http: HttpClient, userId: string);
+    /**
+     * List messages with optional filtering.
+     *
+     * @param options - Filtering, pagination, and expansion options
+     * @returns Paginated list of messages
+     *
+     * @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 messages
+     * const { data, pagination } = await attrove.messages.list();
+     *
+     * // List messages with body text
+     * const { data } = await attrove.messages.list({ expand: ['body_text'] });
+     *
+     * // Fetch specific messages by ID (UUIDs)
+     * const { data } = await attrove.messages.list({
+     *   ids: ['message-uuid-1', 'message-uuid-2'],
+     *   expand: ['body_text']
+     * });
+     * ```
+     */
+    list(options?: ListMessagesOptions): Promise<MessagesPage>;
+    /**
+     * Get a single message by ID.
+     *
+     * @param id - Message ID (UUID format)
+     * @returns The requested message
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the message does not exist
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const message = await attrove.messages.get('message-uuid');
+     * console.log(message.subject);
+     * ```
+     */
+    get(id: string): Promise<Message>;
+}
+//# sourceMappingURL=messages.d.ts.map

package/types/src/resources/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAqB,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM;IAGjC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;IAwCpE;;;;;;;;;;;;;;;OAeG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGxC"}

package/types/src/resources/query.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Query Resource
+ *
+ * Provides methods for RAG (Retrieval-Augmented Generation) queries.
+ */
+import { HttpClient } from '../utils/fetch';
+import { QueryOptions, QueryResponse, SearchOptions, SearchResponse } from '../types';
+/**
+ * Query resource for RAG operations.
+ *
+ * Provides methods for AI-powered queries and semantic search
+ * across the user's unified context.
+ */
+export declare class QueryResource {
+    private readonly http;
+    private readonly userId;
+    constructor(http: HttpClient, userId: string);
+    /**
+     * Query the user's unified context with AI.
+     *
+     * Performs semantic search across connected integrations and returns
+     * an AI-generated answer based on the relevant context.
+     *
+     * @param prompt - The natural language question to answer
+     * @param options - Query options including history, filters, etc.
+     * @returns AI-generated answer with conversation history and source references
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ValidationError} If the query parameters are invalid
+     * @throws {RateLimitError} If rate limits are exceeded
+     * @throws {NetworkError} If unable to reach the API
+     * @throws {ServerError} If the server encounters an error during processing
+     *
+     * @example
+     * ```ts
+     * // Simple query
+     * const response = await attrove.query('What did Sarah say about the Q4 budget?');
+     *
+     * // With conversation history
+     * const response = await attrove.query('What about Q3?', {
+     *   history: [
+     *     { role: 'user', content: 'What did Sarah say about the Q4 budget?' },
+     *     { role: 'assistant', content: 'Sarah mentioned...' }
+     *   ]
+     * });
+     *
+     * // With filters
+     * const response = await attrove.query('Latest updates', {
+     *   integrationIds: ['550e8400-e29b-41d4-a716-446655440000'],
+     *   includeSources: true
+     * });
+     * ```
+     */
+    query(prompt: string, options?: QueryOptions): Promise<QueryResponse>;
+    /**
+     * Semantic search across the user's context.
+     *
+     * Returns raw matching messages grouped by conversation, without AI summarization.
+     * Use this when you need full control over how results are displayed.
+     *
+     * @param query - The search query (semantic, not keyword-based)
+     * @param options - Search options including filters, date range, etc.
+     * @returns Matching messages grouped by conversation
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ValidationError} If the search parameters are invalid
+     * @throws {RateLimitError} If rate limits are exceeded
+     * @throws {NetworkError} If unable to reach the API
+     * @throws {ServerError} If the server encounters an error during search
+     *
+     * @example
+     * ```ts
+     * // Basic search
+     * const results = await attrove.search('product launch');
+     *
+     * // With filters
+     * const results = await attrove.search('budget discussion', {
+     *   afterDate: '2024-01-01T00:00:00Z',
+     *   senderDomains: ['acme.com'],
+     *   includeBodyText: true
+     * });
+     * ```
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+}
+//# sourceMappingURL=query.d.ts.map

package/types/src/resources/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EAEf,MAAM,UAAU,CAAC;AAYlB;;;;;GAKG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM;IAGjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAmC/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;CAiClF"}

package/types/src/resources/users.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Users Resource
+ *
+ * Provides methods for accessing user data and sync statistics.
+ */
+import { HttpClient } from '../utils/fetch';
+import { User, Integration, SyncStats } from '../types';
+/**
+ * User with integrations response.
+ */
+export interface UserWithIntegrations {
+    user: User;
+    integrations: Integration[];
+}
+/**
+ * User update options.
+ */
+export interface UpdateUserOptions {
+    firstName?: string;
+    lastName?: string;
+    role?: string;
+    timezone?: string;
+    onboarded?: boolean;
+}
+/**
+ * Users resource for accessing user data.
+ *
+ * Provides methods for retrieving user profiles, updating settings,
+ * and accessing sync statistics across integrations.
+ */
+export declare class UsersResource {
+    private readonly http;
+    private readonly userId;
+    constructor(http: HttpClient, userId: string);
+    /**
+     * Get the current user's profile and integrations.
+     *
+     * @returns User profile with connected integrations
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the user does not exist
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const { user, integrations } = await attrove.users.get();
+     * console.log(`${user.email} has ${integrations.length} integrations`);
+     * ```
+     */
+    get(): Promise<UserWithIntegrations>;
+    /**
+     * Update the current user's profile.
+     *
+     * @param options - Fields to update
+     * @returns Updated user profile
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ValidationError} If the update options are invalid
+     * @throws {NotFoundError} If the user does not exist
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const user = await attrove.users.update({
+     *   timezone: 'America/New_York',
+     *   firstName: 'John'
+     * });
+     * ```
+     */
+    update(options: UpdateUserOptions): Promise<User>;
+    /**
+     * Get sync statistics for the user's integrations.
+     *
+     * @returns Sync statistics including message counts and last sync times
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the user does not exist
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const stats = await attrove.users.syncStats();
+     * console.log(`Total messages: ${stats.totals.messages.count}`);
+     * ```
+     */
+    syncStats(): Promise<SyncStats>;
+}
+//# sourceMappingURL=users.d.ts.map

package/types/src/resources/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/users.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM;IAGjC;;;;;;;;;;;;;;OAcG;IACG,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI1C;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD;;;;;;;;;;;;;;OAcG;IACG,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC;CAGtC"}