@unboundcx/sdk 4.13.85 → 4.13.87

package/index.js

@@ -330,6 +330,7 @@ export { ExternalOAuthService } from './services/externalOAuth.js';
 export { GoogleCalendarService } from './services/googleCalendar.js';
 export { FormsService } from './services/forms.js';
 export { FormsPublicService } from './services/forms/PublicService.js';
+export { FormsHealthService } from './services/forms/HealthService.js';
 export { DriveService } from './services/drive.js';
 export { EnrollService } from './services/enroll.js';
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.85",
+  "version": "4.13.87",
   "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/forms/HealthService.js

@@ -0,0 +1,35 @@
+import { internalRequest } from '../../base.js';
+
+// Forms v2 P8 (plans/forms-v2-plan.md D13, forms-v2-precheck.md §9) --
+// agent-authenticated Health tab data (`sdk.forms.health`): submissions
+// tiles, a 30-day submissions-per-day sparkline, per-field fill rate, and
+// drift alerts (a field with 0 non-blank values in the last 7 days after
+// previously being filled >=50% of the time). Backed by the nightly
+// `formFieldStats` rollup -- server route:
+// `app1-api/src/services/forms/controllers/getFormHealth.js`.
+export class FormsHealthService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * @param {string} formId
+   * @returns {Promise<{
+   *   tiles: {submissions:number, submissionsChangePct:number|null,
+   *     spamCount:number, spamRatePct:number, companyLinkedPct:number,
+   *     companyCreated:number, actionsFailed:number},
+   *   sparkline: {day:string, submitted:number}[],
+   *   fields: {fieldKey:string, label:string, fillRate:number|null,
+   *     priorFillRate:number|null, isDrifting:boolean}[],
+   *   driftAlerts: object[],
+   *   windowDays: number,
+   * }>}
+   */
+  async get(formId) {
+    return internalRequest(
+      this.sdk,
+      `/forms/${encodeURIComponent(formId)}/health`,
+      'GET',
+    );
+  }
+}

package/services/forms/PublicService.js

@@ -54,4 +54,42 @@ export class FormsPublicService {
       true,
     );
   }
+
+  /**
+   * Upload a file for a `file` inputType field (D21), ahead of the real
+   * `submit()` call. Mirrors `webchat.visitor.files.upload()`'s shape:
+   * browser-only (needs `FormData`), no progress event. The returned
+   * `token` must be echoed back inside `submit()`'s `fields[fieldKey]` as
+   * `JSON.stringify({fileId, token})` -- the server (formFileAttach.js)
+   * verifies it names this exact (formId, fieldKey, fileId) triple before
+   * attaching the file to the submission.
+   * @param {string} publicKey
+   * @param {string} fieldKey - Must match a `file` inputType field on the form.
+   * @param {File|Blob} file
+   * @returns {Promise<{fileId:string, token:string, fileName:string, fileType:string, fileSize:number}>}
+   */
+  async upload(publicKey, fieldKey, file) {
+    this.sdk.validateParams(
+      { publicKey, fieldKey },
+      {
+        publicKey: { type: 'string', required: true },
+        fieldKey: { type: 'string', required: true },
+      },
+    );
+    if (typeof FormData === 'undefined' || !file) {
+      throw new Error(
+        'forms.public.upload :: a browser File/Blob and FormData support are required',
+      );
+    }
+    const body = new FormData();
+    body.append('fieldKey', fieldKey);
+    body.append('file', file);
+    return internalRequest(
+      this.sdk,
+      `/f/${publicKey}/upload`,
+      'POST',
+      { body },
+      true,
+    );
+  }
 }

package/services/forms.js

@@ -1,15 +1,17 @@
 import { FormsPublicService } from './forms/PublicService.js';
 import { FormsSubmissionsService } from './forms/SubmissionsService.js';
 import { FormsSettingsService } from './forms/SettingsService.js';
+import { FormsHealthService } from './forms/HealthService.js';
 
 // Forms v2 (forms-v2-plan.md §7 / forms-v2-precheck.md §5) -- `sdk.forms`.
 // `public` needs no agent auth (VisitorService pattern, publicKey-scoped);
-// `submissions`/`settings` are normal agent-token calls.
+// `submissions`/`settings`/`health` are normal agent-token calls.
 export class FormsService {
   constructor(sdk) {
     this.sdk = sdk;
     this.public = new FormsPublicService(sdk);
     this.submissions = new FormsSubmissionsService(sdk);
     this.settings = new FormsSettingsService(sdk);
+    this.health = new FormsHealthService(sdk);
   }
 }