@attrove/sdk 0.1.2 → 0.1.4

package/cjs/src/resources/messages.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Messages Resource
+ *
+ * Provides methods for accessing messages from connected integrations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagesResource = void 0;
+/**
+ * Messages resource for accessing message data.
+ *
+ * Provides methods for listing and retrieving messages from
+ * connected integrations (Gmail, Slack, etc.).
+ */
+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}`);
+    }
+}
+exports.MessagesResource = MessagesResource;
+//# sourceMappingURL=messages.js.map

package/cjs/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,MAAa,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;AA1FD,4CA0FC"}

package/cjs/src/resources/query.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Query Resource
+ *
+ * Provides methods for RAG (Retrieval-Augmented Generation) queries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryResource = void 0;
+/**
+ * Query resource for RAG operations.
+ *
+ * Provides methods for AI-powered queries and semantic search
+ * across the user's unified context.
+ */
+class QueryResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * 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
+     * });
+     * ```
+     */
+    async query(prompt, options = {}) {
+        const body = {
+            query: prompt,
+            client_timezone: options.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone,
+        };
+        if (options.history?.length) {
+            body.history = options.history;
+        }
+        if (options.integrationIds?.length) {
+            body.integration_ids = options.integrationIds;
+        }
+        if (options.conversationIds?.length) {
+            body.conversation_ids = options.conversationIds;
+        }
+        if (options.allowBotMessages !== undefined) {
+            body.allow_bot_messages = options.allowBotMessages;
+        }
+        if (options.includeSources) {
+            body.expand = 'sources';
+        }
+        const response = await this.http.post(`/v1/users/${this.userId}/ai/query`, body);
+        return {
+            answer: response.answer,
+            history: response.history,
+            used_message_ids: response.used_message_ids,
+            sources: response.sources,
+        };
+    }
+    /**
+     * 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
+     * });
+     * ```
+     */
+    async search(query, options = {}) {
+        const body = { query };
+        if (options.integrationIds?.length) {
+            body.integration_ids = options.integrationIds;
+        }
+        if (options.conversationIds?.length) {
+            body.conversation_ids = options.conversationIds;
+        }
+        if (options.afterDate) {
+            body.after_date = options.afterDate;
+        }
+        if (options.beforeDate) {
+            body.before_date = options.beforeDate;
+        }
+        if (options.allowBotMessages !== undefined) {
+            body.allow_bot_messages = options.allowBotMessages;
+        }
+        if (options.senderDomains?.length) {
+            body.sender_domains = options.senderDomains;
+        }
+        if (options.entityIds?.length) {
+            body.entity_ids = options.entityIds;
+        }
+        if (options.includeBodyText) {
+            body.expand = 'body_text';
+        }
+        return this.http.post(`/v1/users/${this.userId}/ai/search`, body);
+    }
+}
+exports.QueryResource = QueryResource;
+//# sourceMappingURL=query.js.map

package/cjs/src/resources/query.js.map

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

package/cjs/src/resources/users.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Users Resource
+ *
+ * Provides methods for accessing user data and sync statistics.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsersResource = void 0;
+/**
+ * Users resource for accessing user data.
+ *
+ * Provides methods for retrieving user profiles, updating settings,
+ * and accessing sync statistics across integrations.
+ */
+class UsersResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * 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`);
+     * ```
+     */
+    async get() {
+        return this.http.get(`/v1/users/${this.userId}`);
+    }
+    /**
+     * 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'
+     * });
+     * ```
+     */
+    async update(options) {
+        const body = {};
+        if (options.firstName !== undefined)
+            body.first_name = options.firstName;
+        if (options.lastName !== undefined)
+            body.last_name = options.lastName;
+        if (options.role !== undefined)
+            body.role = options.role;
+        if (options.timezone !== undefined)
+            body.timezone = options.timezone;
+        if (options.onboarded !== undefined)
+            body.onboarded = options.onboarded;
+        return this.http.patch(`/v1/users/${this.userId}`, body);
+    }
+    /**
+     * 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}`);
+     * ```
+     */
+    async syncStats() {
+        return this.http.get(`/v1/users/${this.userId}/sync-stats`);
+    }
+}
+exports.UsersResource = UsersResource;
+//# sourceMappingURL=users.js.map

