@attrove/sdk 0.1.3 → 0.1.4

package/esm/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../packages/sdk/src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAC;AAE1E;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAErF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,6CAA6C;IACnD,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,uBAAuB;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC;AACxD,CAAC"}

package/esm/src/errors/index.js

@@ -0,0 +1,285 @@
+/**
+ * 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 { ErrorCodes } 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 class AttroveError extends Error {
+    constructor(message, code, status, details) {
+        super(message);
+        this.name = 'AttroveError';
+        this.code = code;
+        this.status = status;
+        this.details = details;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        const ErrorWithCapture = Error;
+        if (ErrorWithCapture.captureStackTrace) {
+            ErrorWithCapture.captureStackTrace(this, AttroveError);
+        }
+    }
+    /**
+     * 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, status) {
+        if (typeof error === 'string') {
+            return new AttroveError(error, ErrorCodes.INTERNAL_ERROR, status);
+        }
+        return new AttroveError(error.message, error.code, status, error.details);
+    }
+    /**
+     * Returns a formatted string representation of the error.
+     */
+    toString() {
+        const parts = [`${this.name}: ${this.message}`];
+        if (this.code)
+            parts.push(`Code: ${this.code}`);
+        if (this.status)
+            parts.push(`Status: ${this.status}`);
+        return parts.join(' | ');
+    }
+    /**
+     * Returns a JSON-serializable representation of the error.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            status: this.status,
+            details: this.details,
+        };
+    }
+}
+/**
+ * Error thrown when authentication fails (401).
+ *
+ * Common causes:
+ * - Invalid API key
+ * - Expired token
+ * - Missing authentication header
+ *
+ * @throws {AuthenticationError}
+ */
+export class AuthenticationError extends AttroveError {
+    constructor(message, code = ErrorCodes.AUTH_INVALID_TOKEN, details) {
+        super(message, code, 401, details);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * 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 class AuthorizationError extends AttroveError {
+    constructor(message, code = ErrorCodes.AUTH_INSUFFICIENT_PERMISSIONS, details) {
+        super(message, code, 403, details);
+        this.name = 'AuthorizationError';
+    }
+}
+/**
+ * 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 class NotFoundError extends AttroveError {
+    constructor(message, details) {
+        super(message, ErrorCodes.RESOURCE_NOT_FOUND, 404, details);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Error thrown when request validation fails (400).
+ *
+ * Common causes:
+ * - Invalid request parameters
+ * - Missing required fields
+ * - Invalid data format
+ */
+export class ValidationError extends AttroveError {
+    constructor(message, code = ErrorCodes.VALIDATION_INVALID_FORMAT, details) {
+        super(message, code, 400, details);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * 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 class RateLimitError extends AttroveError {
+    constructor(message, retryAfter, details) {
+        super(message, ErrorCodes.RATE_LIMIT_EXCEEDED, 429, details);
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Error thrown when there's a network or connectivity issue.
+ *
+ * Common causes:
+ * - No internet connection
+ * - DNS resolution failure
+ * - Connection refused
+ * - SSL/TLS errors
+ */
+export class NetworkError extends AttroveError {
+    constructor(message, details) {
+        super(message, ErrorCodes.SERVICE_UNAVAILABLE, undefined, details);
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * 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 class TimeoutError extends AttroveError {
+    constructor(message = 'Request timed out', details) {
+        super(message, ErrorCodes.SERVICE_UNAVAILABLE, 408, details);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * 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 class ServerError extends AttroveError {
+    constructor(message, status = 500, details) {
+        super(message, ErrorCodes.INTERNAL_ERROR, status, details);
+        this.name = 'ServerError';
+    }
+}
+/**
+ * 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 function createErrorFromStatus(message, status, code, details) {
+    switch (status) {
+        case 400:
+            return new ValidationError(message, code || ErrorCodes.VALIDATION_INVALID_FORMAT, details);
+        case 401:
+            return new AuthenticationError(message, code || ErrorCodes.AUTH_INVALID_TOKEN, details);
+        case 403:
+            return new AuthorizationError(message, code || ErrorCodes.AUTH_INSUFFICIENT_PERMISSIONS, details);
+        case 404:
+            return new NotFoundError(message, details);
+        case 408:
+            return new TimeoutError(message, details);
+        case 429:
+            return new RateLimitError(message, undefined, details);
+        default:
+            if (status >= 500) {
+                return new ServerError(message, status, details);
+            }
+            return new AttroveError(message, code || ErrorCodes.INTERNAL_ERROR, status, details);
+    }
+}
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * 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 function isAttroveError(error) {
+    return error instanceof AttroveError;
+}
+/**
+ * Type guard to check if an error is an AuthenticationError.
+ */
+export function isAuthenticationError(error) {
+    return error instanceof AuthenticationError;
+}
+/**
+ * Type guard to check if an error is an AuthorizationError.
+ */
+export function isAuthorizationError(error) {
+    return error instanceof AuthorizationError;
+}
+/**
+ * Type guard to check if an error is a NotFoundError.
+ */
+export function isNotFoundError(error) {
+    return error instanceof NotFoundError;
+}
+/**
+ * Type guard to check if an error is a ValidationError.
+ */
+export function isValidationError(error) {
+    return error instanceof ValidationError;
+}
+/**
+ * Type guard to check if an error is a RateLimitError.
+ */
+export function isRateLimitError(error) {
+    return error instanceof RateLimitError;
+}
+/**
+ * Type guard to check if an error is a NetworkError.
+ */
+export function isNetworkError(error) {
+    return error instanceof NetworkError;
+}
+/**
+ * Type guard to check if an error is a TimeoutError.
+ */
+export function isTimeoutError(error) {
+    return error instanceof TimeoutError;
+}
+/**
+ * Type guard to check if an error is a ServerError.
+ */
+export function isServerError(error) {
+    return error instanceof ServerError;
+}
+//# sourceMappingURL=index.js.map

package/esm/src/errors/index.js.map

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

package/esm/src/index.js

@@ -0,0 +1,68 @@
+/**
+ * @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';
+// Re-export the client class with the static admin method
+export 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) {
+        return new AttroveAdmin(config);
+    }
+}
+// Export the admin client class
+export { AttroveAdmin } from './admin-client';
+// Export all types
+export * from './types';
+// Export errors
+export { AttroveError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, RateLimitError, NetworkError, TimeoutError, ServerError, isAttroveError, isAuthenticationError, isAuthorizationError, isNotFoundError, isValidationError, isRateLimitError, isNetworkError, isTimeoutError, isServerError, } from './errors';
+// Export streaming utilities
+export { generateMessageId } from './utils/streaming';
+// Export constants for advanced usage
+export { SDK_VERSION, DEFAULT_BASE_URL, DEFAULT_TIMEOUT, DEFAULT_MAX_RETRIES, } from './constants';
+// Export version utility for programmatic access
+export { getVersion } from './version';
+//# sourceMappingURL=index.js.map

package/esm/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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;AAGlE,0DAA0D;AAC1D,MAAM,OAAO,OAAQ,SAAQ,aAAa;IACxC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,MAA0B;QACrC,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AAED,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,mBAAmB;AACnB,cAAc,SAAS,CAAC;AAExB,gBAAgB;AAChB,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;AAalB,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,sCAAsC;AACtC,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,iDAAiD;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/esm/src/resources/conversations.js

@@ -0,0 +1,91 @@
+/**
+ * Conversations Resource
+ *
+ * Provides methods for accessing and managing conversations (channels, threads, etc.).
+ */
+/**
+ * Conversations resource for accessing conversation data.
+ *
+ * Provides methods for listing conversations and managing sync settings.
+ */
+export class ConversationsResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * 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']
+     * });
+     * ```
+     */
+    async list(options = {}) {
+        const params = {};
+        if (options.integrationIds?.length) {
+            params.integration_ids = options.integrationIds;
+        }
+        if (options.syncedOnly !== undefined) {
+            params.synced_only = String(options.syncedOnly);
+        }
+        if (options.limit !== undefined) {
+            params.limit = String(options.limit);
+        }
+        if (options.offset !== undefined) {
+            params.offset = String(options.offset);
+        }
+        const response = await this.http.request(`/v1/users/${this.userId}/conversations`, { method: 'GET' }, params);
+        return {
+            data: response.data,
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * 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`);
+     * ```
+     */
+    async updateSync(updates) {
+        const body = {
+            conversations: updates.map((u) => ({
+                id: u.id,
+                import_messages: u.importMessages,
+            })),
+        };
+        return this.http.patch(`/v1/users/${this.userId}/conversations`, body);
+    }
+}
+//# sourceMappingURL=conversations.js.map

package/esm/src/resources/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/conversations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IAChC,YACmB,IAAgB,EAChB,MAAc;QADd,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,IAAI,CAAC,UAAoC,EAAE;QAC/C,MAAM,MAAM,GAAkD,EAAE,CAAC;QAEjE,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;YACnC,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;QAClD,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACtC,aAAa,IAAI,CAAC,MAAM,gBAAgB,EACxC,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,MAAM,CACP,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,UAAU,CAAC,OAAiC;QAChD,MAAM,IAAI,GAAG;YACX,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,eAAe,EAAE,CAAC,CAAC,cAAc;aAClC,CAAC,CAAC;SACJ,CAAC;QAEF,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CACpB,aAAa,IAAI,CAAC,MAAM,gBAAgB,EACxC,IAAI,CACL,CAAC;IACJ,CAAC;CACF"}

package/esm/src/resources/index.js

@@ -0,0 +1,9 @@
+/**
+ * Resource exports
+ */
+export { UsersResource } from './users';
+export { MessagesResource } from './messages';
+export { ConversationsResource } from './conversations';
+export { IntegrationsResource } from './integrations';
+export { QueryResource } from './query';
+//# sourceMappingURL=index.js.map

package/esm/src/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/esm/src/resources/integrations.js

@@ -0,0 +1,65 @@
+/**
+ * Integrations Resource
+ *
+ * Provides methods for managing connected integrations (Gmail, Slack, etc.).
+ */
+/**
+ * Integrations resource for managing connected services.
+ *
+ * Provides methods for listing and disconnecting integrations
+ * (Gmail, Slack, Google Calendar, etc.).
+ */
+export class IntegrationsResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * 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}`));
+     * ```
+     */
+    async list() {
+        const response = await this.http.get(`/v1/users/${this.userId}`);
+        return response.integrations;
+    }
+    /**
+     * 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');
+     * ```
+     */
+    async disconnect(id) {
+        return this.http.delete(`/v1/users/${this.userId}/integrations/${id}`);
+    }
+}
+//# sourceMappingURL=integrations.js.map

package/esm/src/resources/integrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/integrations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAC/B,YACmB,IAAgB,EAChB,MAAc;QADd,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAClC,aAAa,IAAI,CAAC,MAAM,EAAE,CAC3B,CAAC;QACF,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CACrB,aAAa,IAAI,CAAC,MAAM,iBAAiB,EAAE,EAAE,CAC9C,CAAC;IACJ,CAAC;CACF"}

package/esm/src/resources/messages.js

@@ -0,0 +1,94 @@
+/**
+ * Messages Resource
+ *
+ * Provides methods for accessing messages from connected integrations.
+ */
+/**
+ * Messages resource for accessing message data.
+ *
+ * Provides methods for listing and retrieving messages from
+ * connected integrations (Gmail, Slack, etc.).
+ */
+export class MessagesResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * 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']
+     * });
+     * ```
+     */
+    async list(options = {}) {
+        const params = {};
+        if (options.ids?.length) {
+            params.ids = options.ids.join(',');
+        }
+        if (options.integrationId) {
+            params.integration_id = options.integrationId;
+        }
+        if (options.conversationId) {
+            params.conversation_id = options.conversationId;
+        }
+        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}/messages`, { method: 'GET' }, params);
+        return {
+            data: response.data,
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * 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);
+     * ```
+     */
+    async get(id) {
+        return this.http.get(`/v1/users/${this.userId}/messages/${id}`);
+    }
+}
+//# sourceMappingURL=messages.js.map

package/esm/src/resources/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAC3B,YACmB,IAAgB,EAChB,MAAc;QADd,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,IAAI,CAAC,UAA+B,EAAE;QAC1C,MAAM,MAAM,GAAuC,EAAE,CAAC;QAEtD,IAAI,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;QAChD,CAAC;QACD,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;QAClD,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACxC,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QACpC,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACtC,aAAa,IAAI,CAAC,MAAM,WAAW,EACnC,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,MAAM,CACP,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAU,aAAa,IAAI,CAAC,MAAM,aAAa,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;CACF"}