@attrove/sdk 0.1.18 → 0.2.0

package/cjs/client.js

@@ -18,6 +18,8 @@ const calendars_js_1 = require("./resources/calendars.js");
 const events_js_1 = require("./resources/events.js");
 const meetings_js_1 = require("./resources/meetings.js");
 const threads_js_1 = require("./resources/threads.js");
+const notes_js_1 = require("./resources/notes.js");
+const push_js_1 = require("./resources/push.js");
 const query_js_1 = require("./resources/query.js");
 const index_js_1 = require("./errors/index.js");
 const index_js_2 = require("./types/index.js");
@@ -124,6 +126,8 @@ class Attrove {
         this.events = new events_js_1.EventsResource(this.http, this.config.userId);
         this.meetings = new meetings_js_1.MeetingsResource(this.http, this.config.userId);
         this.threads = new threads_js_1.ThreadsResource(this.http, this.config.userId);
+        this.notes = new notes_js_1.NotesResource(this.http, this.config.userId);
+        this.push = new push_js_1.PushResource(this.http, this.config.userId);
         this.queryResource = new query_js_1.QueryResource(this.http, this.config.userId);
     }
     /**

package/cjs/constants.js

@@ -13,7 +13,7 @@ exports.getWsCloseReason = exports.WS_CLOSE_CODES = exports.RETRYABLE_STATUS_SET
  * Automatically synchronized with package.json during the release process.
  * For programmatic access, use `getVersion()` from './version'.
  */
-exports.SDK_VERSION = "0.1.18"; // auto-synced from package.json during release
+exports.SDK_VERSION = "0.2.0"; // auto-synced from package.json during release
 /**
  * Default API base URL for Attrove services.
  */

package/cjs/resources/index.js

@@ -3,7 +3,7 @@
  * Resource exports
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdminWebhooksResource = exports.AdminSettingsResource = exports.QueryResource = exports.ThreadsResource = exports.MeetingsResource = exports.EventsResource = exports.CalendarsResource = exports.EntitiesResource = exports.IntegrationsResource = exports.ConversationsResource = exports.MessagesResource = exports.UsersResource = void 0;
+exports.AdminWebhooksResource = exports.PushResource = exports.NotesResource = exports.AdminSettingsResource = exports.QueryResource = exports.ThreadsResource = exports.MeetingsResource = exports.EventsResource = exports.CalendarsResource = exports.EntitiesResource = exports.IntegrationsResource = exports.ConversationsResource = exports.MessagesResource = exports.UsersResource = void 0;
 var users_js_1 = require("./users.js");
 Object.defineProperty(exports, "UsersResource", { enumerable: true, get: function () { return users_js_1.UsersResource; } });
 var messages_js_1 = require("./messages.js");
@@ -26,5 +26,9 @@ var query_js_1 = require("./query.js");
 Object.defineProperty(exports, "QueryResource", { enumerable: true, get: function () { return query_js_1.QueryResource; } });
 var settings_js_1 = require("./settings.js");
 Object.defineProperty(exports, "AdminSettingsResource", { enumerable: true, get: function () { return settings_js_1.AdminSettingsResource; } });
+var notes_js_1 = require("./notes.js");
+Object.defineProperty(exports, "NotesResource", { enumerable: true, get: function () { return notes_js_1.NotesResource; } });
+var push_js_1 = require("./push.js");
+Object.defineProperty(exports, "PushResource", { enumerable: true, get: function () { return push_js_1.PushResource; } });
 var webhooks_js_1 = require("./webhooks.js");
 Object.defineProperty(exports, "AdminWebhooksResource", { enumerable: true, get: function () { return webhooks_js_1.AdminWebhooksResource; } });

package/cjs/resources/messages.js

