@attrove/sdk 0.1.2 → 0.1.4

package/types/src/client.d.ts

@@ -0,0 +1,233 @@
+/**
+ * Attrove Client
+ *
+ * Main entry point for the Attrove SDK. Provides a simple, intuitive API
+ * for accessing user context through connected integrations.
+ */
+import { StreamOptions, StreamResult } from './utils/streaming';
+import { UsersResource } from './resources/users';
+import { MessagesResource } from './resources/messages';
+import { ConversationsResource } from './resources/conversations';
+import { IntegrationsResource } from './resources/integrations';
+import { AttroveConfig, QueryOptions, QueryResponse, SearchOptions, SearchResponse } from './types';
+/**
+ * The Attrove client for accessing user context.
+ *
+ * This is the main entry point for the Attrove SDK. It provides methods for:
+ * - Querying user context with AI (query, search)
+ * - Streaming query responses in real-time
+ * - Accessing user data, messages, conversations, and integrations
+ *
+ * @example
+ * ```ts
+ * import { Attrove } from '@attrove/sdk';
+ *
+ * const attrove = new Attrove({
+ *   apiKey: 'sk_...',
+ *   userId: 'user-uuid'
+ * });
+ *
+ * // Query user's context
+ * const response = await attrove.query('What meetings do I have tomorrow?');
+ * console.log(response.answer);
+ *
+ * // Search for specific information
+ * const results = await attrove.search('quarterly report');
+ * ```
+ */
+export declare class Attrove {
+    private readonly http;
+    private readonly config;
+    private readonly queryResource;
+    /**
+     * Users resource for accessing user data and sync statistics.
+     */
+    readonly users: UsersResource;
+    /**
+     * Messages resource for accessing messages from connected integrations.
+     */
+    readonly messages: MessagesResource;
+    /**
+     * Conversations resource for managing conversations and sync settings.
+     */
+    readonly conversations: ConversationsResource;
+    /**
+     * Integrations resource for managing connected services.
+     */
+    readonly integrations: IntegrationsResource;
+    /**
+     * Create a new Attrove client.
+     *
+     * @param config - Client configuration
+     * @throws {ValidationError} If the configuration is invalid (missing apiKey, invalid userId format, etc.)
+     *
+     * @example
+     * ```ts
+     * const attrove = new Attrove({
+     *   apiKey: 'sk_...',
+     *   userId: 'user-uuid',
+     *   timeout: 60000,  // 60 seconds
+     *   onRetry: (info) => console.log(`Retrying (${info.attempt}/${info.maxRetries})...`)
+     * });
+     * ```
+     */
+    constructor(config: AttroveConfig);
+    /**
+     * Query the user's unified context with AI.
+     *
+     * This is the primary method for asking questions about the user's data.
+     * It performs semantic search across all 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 source references
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ValidationError} If the request 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
+     *
+     * @example
+     * ```ts
+     * // Simple query
+     * const response = await attrove.query('What did Sarah say about the Q4 budget?');
+     * console.log(response.answer);
+     *
+     * // Multi-turn conversation
+     * let history: ConversationMessage[] = [];
+     *
+     * const first = await attrove.query('What meetings do I have tomorrow?');
+     * history = first.history;
+     *
+     * const followUp = await attrove.query('Who is attending?', { history });
+     * console.log(followUp.answer);
+     * ```
+     */
+    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 request 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
+     *
+     * @example
+     * ```ts
+     * const results = await attrove.search('quarterly report', {
+     *   afterDate: '2024-01-01T00:00:00Z',
+     *   includeBodyText: true
+     * });
+     *
+     * for (const [convId, conv] of Object.entries(results.conversations)) {
+     *   console.log(`Conversation: ${conv.conversation_name}`);
+     *   for (const [threadId, messages] of Object.entries(conv.threads)) {
+     *     console.log(`  Thread ${threadId}: ${messages.length} messages`);
+     *   }
+     * }
+     * ```
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Stream a query response in real-time.
+     *
+     * Connects to the WebSocket endpoint and streams the AI-generated answer
+     * as it's being generated. Useful for displaying results progressively.
+     *
+     * @param prompt - The natural language question to answer
+     * @param options - Query and streaming options
+     * @returns Stream result with full answer and metadata
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NetworkError} If WebSocket connection fails
+     * @throws {TimeoutError} If connection times out
+     * @throws {AttroveError} If the server returns an error
+     *
+     * @example
+     * ```ts
+     * const result = await attrove.stream('What happened in the meeting?', {
+     *   onChunk: (chunk) => process.stdout.write(chunk),
+     *   onState: (state) => console.log('State:', state),
+     * });
+     *
+     * console.log('\\nFull answer:', result.answer);
+     * ```
+     */
+    stream(prompt: string, options?: QueryOptions & StreamOptions): Promise<StreamResult>;
+    /**
+     * 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);
+     * ```
+     */
+    brief(meetingId: string): Promise<unknown>;
+    /**
+     * 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`);
+     * ```
+     */
+    entity(entityId: string): Promise<unknown>;
+    /**
+     * 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}`);
+     * }
+     * ```
+     */
+    thread(conversationId: string): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/types/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../packages/sdk/src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAmB,aAAa,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIhE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EAGf,MAAM,SAAS,CAAC;AA6DjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4E;IACnG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAE5C;;;;;;;;;;;;;;;OAeG;gBACS,MAAM,EAAE,aAAa;IA8BjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAI3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7E;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAY,GAAG,aAAkB,GACzC,OAAO,CAAC,YAAY,CAAC;IAoCxB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhD;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhD;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAIvD"}

