@unboundcx/sdk 4.10.2 → 4.11.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.10.2",
+  "version": "4.11.1",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/services/drive.js

@@ -228,4 +228,25 @@ export class DriveService {
     );
     return result;
   }
+
+  /**
+   * Walk/create a Drive folder path. Path is already interpolated.
+   * @param {Object} options
+   * @param {string} options.path - e.g. unbound/people/Ada Lovelace
+   * @param {string} [options.sharedDriveId]
+   * @param {boolean} [options.create]
+   */
+  async resolvePath({ path, sharedDriveId, create } = {}) {
+    this.sdk.validateParams(
+      { path, sharedDriveId },
+      {
+        path: { type: 'string', required: true },
+        sharedDriveId: { type: 'string', required: false },
+      },
+    );
+    const body = { path };
+    if (sharedDriveId !== undefined) body.sharedDriveId = sharedDriveId;
+    if (create !== undefined) body.create = create;
+    return internalRequest(this.sdk, '/drive/resolvePath', 'POST', { body });
+  }
 }

package/services/messaging/EmailTemplatesService.js

@@ -163,4 +163,81 @@ export class EmailTemplatesService {
     const result = await internalRequest(this.sdk, '/messaging/email/template', 'GET');
     return result;
   }
+
+  /**
+   * Render a template (saved or draft fields) with sample variables for
+   * preview, without sending or saving.
+   * @param {string} id - Template ID (required)
+   * @param {Object} [body] - Draft fields to render
+   * @param {string} [body.subject] - Draft subject
+   * @param {string} [body.html] - Draft HTML body
+   * @param {string} [body.text] - Draft plain-text body
+   * @param {Object} [body.variables] - Variable substitution values
+   * @returns {Promise<Object>} Rendered preview
+   * @example
+   * const preview = await sdk.messaging.email.templates.preview('tpl_123', {
+   *   subject: 'Welcome {{firstName}}',
+   *   html: '<p>Hello {{firstName}}</p>',
+   *   variables: { firstName: 'Jane' },
+   * });
+   */
+  async preview(id, { subject, html, text, variables } = {}) {
+    this.sdk.validateParams(
+      { id },
+      {
+        id: { type: 'string', required: true },
+      },
+    );
+
+    const previewData = {};
+    if (subject !== undefined) previewData.subject = subject;
+    if (html !== undefined) previewData.html = html;
+    if (text !== undefined) previewData.text = text;
+    if (variables !== undefined) previewData.variables = variables;
+
+    const options = {
+      body: previewData,
+    };
+
+    const result = await internalRequest(this.sdk, 
+      `/messaging/email/template/${id}/preview`,
+      'POST',
+      options,
+    );
+    return result;
+  }
+
+  /**
+   * Send a test email of a template to an address.
+   * @param {string} id - Template ID (required)
+   * @param {string} to - Destination email address (required)
+   * @param {Object} [body] - Optional overrides (from, subject, html, text, variables)
+   * @returns {Promise<Object>} Send confirmation
+   * @example
+   * await sdk.messaging.email.templates.sendTest('tpl_123', 'a@b.com');
+   * await sdk.messaging.email.templates.sendTest('tpl_123', 'a@b.com', {
+   *   from: 'noreply@example.com',
+   *   subject: 'Test subject',
+   * });
+   */
+  async sendTest(id, to, body = {}) {
+    this.sdk.validateParams(
+      { id, to },
+      {
+        id: { type: 'string', required: true },
+        to: { type: 'string', required: true },
+      },
+    );
+
+    const options = {
+      body: { to, ...body },
+    };
+
+    const result = await internalRequest(this.sdk, 
+      `/messaging/email/template/${id}/test`,
+      'POST',
+      options,
+    );
+    return result;
+  }
 }