@gravity-rail/sdk 0.6.0 → 0.7.1

package/dist/internal.cjs

@@ -198,6 +198,7 @@ __export(internal_exports, {
   bindCustomersMethods: () => bindCustomersMethods,
   bindDataTypesMethods: () => bindDataTypesMethods,
   bindEventsMethods: () => bindEventsMethods,
+  bindExperimentsMethods: () => bindExperimentsMethods,
   bindFilesMethods: () => bindFilesMethods,
   bindIntegrationsMethods: () => bindIntegrationsMethods,
   bindJourneysMethods: () => bindJourneysMethods,
@@ -241,6 +242,7 @@ __export(internal_exports, {
   isFeatureAvailable: () => isFeatureAvailable,
   isRegistryInitialized: () => isRegistryInitialized,
   isSMSDeliveryFailureStatus: () => isSMSDeliveryFailureStatus,
+  parseExperimentStatCount: () => parseExperimentStatCount,
   requiresAssistantParticipant: () => requiresAssistantParticipant,
   usesBuiltinAssistant: () => usesBuiltinAssistant,
   validateFeatureDependencies: () => validateFeatureDependencies
@@ -307,6 +309,9 @@ var Scope = /* @__PURE__ */ ((Scope2) => {
   Scope2["JOURNEYS_READ"] = "journeys:read";
   Scope2["JOURNEYS_WRITE"] = "journeys:write";
   Scope2["JOURNEYS_ADMIN"] = "journeys:admin";
+  Scope2["EXPERIMENTS_READ"] = "experiments:read";
+  Scope2["EXPERIMENTS_WRITE"] = "experiments:write";
+  Scope2["EXPERIMENTS_ADMIN"] = "experiments:admin";
   Scope2["WORKFLOWS_READ"] = "workflows:read";
   Scope2["WORKFLOWS_WRITE"] = "workflows:write";
   Scope2["WORKFLOWS_ADMIN"] = "workflows:admin";
@@ -484,6 +489,7 @@ var WorkspaceFeature = /* @__PURE__ */ ((WorkspaceFeature2) => {
   WorkspaceFeature2["CALENDAR"] = "calendar";
   WorkspaceFeature2["DIRECT_MESSAGES"] = "direct_messages";
   WorkspaceFeature2["JOURNEYS"] = "journeys";
+  WorkspaceFeature2["EXPERIMENTS"] = "experiments";
   WorkspaceFeature2["OPERATOR"] = "operator";
   WorkspaceFeature2["PRESENCE"] = "presence";
   WorkspaceFeature2["GMAIL"] = "gmail";
@@ -795,6 +801,11 @@ var ConsentMethod = /* @__PURE__ */ ((ConsentMethod2) => {
   return ConsentMethod2;
 })(ConsentMethod || {});
 
+// src/types/experiment-types.ts
+function parseExperimentStatCount(value) {
+  return typeof value === "number" ? value : null;
+}
+
 // src/types/agent-task-types.ts
 var TERMINAL_TASK_STATES = [
   "TASK_STATE_COMPLETED",
@@ -1338,6 +1349,7 @@ var ScopeCategory = /* @__PURE__ */ ((ScopeCategory2) => {
   ScopeCategory2["RECORDS"] = "records";
   ScopeCategory2["FILES"] = "files";
   ScopeCategory2["JOURNEYS"] = "journeys";
+  ScopeCategory2["EXPERIMENTS"] = "experiments";
   ScopeCategory2["SITES"] = "sites";
   ScopeCategory2["AGENTS"] = "agents";
   ScopeCategory2["CALENDARS"] = "calendars";
@@ -1597,6 +1609,26 @@ var SCOPES = {
     implies: ["journeys:write"]
   },
   // =========================================================================
+  // EXPERIMENTS
+  // =========================================================================
+  "experiments:read": {
+    name: "experiments:read",
+    category: "experiments" /* EXPERIMENTS */,
+    description: "View experiments and assignments"
+  },
+  "experiments:write": {
+    name: "experiments:write",
+    category: "experiments" /* EXPERIMENTS */,
+    description: "Create and edit experiments",
+    implies: ["experiments:read"]
+  },
+  "experiments:admin": {
+    name: "experiments:admin",
+    category: "experiments" /* EXPERIMENTS */,
+    description: "Delete draft experiments and archive experiments",
+    implies: ["experiments:write"]
+  },
+  // =========================================================================
   // SITES
   // =========================================================================
   "sites:read": {
@@ -3635,6 +3667,22 @@ var ChatsApi = class extends BaseApiClient {
       body: JSON.stringify(chat)
     });
   }
+  /**
+   * Create a workflow assignment chat on `phone-voice` and initiate an outbound call
+   * to the member (same as POST /chats with channel phone-voice + send_initial_message).
+   */
+  async createWorkflowOutboundVoiceChat(wid, input) {
+    const { memberId, workflowId, phoneNumberId, title, chatType } = input;
+    return this.createChat(wid, {
+      channel: "phone-voice",
+      chatType: chatType ?? "assignment",
+      workflowId,
+      phoneNumberId,
+      memberId,
+      title: title ?? `Outbound voice \u2192 member ${memberId}`,
+      participants: [{ memberId, role: "user" }]
+    });
+  }
   /** Delete a chat, optionally providing a reason. */
   async deleteChat(wid, id, reason) {
     return this.fetch(`w/${wid}/chats/${id}`, {
@@ -4566,6 +4614,99 @@ var EventsApi = class extends BaseApiClient {
   }
 };
 
+// src/api/experiments.ts
+var ExperimentsApi = class extends BaseApiClient {
+  /** List experiments with group summaries and assignment counts. */
+  async getExperiments(wid, params) {
+    const query = new URLSearchParams();
+    if (params?.page !== void 0) query.set("page", String(params.page));
+    if (params?.pageSize !== void 0) query.set("pageSize", String(params.pageSize));
+    if (params?.includeArchived) query.set("includeArchived", "true");
+    const qs = query.toString() ? `?${query.toString()}` : "";
+    return this.fetch(`w/${wid}/experiments${qs}`);
+  }
+  /** Get a single experiment by ID (includes groups). */
+  async getExperiment(wid, experimentId) {
+    return this.fetch(`w/${wid}/experiments/${experimentId}`);
+  }
+  /** Create a draft experiment. */
+  async createExperiment(wid, data) {
+    return this.fetch(`w/${wid}/experiments`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  /** Update experiment metadata or lifecycle status. */
+  async updateExperiment(wid, experimentId, data) {
+    return this.fetch(`w/${wid}/experiments/${experimentId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  /** Hard-delete a draft experiment, or archive otherwise. */
+  async deleteExperiment(wid, experimentId) {
+    return this.fetch(`w/${wid}/experiments/${experimentId}`, {
+      method: "DELETE"
+    });
+  }
+  /** Create a group within an experiment. */
+  async createExperimentGroup(wid, experimentId, data) {
+    return this.fetch(`w/${wid}/experiments/${experimentId}/groups`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  /** Update a group within an experiment. */
+  async updateExperimentGroup(wid, experimentId, groupId, data) {
+    return this.fetch(`w/${wid}/experiments/${experimentId}/groups/${groupId}`, {
+      method: "PATCH",
+      body: JSON.stringify(data)
+    });
+  }
+  /** Delete a group that has no member assignments. */
+  async deleteExperimentGroup(wid, experimentId, groupId) {
+    return this.fetch(
+      `w/${wid}/experiments/${experimentId}/groups/${groupId}`,
+      { method: "DELETE" }
+    );
+  }
+  /** Aggregate assignment and exposure counts by group. */
+  async getExperimentStats(wid, experimentId) {
+    return this.fetch(`w/${wid}/experiments/${experimentId}/stats`);
+  }
+  /** List experiment assignments for a member (member profile panel). */
+  async getMemberExperiments(wid, memberId) {
+    return this.fetch(`w/${wid}/members/${memberId}/experiments`);
+  }
+  /** Manually assign a member to an experiment (optional group, or weighted random). */
+  async createExperimentAssignment(wid, experimentId, data) {
+    return this.fetch(
+      `w/${wid}/experiments/${experimentId}/assignments`,
+      {
+        method: "POST",
+        body: JSON.stringify(data)
+      }
+    );
+  }
+  /** Move an assigned member to a different experiment group. */
+  async updateExperimentAssignment(wid, experimentId, memberId, data) {
+    return this.fetch(
+      `w/${wid}/experiments/${experimentId}/assignments/${memberId}`,
+      {
+        method: "PATCH",
+        body: JSON.stringify(data)
+      }
+    );
+  }
+  /** Remove a member's assignment from an experiment. */
+  async deleteExperimentAssignment(wid, experimentId, memberId) {
+    return this.fetch(
+      `w/${wid}/experiments/${experimentId}/assignments/${memberId}`,
+      { method: "DELETE" }
+    );
+  }
+};
+
 // src/api/features.ts
 var FeaturesApi = class extends BaseApiClient {
   /**
@@ -7892,6 +8033,20 @@ var SupportRequestsApi = class extends BaseApiClient {
       body: JSON.stringify(data)
     });
   }
+  /**
+   * Record a click on a pushed resource (Proactive Support). For a
+   * manager_prompt, pass the Manager Chat UUID it opened so the
+   * resource→chat linkage is preserved.
+   */
+  async clickWorkspaceSupportRequestResource(workspaceUuid, uuid, resourceUuid, data = {}) {
+    return this.fetch(
+      `w/${workspaceUuid}/support-requests/${uuid}/resources/${resourceUuid}/click`,
+      {
+        method: "POST",
+        body: JSON.stringify(data)
+      }
+    );
+  }
 };
 
 // src/api/customers.ts
@@ -9128,6 +9283,7 @@ function createApiModules(apiKey, baseUrl, customFetch) {
     slackApps: new SlackAppsApi(apiKey, baseUrl, customFetch),
     teamsApps: new TeamsAppsApi(apiKey, baseUrl, customFetch),
     events: new EventsApi(apiKey, baseUrl, customFetch),
+    experiments: new ExperimentsApi(apiKey, baseUrl, customFetch),
     fhirConnections: new FhirConnectionsApi(apiKey, baseUrl, customFetch),
     healthie: new HealthieApi(apiKey, baseUrl, customFetch),
     hubspot: new HubspotApi(apiKey, baseUrl, customFetch),
@@ -9227,6 +9383,7 @@ function bindChatsMethods(target, chats) {
   target.archiveChat = chats.archiveChat.bind(chats);
   target.unarchiveChat = chats.unarchiveChat.bind(chats);
   target.createChat = chats.createChat.bind(chats);
+  target.createWorkflowOutboundVoiceChat = chats.createWorkflowOutboundVoiceChat.bind(chats);
   target.deleteChat = chats.deleteChat.bind(chats);
   target.updateChat = chats.updateChat.bind(chats);
   target.updateChatMute = chats.updateChatMute.bind(chats);
@@ -9561,6 +9718,23 @@ function bindEventsMethods(target, events) {
   target.previewSchedule = events.previewSchedule.bind(events);
 }
 
+// src/client/bindings/experiments.ts
+function bindExperimentsMethods(target, experiments) {
+  target.getExperiments = experiments.getExperiments.bind(experiments);
+  target.getExperiment = experiments.getExperiment.bind(experiments);
+  target.createExperiment = experiments.createExperiment.bind(experiments);
+  target.updateExperiment = experiments.updateExperiment.bind(experiments);
+  target.deleteExperiment = experiments.deleteExperiment.bind(experiments);
+  target.createExperimentGroup = experiments.createExperimentGroup.bind(experiments);
+  target.updateExperimentGroup = experiments.updateExperimentGroup.bind(experiments);
+  target.deleteExperimentGroup = experiments.deleteExperimentGroup.bind(experiments);
+  target.getExperimentStats = experiments.getExperimentStats.bind(experiments);
+  target.getMemberExperiments = experiments.getMemberExperiments.bind(experiments);
+  target.createExperimentAssignment = experiments.createExperimentAssignment.bind(experiments);
+  target.updateExperimentAssignment = experiments.updateExperimentAssignment.bind(experiments);
+  target.deleteExperimentAssignment = experiments.deleteExperimentAssignment.bind(experiments);
+}
+
 // src/client/bindings/workflows.ts
 function bindWorkflowsMethods(target, workflows, workflowNotes, voice, supervisors) {
   target.getWorkflows = workflows.getWorkflows.bind(workflows);
@@ -10100,6 +10274,7 @@ function bindSupportRequestMethods(target, supportRequests) {
   target.createWorkspaceSupportRequest = supportRequests.createWorkspaceSupportRequest.bind(supportRequests);
   target.commentOnWorkspaceSupportRequest = supportRequests.commentOnWorkspaceSupportRequest.bind(supportRequests);
   target.closeWorkspaceSupportRequest = supportRequests.closeWorkspaceSupportRequest.bind(supportRequests);
+  target.clickWorkspaceSupportRequestResource = supportRequests.clickWorkspaceSupportRequestResource.bind(supportRequests);
 }
 
 // src/client/client.ts
@@ -10130,6 +10305,7 @@ var GravityRailClient = class {
   archiveChat;
   unarchiveChat;
   createChat;
+  createWorkflowOutboundVoiceChat;
   deleteChat;
   updateChat;
   updateChatMute;
@@ -10300,6 +10476,20 @@ var GravityRailClient = class {
   createJourneyNote;
   updateJourneyNote;
   deleteJourneyNote;
+  // Experiments API
+  getExperiments;
+  getExperiment;
+  createExperiment;
+  updateExperiment;
+  deleteExperiment;
+  createExperimentGroup;
+  updateExperimentGroup;
+  deleteExperimentGroup;
+  getExperimentStats;
+  getMemberExperiments;
+  createExperimentAssignment;
+  updateExperimentAssignment;
+  deleteExperimentAssignment;
   // Operator Groups API
   getOperatorGroups;
   getOperatorGroup;
@@ -10966,6 +11156,7 @@ var GravityRailClient = class {
   createWorkspaceSupportRequest;
   commentOnWorkspaceSupportRequest;
   closeWorkspaceSupportRequest;
+  clickWorkspaceSupportRequestResource;
   constructor(apiKey, baseUrl, customFetch) {
     const apis = createApiModules(apiKey, baseUrl, customFetch);
     this.apis = apis;
@@ -10980,6 +11171,7 @@ var GravityRailClient = class {
     bindQualificationsMethods(this, apis.qualifications);
     bindPersonasMethods(this, apis.personas);
     bindJourneysMethods(this, apis.journeys);
+    bindExperimentsMethods(this, apis.experiments);
     bindOperatorMethods(this, apis.operatorGroups);
     bindOrgMethods(this, apis.org);
     bindAccessGrantsMethods(this, apis.accessGrants);
@@ -11291,6 +11483,7 @@ var GravityRailClient = class {
   bindCustomersMethods,
   bindDataTypesMethods,
   bindEventsMethods,
+  bindExperimentsMethods,
   bindFilesMethods,
   bindIntegrationsMethods,
   bindJourneysMethods,
@@ -11334,6 +11527,7 @@ var GravityRailClient = class {
   isFeatureAvailable,
   isRegistryInitialized,
   isSMSDeliveryFailureStatus,
+  parseExperimentStatCount,
   requiresAssistantParticipant,
   usesBuiltinAssistant,
   validateFeatureDependencies