package/types/src/constants.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SDK Constants
+ *
+ * Centralized constants used across the SDK. Consolidating these ensures
+ * consistency and makes maintenance easier.
+ */
+/**
+ * SDK version string.
+ *
+ * This version is updated by the release process. Keep it in sync with
+ * the version in package.json. For programmatic access, use `getVersion()`
+ * from './version'.
+ */
+export declare const SDK_VERSION = "0.1.3";
+/**
+ * Default API base URL for Attrove services.
+ */
+export declare const DEFAULT_BASE_URL = "https://api.attrove.com";
+/**
+ * Default request timeout in milliseconds.
+ */
+export declare const DEFAULT_TIMEOUT = 30000;
+/**
+ * Default number of retry attempts for failed requests.
+ */
+export declare const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Initial delay for retry backoff in milliseconds.
+ */
+export declare const INITIAL_RETRY_DELAY = 1000;
+/**
+ * HTTP status codes that trigger automatic retries.
+ */
+export declare const RETRY_STATUS_CODES: readonly [408, 429, 500, 502, 503, 504];
+/**
+ * Set of retryable status codes for O(1) lookup.
+ */
+export declare const RETRYABLE_STATUS_SET: ReadonlySet<number>;
+/**
+ * WebSocket close code descriptions for better error messages.
+ */
+export declare const WS_CLOSE_CODES: Record<number, string>;
+/**
+ * Get a human-readable description for a WebSocket close code.
+ */
+export declare function getWsCloseReason(code: number): string;
+//# sourceMappingURL=constants.d.ts.map