@@ -71,6 +71,9 @@ class MessagesResource {
         if (options.entityId) {
             params.entity_id = options.entityId;
         }
+        if (options.entityScope) {
+            params.entity_scope = options.entityScope;
+        }
         if (options.excludeBots !== undefined) {
             params.exclude_bots = String(options.excludeBots);
         }

package/cjs/resources/notes.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Notes Resource
+ *
+ * Provides methods for listing and retrieving notes.
+ * Notes are analyst observations, partner-pushed context, or session summaries
+ * that are RAG-indexed and become queryable via query() and search().
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotesResource = void 0;
+const validate_ref_pair_js_1 = require("../utils/validate-ref-pair.js");
+const index_js_1 = require("../errors/index.js");
+const index_js_2 = require("../types/index.js");
+/**
+ * Notes resource for listing and retrieving notes.
+ *
+ * Notes are RAG-indexed context items that can be created via the Push API
+ * (`attrove.push.note()`) or by partner systems. They support cross-referencing
+ * to other primitives (messages, meetings, events, entities) via `ref_type` and `ref_id`.
+ */
+class NotesResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * List notes with optional filtering.
+     *
+     * Supports filtering by specific IDs (useful after receiving a `notes.new` webhook),
+     * by reference type/ID (find all notes linked to a specific message or meeting),
+     * and standard pagination.
+     *
+     * @param options - Filtering and pagination options
+     * @returns Paginated list of notes
+     *
+     * @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
+     * @throws {ServerError} If the server encounters an error
+     *
+     * @example
+     * ```ts
+     * // List recent notes
+     * const { data, pagination } = await attrove.notes.list();
+     *
+     * // Fetch specific notes from a webhook payload
+     * const { data } = await attrove.notes.list({
+     *   ids: ['note_1Z', 'note_2B4'],
+     * });
+     *
+     * // Find notes linked to a specific message
+     * const { data } = await attrove.notes.list({
+     *   refType: 'message',
+     *   refId: 'msg_xxx',
+     * });
+     * ```
+     */
+    async list(options = {}) {
+        (0, validate_ref_pair_js_1.validateRefPair)(options.refType, options.refId);
+        const params = {};
+        if (options.ids?.length) {
+            params.ids = options.ids.join(',');
+        }
+        if (options.refType) {
+            params.ref_type = options.refType;
+        }
+        if (options.refId) {
+            params.ref_id = options.refId;
+        }
+        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}/notes`, { method: 'GET' }, params);
+        return {
+            data: response.data,
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Get a single note by ID.
+     *
+     * @param id - Note ID (opaque note_xxx format)
+     * @returns The requested note
+     *
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {NotFoundError} If the note does not exist
+     * @throws {ValidationError} If the ID format is invalid
+     * @throws {NetworkError} If unable to reach the API
+     *
+     * @example
+     * ```ts
+     * const note = await attrove.notes.get('note_1Z');
+     * console.log(note.title, note.body);
+     * ```
+     */
+    async get(id) {
+        if (!id || typeof id !== 'string') {
+            throw new index_js_1.ValidationError('id is required and must be a non-empty string', index_js_2.ErrorCodes.VALIDATION_REQUIRED_FIELD, { field: 'id', received: typeof id });
+        }
+        return this.http.get(`/v1/users/${this.userId}/notes/${id}`);
+    }
+}
+exports.NotesResource = NotesResource;

package/cjs/resources/push.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * Push Resource
+ *
+ * Provides methods for pushing data directly into Attrove without
+ * requiring user OAuth connections. Supports messages, meetings,
+ * events, and notes. All pushed items are asynchronously RAG-indexed
+ * and become queryable via query() and search().
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PushResource = void 0;
+const validate_ref_pair_js_1 = require("../utils/validate-ref-pair.js");
+const index_js_1 = require("../errors/index.js");
+const index_js_2 = require("../types/index.js");
+/**
+ * Push resource for ingesting data directly into a user's context.
+ *
+ * Each method auto-provisions a virtual integration (e.g., `manual_email`,
+ * `manual_notes`) on first push for the user. Items are queued for
+ * asynchronous RAG processing and fire webhook events when indexed.
+ *
+ * Idempotent when `externalId` is provided: re-pushing the same external ID
+ * updates the existing item and re-indexes it.
+ */
+class PushResource {
+    constructor(http, userId) {
+        this.http = http;
+        this.userId = userId;
+    }
+    /**
+     * Push a message (email, chat, alert, or custom) for the user.
+     *
+     * The `source` field determines the virtual integration type:
+     * - `email` → `manual_email` (subject-based threading)
+     * - `chat`, `alert`, `custom` → `manual_chat` (channel-based grouping)
+     *
+     * @param input - Message data
+     * @returns Push response with opaque ID (msg_xxx) and processing status
+     *
+     * @throws {ValidationError} If required fields are missing or invalid
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ServerError} If the server encounters an error
+     *
+     * @example
+     * ```ts
+     * const result = await attrove.push.message({
+     *   source: 'email',
+     *   bodyText: 'Hey team, the Q4 report is ready for review.',
+     *   subject: 'Q4 Report Ready',
+     *   senderEmail: 'alice@acme.com',
+     *   senderName: 'Alice Chen',
+     *   externalId: 'email-12345',
+     * });
+     * console.log(result.id);     // msg_xxx
+     * console.log(result.status);  // 'queued'
+     * ```
+     */
+    async message(input) {
+        const validSources = index_js_2.PUSH_MESSAGE_SOURCES;
+        if (!input.source || !validSources.includes(input.source)) {
+            throw new index_js_1.ValidationError(`source must be one of: ${validSources.join(', ')}`, index_js_2.ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'source', received: input.source });
+        }
+        if (!input.bodyText ||
+            typeof input.bodyText !== 'string' ||
+            input.bodyText.trim() === '') {
+            throw new index_js_1.ValidationError('bodyText is required and must be a non-empty string', index_js_2.ErrorCodes.VALIDATION_REQUIRED_FIELD, { field: 'bodyText' });
+        }
+        const body = {
+            source: input.source,
+            body_text: input.bodyText,
+        };
+        if (input.subject != null)
+            body.subject = input.subject;
+        if (input.senderName != null)
+            body.sender_name = input.senderName;
+        if (input.senderEmail != null)
+            body.sender_email = input.senderEmail;
+        if (input.recipientEmails != null)
+            body.recipient_emails = input.recipientEmails;
+        if (input.receivedAt != null)
+            body.received_at = input.receivedAt;
+        if (input.externalId != null)
+            body.external_id = input.externalId;
+        if (input.threadId != null)
+            body.thread_id = input.threadId;
+        if (input.metadata != null)
+            body.metadata = input.metadata;
+        const data = await this.http.post(`/v1/users/${this.userId}/messages`, body);
+        if (!data?.id || !data?.status) {
+            throw new index_js_1.ServerError('Unexpected response shape from push message endpoint', 500, {
+                missingFields: [
+                    ...(!data?.id ? ['id'] : []),
+                    ...(!data?.status ? ['status'] : []),
+                ],
+                received: (() => {
+                    if (data == null)
+                        return String(data);
+                    const raw = JSON.stringify(data);
+                    return raw.length > 200 ? raw.substring(0, 200) + '...' : raw;
+                })(),
+            });
+        }
+        return { ...data };
+    }
+    /**
+     * Push a meeting with transcript, summary, and attendees for the user.
+     *
+     * @param input - Meeting data
+     * @returns Push response with opaque ID (mtg_xxx) and processing status
+     *
+     * @throws {ValidationError} If required fields are missing or invalid
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ServerError} If the server encounters an error
+     *
+     * @example
+     * ```ts
+     * const result = await attrove.push.meeting({
+     *   title: 'Weekly Standup',
+     *   startTime: '2026-03-23T09:00:00Z',
+     *   endTime: '2026-03-23T09:30:00Z',
+     *   transcript: 'Alice: Good morning everyone...',
+     *   summary: 'Discussed sprint progress and blockers.',
+     *   attendees: [
+     *     { name: 'Alice Chen', email: 'alice@acme.com' },
+     *     { name: 'Bob Smith', email: 'bob@acme.com' },
+     *   ],
+     *   externalId: 'meeting-xyz',
+     * });
+     * console.log(result.id); // mtg_xxx
+     * ```
+     */
+    async meeting(input) {
+        if (!input.title ||
+            typeof input.title !== 'string' ||
+            input.title.trim() === '') {
+            throw new index_js_1.ValidationError('title is required and must be a non-empty string', index_js_2.ErrorCodes.VALIDATION_REQUIRED_FIELD, { field: 'title' });
+        }
+        if (!input.startTime) {
+            throw new index_js_1.ValidationError('startTime is required (ISO 8601 datetime)', index_js_2.ErrorCodes.VALIDATION_REQUIRED_FIELD, { field: 'startTime' });
+        }
+        if (!input.endTime) {
+            throw new index_js_1.ValidationError('endTime is required (ISO 8601 datetime)', index_js_2.ErrorCodes.VALIDATION_REQUIRED_FIELD, { field: 'endTime' });
+        }
+        const body = {
+            title: input.title,
+            start_time: input.startTime,
+            end_time: input.endTime,
+        };
+        if (input.transcript != null)
+            body.transcript = input.transcript;
+        if (input.summary != null)
+            body.summary = input.summary;
+        if (input.shortSummary != null)
+            body.short_summary = input.shortSummary;
+        if (input.actionItems != null)
+            body.action_items = input.actionItems;
+        if (input.attendees != null)
+            body.attendees = input.attendees;
+        if (input.externalId != null)
+            body.external_id = input.externalId;
+        if (input.metadata != null)
+            body.metadata = input.metadata;
+        const data = await this.http.post(`/v1/users/${this.userId}/meetings`, body);
+        if (!data?.id || !data?.status) {
+            throw new index_js_1.ServerError('Unexpected response shape from push meeting endpoint', 500, {
+                missingFields: [
+                    ...(!data?.id ? ['id'] : []),
+                    ...(!data?.status ? ['status'] : []),
+                ],
+                received: (() => {
+                    if (data == null)
+                        return String(data);
+                    const raw = JSON.stringify(data);
+                    return raw.length > 200 ? raw.substring(0, 200) + '...' : raw;
+                })(),
+            });
+        }
+        return { ...data };
+    }
+    /**
+     * Push a calendar event or milestone for the user.
+     *
+     * If `endTime` is omitted, it defaults to `startTime` (point-in-time event).
+     *
+     * @param input - Event data
+     * @returns Push response with opaque ID (evt_xxx) and processing status
+     *
+     * @throws {ValidationError} If required fields are missing or invalid
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ServerError} If the server encounters an error
+     *
+     * @example
+     * ```ts
+     * const result = await attrove.push.event({
+     *   title: 'Product Launch',
+     *   startTime: '2026-04-01T00:00:00Z',
+     *   description: 'V2 launch day — all hands on deck.',
+     *   allDay: true,
+     *   externalId: 'milestone-launch-v2',
+     * });
+     * console.log(result.id); // evt_xxx
+     * ```
+     */
+    async event(input) {
+        if (!input.title ||
+            typeof input.title !== 'string' ||
+            input.title.trim() === '') {
+            throw new index_js_1.ValidationError('title is required and must be a non-empty string', index_js_2.ErrorCodes.VALIDATION_REQUIRED_FIELD, { field: 'title' });
+        }
+        if (!input.startTime) {
+            throw new index_js_1.ValidationError('startTime is required (ISO 8601 datetime)', index_js_2.ErrorCodes.VALIDATION_REQUIRED_FIELD, { field: 'startTime' });
+        }
+        const body = {
+            title: input.title,
+            start_time: input.startTime,
+        };
+        if (input.endTime != null)
+            body.end_time = input.endTime;
+        if (input.description != null)
+            body.description = input.description;
+        if (input.location != null)
+            body.location = input.location;
+        if (input.allDay != null)
+            body.all_day = input.allDay;
+        if (input.externalId != null)
+            body.external_id = input.externalId;
+        if (input.metadata != null)
+            body.metadata = input.metadata;
+        const data = await this.http.post(`/v1/users/${this.userId}/events`, body);
+        if (!data?.id || !data?.status) {
+            throw new index_js_1.ServerError('Unexpected response shape from push event endpoint', 500, {
+                missingFields: [
+                    ...(!data?.id ? ['id'] : []),
+                    ...(!data?.status ? ['status'] : []),
+                ],
+                received: (() => {
+                    if (data == null)
+                        return String(data);
+                    const raw = JSON.stringify(data);
+                    return raw.length > 200 ? raw.substring(0, 200) + '...' : raw;
+                })(),
+            });
+        }
+        return { ...data };
+    }
+    /**
+     * Push an analyst note or observation for the user.
+     *
+     * Notes can optionally reference another primitive (message, meeting, event,
+     * or entity) via `refType` and `refId`. Both must be provided together or
+     * both omitted. The `refId` must use the correct opaque prefix for its type
+     * (msg_xxx, mtg_xxx, evt_xxx, ent_xxx).
+     *
+     * @param input - Note data
+     * @returns Push response with opaque ID (note_xxx) and processing status
+     *
+     * @throws {ValidationError} If required fields are missing or invalid
+     * @throws {AuthenticationError} If the API key is invalid or expired
+     * @throws {ServerError} If the server encounters an error
+     *
+     * @example
+     * ```ts
+     * // Standalone note
+     * const result = await attrove.push.note({
+     *   body: 'Decision: chose Redis for caching due to latency requirements.',
+     *   title: 'Architecture Decision',
+     * });
+     *
+     * // Note linked to a message
+     * const linked = await attrove.push.note({
+     *   body: 'This email contains the final pricing agreement.',
+     *   refType: 'message',
+     *   refId: 'msg_1Z',
+     * });
+     * ```
+     */
+    async note(input) {
+        if (!input.body ||
+            typeof input.body !== 'string' ||
+            input.body.trim() === '') {
+            throw new index_js_1.ValidationError('body is required and must be a non-empty string', index_js_2.ErrorCodes.VALIDATION_REQUIRED_FIELD, { field: 'body' });
+        }
+        const validated = (0, validate_ref_pair_js_1.validateRefPair)(input.refType, input.refId);
+        const body = {
+            body: input.body,
+        };
+        if (input.title != null)
+            body.title = input.title;
+        if (validated.refType != null)
+            body.ref_type = validated.refType;
+        if (validated.refId != null)
+            body.ref_id = validated.refId;
+        if (input.externalId != null)
+            body.external_id = input.externalId;
+        if (input.metadata != null)
+            body.metadata = input.metadata;
+        const data = await this.http.post(`/v1/users/${this.userId}/notes`, body);
+        if (!data?.id || !data?.status) {
+            throw new index_js_1.ServerError('Unexpected response shape from push note endpoint', 500, {
+                missingFields: [
+                    ...(!data?.id ? ['id'] : []),
+                    ...(!data?.status ? ['status'] : []),
+                ],
+                received: (() => {
+                    if (data == null)
+                        return String(data);
+                    const raw = JSON.stringify(data);
+                    return raw.length > 200 ? raw.substring(0, 200) + '...' : raw;
+                })(),
+            });
+        }
+        return { ...data };
+    }
+}
+exports.PushResource = PushResource;

package/cjs/resources/query.js

@@ -214,7 +214,7 @@ class QueryResource {
             body.expand = 'sources';
         }
         const config = options.idempotencyKey
-            ? { headers: { "Idempotency-Key": options.idempotencyKey } }
+            ? { headers: { 'Idempotency-Key': options.idempotencyKey } }
             : undefined;
         const response = await this.http.post(`/v1/users/${this.userId}/query`, body, config);
         return {
@@ -223,6 +223,7 @@ class QueryResource {
             used_message_ids: response.used_message_ids,
             used_meeting_ids: response.used_meeting_ids ?? [],
             used_event_ids: response.used_event_ids ?? [],
+            used_note_ids: response.used_note_ids ?? [],
             sources: response.sources,
         };
     }
@@ -285,6 +286,9 @@ class QueryResource {
         if (options.entityIds?.length) {
             body.entity_ids = options.entityIds;
         }
+        if (options.retrievalMode) {
+            body.retrieval_mode = options.retrievalMode;
+        }
         if (options.includeBodyText) {
             expandFields.add('body_text');
         }
@@ -292,7 +296,7 @@ class QueryResource {
             body.expand = Array.from(expandFields).join(',');
         }
         const config = options.idempotencyKey
-            ? { headers: { "Idempotency-Key": options.idempotencyKey } }
+            ? { headers: { 'Idempotency-Key': options.idempotencyKey } }
             : undefined;
         const response = await this.http.post(`/v1/users/${this.userId}/search`, body, config);
         return normalizeSearchResponse(response);

package/cjs/resources/webhooks.js

@@ -11,6 +11,7 @@ const ADMIN_WEBHOOK_SUBSCRIBABLE_EVENT_TYPES = [
     'meetings.new',
     'events.new',
     'events.starting_soon',
+    'notes.new',
 ];
 const _arrayCoversType = true;
 void _arrayCoversType;

package/cjs/types/index.js

@@ -6,7 +6,7 @@
  * and do not depend on internal monorepo packages.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidStreamFrame = exports.UNKNOWN_SENDER = exports.ErrorCodes = exports.isValidISODate = exports.isApiKey = exports.isValidApiKey = exports.createUUID = exports.createISODate = exports.createApiKey = exports.createConversationId = exports.createMessageId = exports.createIntegrationId = exports.createUserId = exports.isValidUUID = exports.asBrandedString = void 0;
+exports.PUSH_MESSAGE_SOURCES = exports.NOTE_REF_TYPES = exports.isValidStreamFrame = exports.UNKNOWN_SENDER = exports.ErrorCodes = exports.isValidISODate = exports.isApiKey = 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.
  *
@@ -340,7 +340,8 @@ function isValidStreamFrame(data) {
                 ['completed', 'cancelled', 'error'].includes(frame.reason) &&
                 isOptionalStringArray(frame.used_message_ids) &&
                 isOptionalStringArray(frame.used_meeting_ids) &&
-                isOptionalStringArray(frame.used_event_ids));
+                isOptionalStringArray(frame.used_event_ids) &&
+                isOptionalStringArray(frame.used_note_ids));
         case 'error':
             return typeof frame.error === 'string';
         case 'state':
@@ -349,7 +350,8 @@ function isValidStreamFrame(data) {
             return (Array.isArray(frame.used_message_ids) &&
                 frame.used_message_ids.every((id) => typeof id === 'string') &&
                 isOptionalStringArray(frame.used_meeting_ids) &&
-                isOptionalStringArray(frame.used_event_ids));
+                isOptionalStringArray(frame.used_event_ids) &&
+                isOptionalStringArray(frame.used_note_ids));
         case 'stream_start':
             return true;
         default:
@@ -363,3 +365,17 @@ function isOptionalStringArray(value) {
     return (Array.isArray(value) &&
         value.every((item) => typeof item === 'string'));
 }
+/** Canonical list of valid note reference types — use for runtime validation. */
+exports.NOTE_REF_TYPES = [
+    'message',
+    'meeting',
+    'event',
+    'entity',
+];
+/** Canonical list of valid push message source types — use for runtime validation. */
+exports.PUSH_MESSAGE_SOURCES = [
+    'email',
+    'chat',
+    'alert',
+    'custom',
+];

package/cjs/utils/index.js

@@ -3,7 +3,7 @@
  * Utility exports
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyWebhookSignatureDetailed = exports.verifyWebhookSignature = exports.generateMessageId = exports.StreamingClient = exports.HttpClient = void 0;
+exports.validateRefPair = exports.verifyWebhookSignatureDetailed = exports.verifyWebhookSignature = exports.generateMessageId = exports.StreamingClient = exports.HttpClient = void 0;
 var fetch_js_1 = require("./fetch.js");
 Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return fetch_js_1.HttpClient; } });
 var streaming_js_1 = require("./streaming.js");
@@ -12,3 +12,5 @@ Object.defineProperty(exports, "generateMessageId", { enumerable: true, get: fun
 var webhooks_js_1 = require("./webhooks.js");
 Object.defineProperty(exports, "verifyWebhookSignature", { enumerable: true, get: function () { return webhooks_js_1.verifyWebhookSignature; } });
 Object.defineProperty(exports, "verifyWebhookSignatureDetailed", { enumerable: true, get: function () { return webhooks_js_1.verifyWebhookSignatureDetailed; } });
+var validate_ref_pair_js_1 = require("./validate-ref-pair.js");
+Object.defineProperty(exports, "validateRefPair", { enumerable: true, get: function () { return validate_ref_pair_js_1.validateRefPair; } });

package/cjs/utils/streaming.js

@@ -110,6 +110,7 @@ class StreamingClient {
         let usedMessageIds = [];
         let usedMeetingIds = [];
         let usedEventIds = [];
+        let usedNoteIds = [];
         let cancelled = false;
         let completed = false;
         // Connect to WebSocket
@@ -233,6 +234,9 @@ class StreamingClient {
                         if (frame.used_event_ids !== undefined) {
                             usedEventIds = frame.used_event_ids;
                         }
+                        if (frame.used_note_ids !== undefined) {
+                            usedNoteIds = frame.used_note_ids;
+                        }
                         break;
                     case "error": {
                         const error = new index_js_2.AttroveError(frame.error, index_js_3.ErrorCodes.INTERNAL_ERROR);
@@ -252,6 +256,9 @@ class StreamingClient {
                         if (frame.used_event_ids !== undefined) {
                             usedEventIds = frame.used_event_ids;
                         }
+                        if (frame.used_note_ids !== undefined) {
+                            usedNoteIds = frame.used_note_ids;
+                        }
                         onEnd?.(frame.reason);
                         // Build updated history
                         const updatedHistory = [
@@ -265,6 +272,7 @@ class StreamingClient {
                             usedMessageIds,
                             usedMeetingIds,
                             usedEventIds,
+                            usedNoteIds,
                             cancelled,
                         });
                         break;

package/cjs/utils/validate-ref-pair.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Shared ref_type / ref_id pairing validation used by NotesResource and PushResource.
+ * Ensures ref_type is a valid NoteRefType and that both fields are present or both absent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateRefPair = void 0;
+const index_js_1 = require("../errors/index.js");
+const index_js_2 = require("../types/index.js");
+/**
+ * Validate refType against NOTE_REF_TYPES and enforce the refType/refId pairing constraint.
+ * Both must be provided or both omitted.
+ */
+function validateRefPair(refType, refId) {
+    if (refType != null) {
+        if (typeof refType !== 'string') {
+            throw new index_js_1.ValidationError(`refType must be a string, received ${typeof refType}`, index_js_2.ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'refType', received: typeof refType });
+        }
+        const valid = index_js_2.NOTE_REF_TYPES;
+        if (!valid.includes(refType)) {
+            throw new index_js_1.ValidationError(`refType must be one of: ${valid.join(', ')}`, index_js_2.ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'refType', received: refType });
+        }
+    }
+    if (refId != null) {
+        if (typeof refId !== 'string') {
+            throw new index_js_1.ValidationError(`refId must be a string, received ${typeof refId}`, index_js_2.ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'refId', received: typeof refId });
+        }
+        if (refId.trim() === '') {
+            throw new index_js_1.ValidationError('refId must be a non-empty string', index_js_2.ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'refId' });
+        }
+    }
+    const hasRefType = refType != null;
+    const hasRefId = refId != null;
+    if (hasRefType !== hasRefId) {
+        throw new index_js_1.ValidationError('refType and refId must both be provided or both omitted', index_js_2.ErrorCodes.VALIDATION_INVALID_FORMAT, { field: hasRefType ? 'refId' : 'refType' });
+    }
+    if (hasRefType) {
+        return {
+            refType: refType,
+            refId: refId,
+        };
+    }
+    return {};
+}
+exports.validateRefPair = validateRefPair;