@attrove/sdk 0.1.2 → 0.1.4

package/cjs/src/errors/index.js

@@ -0,0 +1,307 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isServerError = exports.isTimeoutError = exports.isNetworkError = exports.isRateLimitError = exports.isValidationError = exports.isNotFoundError = exports.isAuthorizationError = exports.isAuthenticationError = exports.isAttroveError = exports.createErrorFromStatus = exports.ServerError = exports.TimeoutError = exports.NetworkError = exports.RateLimitError = exports.ValidationError = exports.NotFoundError = exports.AuthorizationError = exports.AuthenticationError = exports.AttroveError = void 0;
+const types_1 = require("../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}`);
+ *   }
+ * }
+ * ```
+ */
+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, types_1.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,
+        };
+    }
+}
+exports.AttroveError = AttroveError;
+/**
+ * Error thrown when authentication fails (401).
+ *
+ * Common causes:
+ * - Invalid API key
+ * - Expired token
+ * - Missing authentication header
+ *
+ * @throws {AuthenticationError}
+ */
+class AuthenticationError extends AttroveError {
+    constructor(message, code = types_1.ErrorCodes.AUTH_INVALID_TOKEN, details) {
+        super(message, code, 401, details);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = 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
+ */
+class AuthorizationError extends AttroveError {
+    constructor(message, code = types_1.ErrorCodes.AUTH_INSUFFICIENT_PERMISSIONS, details) {
+        super(message, code, 403, details);
+        this.name = 'AuthorizationError';
+    }
+}
+exports.AuthorizationError = 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
+ */
+class NotFoundError extends AttroveError {
+    constructor(message, details) {
+        super(message, types_1.ErrorCodes.RESOURCE_NOT_FOUND, 404, details);
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * Error thrown when request validation fails (400).
+ *
+ * Common causes:
+ * - Invalid request parameters
+ * - Missing required fields
+ * - Invalid data format
+ */
+class ValidationError extends AttroveError {
+    constructor(message, code = types_1.ErrorCodes.VALIDATION_INVALID_FORMAT, details) {
+        super(message, code, 400, details);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = 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.
+ */
+class RateLimitError extends AttroveError {
+    constructor(message, retryAfter, details) {
+        super(message, types_1.ErrorCodes.RATE_LIMIT_EXCEEDED, 429, details);
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+exports.RateLimitError = RateLimitError;
+/**
+ * Error thrown when there's a network or connectivity issue.
+ *
+ * Common causes:
+ * - No internet connection
+ * - DNS resolution failure
+ * - Connection refused
+ * - SSL/TLS errors
+ */
+class NetworkError extends AttroveError {
+    constructor(message, details) {
+        super(message, types_1.ErrorCodes.SERVICE_UNAVAILABLE, undefined, details);
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = 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.
+ */
+class TimeoutError extends AttroveError {
+    constructor(message = 'Request timed out', details) {
+        super(message, types_1.ErrorCodes.SERVICE_UNAVAILABLE, 408, details);
+        this.name = 'TimeoutError';
+    }
+}
+exports.TimeoutError = 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.
+ */
+class ServerError extends AttroveError {
+    constructor(message, status = 500, details) {
+        super(message, types_1.ErrorCodes.INTERNAL_ERROR, status, details);
+        this.name = 'ServerError';
+    }
+}
+exports.ServerError = 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
+ */
+function createErrorFromStatus(message, status, code, details) {
+    switch (status) {
+        case 400:
+            return new ValidationError(message, code || types_1.ErrorCodes.VALIDATION_INVALID_FORMAT, details);
+        case 401:
+            return new AuthenticationError(message, code || types_1.ErrorCodes.AUTH_INVALID_TOKEN, details);
+        case 403:
+            return new AuthorizationError(message, code || types_1.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 || types_1.ErrorCodes.INTERNAL_ERROR, status, details);
+    }
+}
+exports.createErrorFromStatus = createErrorFromStatus;
+// =============================================================================
+// 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}`);
+ *   }
+ * }
+ * ```
+ */
+function isAttroveError(error) {
+    return error instanceof AttroveError;
+}
+exports.isAttroveError = isAttroveError;
+/**
+ * Type guard to check if an error is an AuthenticationError.
+ */
+function isAuthenticationError(error) {
+    return error instanceof AuthenticationError;
+}
+exports.isAuthenticationError = isAuthenticationError;
+/**
+ * Type guard to check if an error is an AuthorizationError.
+ */
+function isAuthorizationError(error) {
+    return error instanceof AuthorizationError;
+}
+exports.isAuthorizationError = isAuthorizationError;
+/**
+ * Type guard to check if an error is a NotFoundError.
+ */
+function isNotFoundError(error) {
+    return error instanceof NotFoundError;
+}
+exports.isNotFoundError = isNotFoundError;
+/**
+ * Type guard to check if an error is a ValidationError.
+ */
+function isValidationError(error) {
+    return error instanceof ValidationError;
+}
+exports.isValidationError = isValidationError;
+/**
+ * Type guard to check if an error is a RateLimitError.
+ */
+function isRateLimitError(error) {
+    return error instanceof RateLimitError;
+}
+exports.isRateLimitError = isRateLimitError;
+/**
+ * Type guard to check if an error is a NetworkError.
+ */
+function isNetworkError(error) {
+    return error instanceof NetworkError;
+}
+exports.isNetworkError = isNetworkError;
+/**
+ * Type guard to check if an error is a TimeoutError.
+ */
+function isTimeoutError(error) {
+    return error instanceof TimeoutError;
+}
+exports.isTimeoutError = isTimeoutError;
+/**
+ * Type guard to check if an error is a ServerError.
+ */
+function isServerError(error) {
+    return error instanceof ServerError;
+}
+exports.isServerError = isServerError;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/sdk/src/errors/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,oCAA6G;AAE7G;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,YAAa,SAAQ,KAAK;IAiBrC,YAAY,OAAe,EAAE,IAAe,EAAE,MAAe,EAAE,OAAsB;QACnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,qFAAqF;QACrF,MAAM,gBAAgB,GAAG,KAExB,CAAC;QACF,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,CAAC;YACvC,gBAAgB,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,KAAwB,EAAE,MAAe;QAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,YAAY,CAAC,KAAK,EAAE,kBAAU,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACM,QAAQ;QACf,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AArED,oCAqEC;AAED;;;;;;;;;GASG;AACH,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YACE,OAAe,EACf,OAAsB,kBAAU,CAAC,kBAAkB,EACnD,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AATD,kDASC;AAED;;;;;;;GAOG;AACH,MAAa,kBAAmB,SAAQ,YAAY;IAClD,YACE,OAAe,EACf,OAAsB,kBAAU,CAAC,6BAA6B,EAC9D,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AATD,gDASC;AAED;;;;;;;GAOG;AACH,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,kBAAU,CAAC,kBAAkB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;;;;;;GAOG;AACH,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YACE,OAAe,EACf,OAA4B,kBAAU,CAAC,yBAAyB,EAChE,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AATD,0CASC;AAED;;;;;GAKG;AACH,MAAa,cAAe,SAAQ,YAAY;IAO9C,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAsB;QACtE,KAAK,CAAC,OAAO,EAAE,kBAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAZD,wCAYC;AAED;;;;;;;;GAQG;AACH,MAAa,YAAa,SAAQ,YAAY;IAC5C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,kBAAU,CAAC,mBAAmB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED;;;;;GAKG;AACH,MAAa,YAAa,SAAQ,YAAY;IAC5C,YAAY,UAAkB,mBAAmB,EAAE,OAAsB;QACvE,KAAK,CAAC,OAAO,EAAE,kBAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED;;;;;;GAMG;AACH,MAAa,WAAY,SAAQ,YAAY;IAC3C,YAAY,OAAe,EAAE,SAAiB,GAAG,EAAE,OAAsB;QACvE,KAAK,CAAC,OAAO,EAAE,kBAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AALD,kCAKC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CACnC,OAAe,EACf,MAAc,EACd,IAAgB,EAChB,OAAsB;IAEtB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,IAAI,eAAe,CACxB,OAAO,EACN,IAA4B,IAAI,kBAAU,CAAC,yBAAyB,EACrE,OAAO,CACR,CAAC;QACJ,KAAK,GAAG;YACN,OAAO,IAAI,mBAAmB,CAC5B,OAAO,EACN,IAAsB,IAAI,kBAAU,CAAC,kBAAkB,EACxD,OAAO,CACR,CAAC;QACJ,KAAK,GAAG;YACN,OAAO,IAAI,kBAAkB,CAC3B,OAAO,EACN,IAAsB,IAAI,kBAAU,CAAC,6BAA6B,EACnE,OAAO,CACR,CAAC;QACJ,KAAK,GAAG;YACN,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,KAAK,GAAG;YACN,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,KAAK,GAAG;YACN,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACzD;YACE,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAClB,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,IAAI,kBAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AArCD,sDAqCC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;;;;;;;;;GAaG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAFD,wCAEC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,KAAc;IAClD,OAAO,KAAK,YAAY,mBAAmB,CAAC;AAC9C,CAAC;AAFD,sDAEC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,kBAAkB,CAAC;AAC7C,CAAC;AAFD,oDAEC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC;AAFD,0CAEC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,eAAe,CAAC;AAC1C,CAAC;AAFD,8CAEC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAFD,4CAEC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAFD,wCAEC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAFD,wCAEC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAFD,sCAEC"}

package/cjs/src/index.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersion = exports.DEFAULT_MAX_RETRIES = exports.DEFAULT_TIMEOUT = exports.DEFAULT_BASE_URL = exports.SDK_VERSION = exports.generateMessageId = exports.isServerError = exports.isTimeoutError = exports.isNetworkError = exports.isRateLimitError = exports.isValidationError = exports.isNotFoundError = exports.isAuthorizationError = exports.isAuthenticationError = exports.isAttroveError = exports.ServerError = exports.TimeoutError = exports.NetworkError = exports.RateLimitError = exports.ValidationError = exports.NotFoundError = exports.AuthorizationError = exports.AuthenticationError = exports.AttroveError = exports.AttroveAdmin = exports.Attrove = void 0;
+const tslib_1 = require("tslib");
+const client_1 = require("./client");
+const admin_client_1 = require("./admin-client");
+// Re-export the client class with the static admin method
+class Attrove extends client_1.Attrove {
+    /**
+     * 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 admin_client_1.AttroveAdmin(config);
+    }
+}
+exports.Attrove = Attrove;
+// Export the admin client class
+var admin_client_2 = require("./admin-client");
+Object.defineProperty(exports, "AttroveAdmin", { enumerable: true, get: function () { return admin_client_2.AttroveAdmin; } });
+// Export all types
+tslib_1.__exportStar(require("./types"), exports);
+// Export errors
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "AttroveError", { enumerable: true, get: function () { return errors_1.AttroveError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
+Object.defineProperty(exports, "AuthorizationError", { enumerable: true, get: function () { return errors_1.AuthorizationError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+Object.defineProperty(exports, "ServerError", { enumerable: true, get: function () { return errors_1.ServerError; } });
+Object.defineProperty(exports, "isAttroveError", { enumerable: true, get: function () { return errors_1.isAttroveError; } });
+Object.defineProperty(exports, "isAuthenticationError", { enumerable: true, get: function () { return errors_1.isAuthenticationError; } });
+Object.defineProperty(exports, "isAuthorizationError", { enumerable: true, get: function () { return errors_1.isAuthorizationError; } });
+Object.defineProperty(exports, "isNotFoundError", { enumerable: true, get: function () { return errors_1.isNotFoundError; } });
+Object.defineProperty(exports, "isValidationError", { enumerable: true, get: function () { return errors_1.isValidationError; } });
+Object.defineProperty(exports, "isRateLimitError", { enumerable: true, get: function () { return errors_1.isRateLimitError; } });
+Object.defineProperty(exports, "isNetworkError", { enumerable: true, get: function () { return errors_1.isNetworkError; } });
+Object.defineProperty(exports, "isTimeoutError", { enumerable: true, get: function () { return errors_1.isTimeoutError; } });
+Object.defineProperty(exports, "isServerError", { enumerable: true, get: function () { return errors_1.isServerError; } });
+// Export streaming utilities
+var streaming_1 = require("./utils/streaming");
+Object.defineProperty(exports, "generateMessageId", { enumerable: true, get: function () { return streaming_1.generateMessageId; } });
+// Export constants for advanced usage
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return constants_1.SDK_VERSION; } });
+Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return constants_1.DEFAULT_BASE_URL; } });
+Object.defineProperty(exports, "DEFAULT_TIMEOUT", { enumerable: true, get: function () { return constants_1.DEFAULT_TIMEOUT; } });
+Object.defineProperty(exports, "DEFAULT_MAX_RETRIES", { enumerable: true, get: function () { return constants_1.DEFAULT_MAX_RETRIES; } });
+// Export version utility for programmatic access
+var version_1 = require("./version");
+Object.defineProperty(exports, "getVersion", { enumerable: true, get: function () { return version_1.getVersion; } });
+//# sourceMappingURL=index.js.map

package/cjs/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/sdk/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;;;AAEH,qCAAoD;AACpD,iDAAkE;AAGlE,0DAA0D;AAC1D,MAAa,OAAQ,SAAQ,gBAAa;IACxC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,MAA0B;QACrC,OAAO,IAAI,2BAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AAlBD,0BAkBC;AAED,gCAAgC;AAChC,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,mBAAmB;AACnB,kDAAwB;AAExB,gBAAgB;AAChB,mCAmBkB;AAlBhB,sGAAA,YAAY,OAAA;AACZ,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAClB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,wGAAA,cAAc,OAAA;AACd,sGAAA,YAAY,OAAA;AACZ,sGAAA,YAAY,OAAA;AACZ,qGAAA,WAAW,OAAA;AACX,wGAAA,cAAc,OAAA;AACd,+GAAA,qBAAqB,OAAA;AACrB,8GAAA,oBAAoB,OAAA;AACpB,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AACjB,0GAAA,gBAAgB,OAAA;AAChB,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AACd,uGAAA,aAAa,OAAA;AAcf,6BAA6B;AAC7B,+CAAsD;AAA7C,8GAAA,iBAAiB,OAAA;AAG1B,sCAAsC;AACtC,yCAKqB;AAJnB,wGAAA,WAAW,OAAA;AACX,6GAAA,gBAAgB,OAAA;AAChB,4GAAA,eAAe,OAAA;AACf,gHAAA,mBAAmB,OAAA;AAGrB,iDAAiD;AACjD,qCAAuC;AAA9B,qGAAA,UAAU,OAAA"}

package/cjs/src/resources/conversations.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Conversations Resource
+ *
+ * Provides methods for accessing and managing conversations (channels, threads, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationsResource = void 0;
+/**
+ * Conversations resource for accessing conversation data.
+ *
+ * Provides methods for listing conversations and managing sync settings.
+ */
+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);
+    }
+}
+exports.ConversationsResource = ConversationsResource;
+//# sourceMappingURL=conversations.js.map

package/cjs/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,MAAa,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;AA5FD,sDA4FC"}

package/cjs/src/resources/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Resource exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryResource = exports.IntegrationsResource = exports.ConversationsResource = exports.MessagesResource = exports.UsersResource = void 0;
+var users_1 = require("./users");
+Object.defineProperty(exports, "UsersResource", { enumerable: true, get: function () { return users_1.UsersResource; } });
+var messages_1 = require("./messages");
+Object.defineProperty(exports, "MessagesResource", { enumerable: true, get: function () { return messages_1.MessagesResource; } });
+var conversations_1 = require("./conversations");
+Object.defineProperty(exports, "ConversationsResource", { enumerable: true, get: function () { return conversations_1.ConversationsResource; } });
+var integrations_1 = require("./integrations");
+Object.defineProperty(exports, "IntegrationsResource", { enumerable: true, get: function () { return integrations_1.IntegrationsResource; } });
+var query_1 = require("./query");
+Object.defineProperty(exports, "QueryResource", { enumerable: true, get: function () { return query_1.QueryResource; } });
+//# sourceMappingURL=index.js.map

package/cjs/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,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AAGtB,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA;AAGzB,iDAAwD;AAA/C,sHAAA,qBAAqB,OAAA;AAG9B,+CAAsD;AAA7C,oHAAA,oBAAoB,OAAA;AAE7B,iCAAwC;AAA/B,sGAAA,aAAa,OAAA"}

package/cjs/src/resources/integrations.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Integrations Resource
+ *
+ * Provides methods for managing connected integrations (Gmail, Slack, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationsResource = void 0;
+/**
+ * Integrations resource for managing connected services.
+ *
+ * Provides methods for listing and disconnecting integrations
+ * (Gmail, Slack, Google Calendar, etc.).
+ */
+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}`);
+    }
+}
+exports.IntegrationsResource = IntegrationsResource;
+//# sourceMappingURL=integrations.js.map

package/cjs/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,MAAa,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;AA1DD,oDA0DC"}