package/types/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../packages/sdk/src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,kBAAkB,yCAA0C,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAA+B,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgBjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/types/src/errors/index.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Attrove SDK Error Classes
+ *
+ * Provides a structured error hierarchy for handling API errors.
+ * Each error type maps to specific HTTP status codes and error codes.
+ */
+import { ErrorCode, ApiError, AuthErrorCode, ValidationErrorCode, ErrorDetails } from '../types';
+/**
+ * Base error class for all Attrove SDK errors.
+ *
+ * All SDK errors extend this class, enabling consistent error handling
+ * across the SDK. Use the type guards (isAttroveError, isAuthenticationError, etc.)
+ * for type-safe error handling.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await attrove.query('...');
+ * } catch (error) {
+ *   if (isAttroveError(error)) {
+ *     console.log(`Error ${error.code}: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class AttroveError extends Error {
+    /**
+     * Machine-readable error code for programmatic handling.
+     */
+    readonly code: ErrorCode;
+    /**
+     * HTTP status code from the API response (if applicable).
+     */
+    readonly status?: number;
+    /**
+     * Additional error details for debugging and error handling.
+     * Contains structured information about what went wrong.
+     */
+    readonly details?: ErrorDetails;
+    constructor(message: string, code: ErrorCode, status?: number, details?: ErrorDetails);
+    /**
+     * Creates an AttroveError from an API error response.
+     *
+     * @param error - The error from the API (ApiError object or string)
+     * @param status - Optional HTTP status code
+     * @returns An AttroveError instance
+     */
+    static fromApiError(error: ApiError | string, status?: number): AttroveError;
+    /**
+     * Returns a formatted string representation of the error.
+     */
+    toString(): string;
+    /**
+     * Returns a JSON-serializable representation of the error.
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when authentication fails (401).
+ *
+ * Common causes:
+ * - Invalid API key
+ * - Expired token
+ * - Missing authentication header
+ *
+ * @throws {AuthenticationError}
+ */
+export declare class AuthenticationError extends AttroveError {
+    constructor(message: string, code?: AuthErrorCode, details?: ErrorDetails);
+}
+/**
+ * Error thrown when the user lacks permission for an action (403).
+ *
+ * Common causes:
+ * - Accessing another user's data
+ * - Insufficient permissions for the operation
+ * - Resource access denied
+ */
+export declare class AuthorizationError extends AttroveError {
+    constructor(message: string, code?: AuthErrorCode, details?: ErrorDetails);
+}
+/**
+ * Error thrown when a resource is not found (404).
+ *
+ * Common causes:
+ * - Invalid resource ID
+ * - Resource was deleted
+ * - User doesn't have access to the resource
+ */
+export declare class NotFoundError extends AttroveError {
+    constructor(message: string, details?: ErrorDetails);
+}
+/**
+ * Error thrown when request validation fails (400).
+ *
+ * Common causes:
+ * - Invalid request parameters
+ * - Missing required fields
+ * - Invalid data format
+ */
+export declare class ValidationError extends AttroveError {
+    constructor(message: string, code?: ValidationErrorCode, details?: ErrorDetails);
+}
+/**
+ * Error thrown when rate limits are exceeded (429).
+ *
+ * When this error is thrown, you should wait before retrying.
+ * Check the `retryAfter` property for the recommended wait time.
+ */
+export declare class RateLimitError extends AttroveError {
+    /**
+     * Time in seconds until the rate limit resets.
+     * May be undefined if the server didn't provide this information.
+     */
+    readonly retryAfter?: number;
+    constructor(message: string, retryAfter?: number, details?: ErrorDetails);
+}
+/**
+ * Error thrown when there's a network or connectivity issue.
+ *
+ * Common causes:
+ * - No internet connection
+ * - DNS resolution failure
+ * - Connection refused
+ * - SSL/TLS errors
+ */
+export declare class NetworkError extends AttroveError {
+    constructor(message: string, details?: ErrorDetails);
+}
+/**
+ * Error thrown when a request times out (408).
+ *
+ * The request took longer than the configured timeout.
+ * Consider increasing the timeout or retrying the request.
+ */
+export declare class TimeoutError extends AttroveError {
+    constructor(message?: string, details?: ErrorDetails);
+}
+/**
+ * Error thrown when there's a server-side issue (5xx).
+ *
+ * These errors are typically transient and may be resolved by retrying.
+ * The SDK automatically retries on 408, 429, 500, 502, 503, and 504 errors.
+ * See RETRY_STATUS_CODES in constants.ts for the authoritative list.
+ */
+export declare class ServerError extends AttroveError {
+    constructor(message: string, status?: number, details?: ErrorDetails);
+}
+/**
+ * Maps HTTP status codes to appropriate error classes.
+ *
+ * @param message - Error message
+ * @param status - HTTP status code
+ * @param code - Optional error code from the API
+ * @param details - Optional error details
+ * @returns An appropriate error instance for the status code
+ */
+export declare function createErrorFromStatus(message: string, status: number, code?: ErrorCode, details?: ErrorDetails): AttroveError;
+/**
+ * Type guard to check if an error is an AttroveError.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await attrove.query('...');
+ * } catch (error) {
+ *   if (isAttroveError(error)) {
+ *     console.log(`Error code: ${error.code}`);
+ *   }
+ * }
+ * ```
+ */
+export declare function isAttroveError(error: unknown): error is AttroveError;
+/**
+ * Type guard to check if an error is an AuthenticationError.
+ */
+export declare function isAuthenticationError(error: unknown): error is AuthenticationError;
+/**
+ * Type guard to check if an error is an AuthorizationError.
+ */
+export declare function isAuthorizationError(error: unknown): error is AuthorizationError;
+/**
+ * Type guard to check if an error is a NotFoundError.
+ */
+export declare function isNotFoundError(error: unknown): error is NotFoundError;
+/**
+ * Type guard to check if an error is a ValidationError.
+ */
+export declare function isValidationError(error: unknown): error is ValidationError;
+/**
+ * Type guard to check if an error is a RateLimitError.
+ */
+export declare function isRateLimitError(error: unknown): error is RateLimitError;
+/**
+ * Type guard to check if an error is a NetworkError.
+ */
+export declare function isNetworkError(error: unknown): error is NetworkError;
+/**
+ * Type guard to check if an error is a TimeoutError.
+ */
+export declare function isTimeoutError(error: unknown): error is TimeoutError;
+/**
+ * Type guard to check if an error is a ServerError.
+ */
+export declare function isServerError(error: unknown): error is ServerError;
+//# sourceMappingURL=index.d.ts.map

package/types/src/errors/index.d.ts.map

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

