@unboundcx/sdk 4.13.86 → 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.86",
+  "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.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);
   }
 }