package/cjs/src/resources/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../../../../../packages/sdk/src/resources/users.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAwBH;;;;;GAKG;AACH,MAAa,aAAa;IACxB,YACmB,IAAgB,EAChB,MAAc;QADd,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,GAAG;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,MAAM,CAAC,OAA0B;QACrC,MAAM,IAAI,GAA4B,EAAE,CAAC;QAEzC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACzE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC;QACtE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACrE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAExE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAO,aAAa,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAY,aAAa,IAAI,CAAC,MAAM,aAAa,CAAC,CAAC;IACzE,CAAC;CACF;AA1ED,sCA0EC"}

package/cjs/src/types/index.js

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * Attrove SDK Types
+ *
+ * Standalone type definitions for the SDK. These are bundled with the package
+ * and do not depend on internal monorepo packages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidStreamFrame = exports.ErrorCodes = exports.isValidISODate = exports.isValidApiKey = exports.createUUID = exports.createISODate = exports.createApiKey = exports.createConversationId = exports.createMessageId = exports.createIntegrationId = exports.createUserId = exports.isValidUUID = exports.asBrandedString = void 0;
+/**
+ * Helper to cast a string to a branded type.
+ *
+ * Use with caution - this bypasses type safety. Prefer using the
+ * validation factory functions (createUserId, createApiKey, etc.)
+ * which validate the input before branding.
+ *
+ * @example
+ * ```ts
+ * // Only use after validating the format
+ * const userId = asBrandedString<UserId>(validatedUuid);
+ * ```
+ */
+function asBrandedString(value) {
+    return value;
+}
+exports.asBrandedString = asBrandedString;
+// =============================================================================
+// Validation Factory Functions
+// =============================================================================
+//
+// These functions validate input and return branded types. Use these instead
+// of asBrandedString when you want runtime validation.
+//
+/**
+ * UUID regex pattern.
+ * Validates the 8-4-4-4-12 hexadecimal format but does not enforce a specific UUID version.
+ */
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * API key regex pattern (sk_ prefix followed by alphanumeric and underscores).
+ */
+const API_KEY_REGEX = /^sk_[a-zA-Z0-9_]+$/;
+/**
+ * ISO 8601 date regex pattern (basic validation).
+ */
+const ISO_DATE_REGEX = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?$/;
+/**
+ * Check if a string is a valid UUID format.
+ * Validates the 8-4-4-4-12 hexadecimal format but does not enforce a specific UUID version.
+ *
+ * @param value - String to validate
+ * @returns True if the string is a valid UUID format
+ *
+ * @example
+ * ```ts
+ * if (isValidUUID(userId)) {
+ *   // proceed with the valid UUID
+ * }
+ * ```
+ */
+function isValidUUID(value) {
+    return UUID_REGEX.test(value);
+}
+exports.isValidUUID = isValidUUID;
+/**
+ * Validate and create a UserId from a string.
+ *
+ * @param value - String to validate
+ * @returns Validation result with branded UserId or error message
+ *
+ * @example
+ * ```ts
+ * const result = createUserId('550e8400-e29b-41d4-a716-446655440000');
+ * if (result.success) {
+ *   const userId: UserId = result.value;
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+function createUserId(value) {
+    if (!value || typeof value !== 'string') {
+        return { success: false, error: 'UserId must be a non-empty string' };
+    }
+    if (!UUID_REGEX.test(value)) {
+        return { success: false, error: 'UserId must be a valid UUID format' };
+    }
+    return { success: true, value: value };
+}
+exports.createUserId = createUserId;
+/**
+ * Validate and create an IntegrationId from a string.
+ */
+function createIntegrationId(value) {
+    if (!value || typeof value !== 'string') {
+        return { success: false, error: 'IntegrationId must be a non-empty string' };
+    }
+    if (!UUID_REGEX.test(value)) {
+        return { success: false, error: 'IntegrationId must be a valid UUID format' };
+    }
+    return { success: true, value: value };
+}
+exports.createIntegrationId = createIntegrationId;
+/**
+ * Validate and create a MessageId from a string.
+ */
+function createMessageId(value) {
+    if (!value || typeof value !== 'string') {
+        return { success: false, error: 'MessageId must be a non-empty string' };
+    }
+    if (!UUID_REGEX.test(value)) {
+        return { success: false, error: 'MessageId must be a valid UUID format' };
+    }
+    return { success: true, value: value };
+}
+exports.createMessageId = createMessageId;
+/**
+ * Validate and create a ConversationId from a string.
+ */
+function createConversationId(value) {
+    if (!value || typeof value !== 'string') {
+        return { success: false, error: 'ConversationId must be a non-empty string' };
+    }
+    if (!UUID_REGEX.test(value)) {
+        return { success: false, error: 'ConversationId must be a valid UUID format' };
+    }
+    return { success: true, value: value };
+}
+exports.createConversationId = createConversationId;
+/**
+ * Validate and create an ApiKeyToken from a string.
+ *
+ * @example
+ * ```ts
+ * const result = createApiKey('sk_live_abc123');
+ * if (result.success) {
+ *   const apiKey: ApiKeyToken = result.value;
+ * }
+ * ```
+ */
+function createApiKey(value) {
+    if (!value || typeof value !== 'string') {
+        return { success: false, error: 'ApiKey must be a non-empty string' };
+    }
+    if (!API_KEY_REGEX.test(value)) {
+        return { success: false, error: 'ApiKey must start with "sk_" followed by alphanumeric characters' };
+    }
+    return { success: true, value: value };
+}
+exports.createApiKey = createApiKey;
+/**
+ * Validate and create an ISODateString from a string.
+ *
+ * @example
+ * ```ts
+ * const result = createISODate('2024-01-15T10:30:00Z');
+ * if (result.success) {
+ *   const date: ISODateString = result.value;
+ * }
+ * ```
+ */
+function createISODate(value) {
+    if (!value || typeof value !== 'string') {
+        return { success: false, error: 'ISODateString must be a non-empty string' };
+    }
+    if (!ISO_DATE_REGEX.test(value)) {
+        return { success: false, error: 'ISODateString must be a valid ISO 8601 date format' };
+    }
+    // Additional validation: ensure it parses to a valid date
+    const parsed = Date.parse(value);
+    if (Number.isNaN(parsed)) {
+        return { success: false, error: 'ISODateString must be a valid date' };
+    }
+    return { success: true, value: value };
+}
+exports.createISODate = createISODate;
+/**
+ * Validate and create a UUID from a string.
+ */
+function createUUID(value) {
+    if (!value || typeof value !== 'string') {
+        return { success: false, error: 'UUID must be a non-empty string' };
+    }
+    if (!UUID_REGEX.test(value)) {
+        return { success: false, error: 'UUID must be a valid UUID format' };
+    }
+    return { success: true, value: value };
+}
+exports.createUUID = createUUID;
+/**
+ * Check if a string is a valid API key format.
+ */
+function isValidApiKey(value) {
+    return API_KEY_REGEX.test(value);
+}
+exports.isValidApiKey = isValidApiKey;
+/**
+ * Check if a string is a valid ISO 8601 date format.
+ */
+function isValidISODate(value) {
+    return ISO_DATE_REGEX.test(value) && !Number.isNaN(Date.parse(value));
+}
+exports.isValidISODate = isValidISODate;
+// =============================================================================
+// Error Types
+// =============================================================================
+/**
+ * Standardized error codes from the Attrove API.
+ */
+exports.ErrorCodes = {
+    // Authentication errors
+    AUTH_MISSING_TOKEN: 'AUTH_MISSING_TOKEN',
+    AUTH_INVALID_TOKEN: 'AUTH_INVALID_TOKEN',
+    AUTH_EXPIRED_TOKEN: 'AUTH_EXPIRED_TOKEN',
+    AUTH_USER_MISMATCH: 'AUTH_USER_MISMATCH',
+    AUTH_INSUFFICIENT_PERMISSIONS: 'AUTH_INSUFFICIENT_PERMISSIONS',
+    // Resource errors
+    RESOURCE_NOT_FOUND: 'RESOURCE_NOT_FOUND',
+    RESOURCE_ACCESS_DENIED: 'RESOURCE_ACCESS_DENIED',
+    RESOURCE_ALREADY_EXISTS: 'RESOURCE_ALREADY_EXISTS',
+    RESOURCE_DELETED: 'RESOURCE_DELETED',
+    // Validation errors
+    VALIDATION_INVALID_ID: 'VALIDATION_INVALID_ID',
+    VALIDATION_REQUIRED_FIELD: 'VALIDATION_REQUIRED_FIELD',
+    VALIDATION_INVALID_FORMAT: 'VALIDATION_INVALID_FORMAT',
+    VALIDATION_OUT_OF_RANGE: 'VALIDATION_OUT_OF_RANGE',
+    // Integration errors
+    INTEGRATION_OAUTH_FAILED: 'INTEGRATION_OAUTH_FAILED',
+    INTEGRATION_EMAIL_EXISTS: 'INTEGRATION_EMAIL_EXISTS',
+    INTEGRATION_TOKEN_EXPIRED: 'INTEGRATION_TOKEN_EXPIRED',
+    INTEGRATION_SYNC_FAILED: 'INTEGRATION_SYNC_FAILED',
+    INTEGRATION_NOT_CONNECTED: 'INTEGRATION_NOT_CONNECTED',
+    // Rate limiting
+    RATE_LIMIT_EXCEEDED: 'RATE_LIMIT_EXCEEDED',
+    // Server errors
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
+};
+/**
+ * Valid stream frame types.
+ */
+const VALID_FRAME_TYPES = new Set(['chunk', 'end', 'error', 'state', 'message_ids', 'stream_start']);
+/**
+ * Runtime validator for StreamFrame objects.
+ * Validates that parsed JSON has the required structure for a StreamFrame.
+ *
+ * @param data - Unknown data to validate (typically from JSON.parse)
+ * @returns True if the data is a valid StreamFrame, false otherwise
+ *
+ * @example
+ * ```ts
+ * const parsed = JSON.parse(event.data);
+ * if (isValidStreamFrame(parsed)) {
+ *   // TypeScript knows parsed is StreamFrame
+ *   handleFrame(parsed);
+ * }
+ * ```
+ */
+function isValidStreamFrame(data) {
+    if (!data || typeof data !== 'object') {
+        return false;
+    }
+    const frame = data;
+    // All frames must have type and message_id
+    if (typeof frame.type !== 'string' || !VALID_FRAME_TYPES.has(frame.type)) {
+        return false;
+    }
+    if (typeof frame.message_id !== 'string') {
+        return false;
+    }
+    // Type-specific validation
+    switch (frame.type) {
+        case 'chunk':
+            return typeof frame.content === 'string';
+        case 'end':
+            return typeof frame.reason === 'string' &&
+                ['completed', 'cancelled', 'error'].includes(frame.reason);
+        case 'error':
+            return typeof frame.error === 'string';
+        case 'state':
+            return typeof frame.state === 'string';
+        case 'message_ids':
+            return Array.isArray(frame.used_message_ids) &&
+                frame.used_message_ids.every((id) => typeof id === 'string');
+        case 'stream_start':
+            return true;
+        default:
+            return false;
+    }
+}
+exports.isValidStreamFrame = isValidStreamFrame;
+//# sourceMappingURL=index.js.map

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

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