package/types/src/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @attrove/sdk
+ *
+ * Official TypeScript SDK for the Attrove API.
+ *
+ * @example
+ * ```ts
+ * import { Attrove } from '@attrove/sdk';
+ *
+ * // Create a client for end-user operations
+ * const attrove = new Attrove({
+ *   apiKey: 'sk_...',
+ *   userId: 'user-uuid'
+ * });
+ *
+ * // Query user's context
+ * const response = await attrove.query('What meetings do I have tomorrow?');
+ * console.log(response.answer);
+ *
+ * // Create an admin client for server-to-server operations
+ * const admin = Attrove.admin({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret'
+ * });
+ *
+ * // Create a user
+ * const { id, apiKey } = await admin.users.create({
+ *   email: 'user@example.com'
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { Attrove as AttroveClient } from './client';
+import { AttroveAdmin } from './admin-client';
+import { AttroveAdminConfig } from './types';
+export declare class Attrove extends AttroveClient {
+    /**
+     * Create an admin client for server-to-server operations.
+     *
+     * @param config - Admin client configuration
+     * @returns Admin client instance
+     *
+     * @example
+     * ```ts
+     * const admin = Attrove.admin({
+     *   clientId: 'your-client-id',
+     *   clientSecret: 'your-client-secret'
+     * });
+     * ```
+     */
+    static admin(config: AttroveAdminConfig): AttroveAdmin;
+}
+export { AttroveAdmin } from './admin-client';
+export type { AdminUsersResource } from './admin-client';
+export * from './types';
+export { AttroveError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, RateLimitError, NetworkError, TimeoutError, ServerError, isAttroveError, isAuthenticationError, isAuthorizationError, isNotFoundError, isValidationError, isRateLimitError, isNetworkError, isTimeoutError, isServerError, } from './errors';
+export type { UserWithIntegrations, UpdateUserOptions, } from './resources/users';
+export type { MessagesPage } from './resources/messages';
+export type { ConversationsPage, ConversationSyncUpdate, } from './resources/conversations';
+export { generateMessageId } from './utils/streaming';
+export type { StreamOptions, StreamResult } from './utils/streaming';
+export { SDK_VERSION, DEFAULT_BASE_URL, DEFAULT_TIMEOUT, DEFAULT_MAX_RETRIES, } from './constants';
+export { getVersion } from './version';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/sdk/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG7C,qBAAa,OAAQ,SAAQ,aAAa;IACxC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY;CAGvD;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,81 @@
+/**
+ * Conversations Resource
+ *
+ * Provides methods for accessing and managing conversations (channels, threads, etc.).
+ */
+import { HttpClient } from '../utils/fetch';
+import { Conversation, Pagination, ListConversationsOptions } from '../types';
+/**
+ * Paginated conversations response.
+ */
+export interface ConversationsPage {
+    data: Conversation[];
+    pagination: Pagination;
+}
+/**
+ * Conversation sync settings update.
+ */
+export interface ConversationSyncUpdate {
+    id: string;
+    importMessages: boolean;
+}
+/**
+ * Conversations resource for accessing conversation data.
+ *
+ * Provides methods for listing conversations and managing sync settings.
+ */
+export declare class ConversationsResource {
+    private readonly http;
+    private readonly userId;
+    constructor(http: HttpClient, userId: string);
+    /**
+     * List conversations with optional filtering.
+     *
+     * @param options - Filtering and pagination options
+     * @returns Paginated list of conversations
+     *
+     * @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 all conversations
+     * const { data, pagination } = await attrove.conversations.list();
+     *
+     * // List only synced conversations
+     * const { data } = await attrove.conversations.list({ syncedOnly: true });
+     *
+     * // Filter by integration
+     * const { data } = await attrove.conversations.list({
+     *   integrationIds: ['550e8400-e29b-41d4-a716-446655440000']
+     * });
+     * ```
+     */
+    list(options?: ListConversationsOptions): Promise<ConversationsPage>;
+    /**
+     * Update sync settings for multiple conversations.
+     *
+     * @param updates - Array of conversation sync updates
+     * @returns Count of updated conversations
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ValidationError} If the updates are invalid
+     * @throws {NotFoundError} If any conversation does not exist
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * // Enable syncing for specific conversations
+     * const { updated } = await attrove.conversations.updateSync([
+     *   { id: '550e8400-e29b-41d4-a716-446655440000', importMessages: true },
+     *   { id: '550e8400-e29b-41d4-a716-446655440001', importMessages: false }
+     * ]);
+     * console.log(`Updated ${updated} conversations`);
+     * ```
+     */
+    updateSync(updates: ConversationSyncUpdate[]): Promise<{
+        updated: number;
+    }>;
+}
+//# sourceMappingURL=conversations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/conversations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAqB,UAAU,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM;IAGjC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,IAAI,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4B9E;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,UAAU,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAalF"}

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

@@ -0,0 +1,12 @@
+/**
+ * Resource exports
+ */
+export { UsersResource } from './users';
+export type { UserWithIntegrations, UpdateUserOptions } from './users';
+export { MessagesResource } from './messages';
+export type { MessagesPage } from './messages';
+export { ConversationsResource } from './conversations';
+export type { ConversationsPage, ConversationSyncUpdate } from './conversations';
+export { IntegrationsResource } from './integrations';
+export { QueryResource } from './query';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}