veform-js 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric McElyea
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,10 @@
+# veform-js
+
+JS/TS Library for [Veform](https://veform.co)
+
+
+For usage/examples see [Playground](https://veform.co/playground)
+
+## License
+
+See [LICENSE](./LICENSE) file.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./veform-builder";
+export * from "./veform";

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./veform-builder";
+export * from "./veform";

package/dist/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/veform-builder.d.ts

@@ -0,0 +1,118 @@
+declare enum FieldType {
+    TEXT = "text",
+    TEXTAREA = "textarea",
+    SELECT = "select",
+    MULTISELECT = "multiselect",
+    YESNO = "yesNo",
+    NUMBER = "number",
+    INFO = "info"
+}
+type EventHandlers = {
+    onFocus?: (previousName: string) => boolean;
+    onChange?: (answer: string | number | boolean) => void;
+};
+export declare abstract class Field {
+    name: string;
+    question: string;
+    type: FieldType;
+    eventConfig?: FieldEventConfig | undefined;
+    eventHandlers: EventHandlers;
+    constructor(name: string, question: string, type: FieldType, eventConfig?: FieldEventConfig | undefined, eventHandlers?: EventHandlers);
+    addBehavior(event: FieldEvents, behavior: FieldBehavior): void;
+    onFocus(callback: EventHandlers['onFocus']): void;
+    onChange(callback: EventHandlers['onChange']): void;
+}
+export type FieldEventConfig = {
+    [key in FieldEvents]?: FieldBehavior[];
+};
+declare enum FieldEvents {
+    VALID_ANSWER = "validAnswer",
+    INVALID_ANSWER = "invalidAnswer",
+    MOVE_REQUESTED = "moveRequested",
+    END_REQUESTED = "endRequested",
+    VALID_YES_ANSWER = "validYesAnswer",
+    VALID_NO_ANSWER = "validNoAnswer"
+}
+declare enum FieldBehaviorType {
+    MOVE_TO = "moveTo",
+    OUTPUT = "output"
+}
+type FieldBehavior = {
+    type: FieldBehaviorType;
+    moveToFieldName: string;
+    output?: string;
+    modifier?: string;
+};
+export declare class TextField extends Field {
+    textFieldValidation?: TextFieldValidation;
+    constructor(name: string, question: string, eventConfig?: FieldEventConfig);
+    addValidation(validation: TextFieldValidation): void;
+}
+type TextFieldPatterns = 'email' | 'phone' | 'url' | 'date' | 'name';
+type TextFieldValidation = {
+    validate: boolean;
+    pattern?: TextFieldPatterns;
+    readback?: boolean;
+};
+export declare class NumberField extends Field {
+    numberFieldValidation?: NumberFieldValidation;
+    constructor(name: string, question: string, eventConfig?: FieldEventConfig);
+    addValidation(validation: NumberFieldValidation): void;
+}
+type NumberFieldValidation = {
+    validate: boolean;
+    minValue?: number;
+    maxValue?: number;
+};
+export declare class SelectField extends Field {
+    selectFieldValidation?: SelectFieldValidation;
+    constructor(name: string, question: string, eventConfig?: FieldEventConfig);
+    addSelectOption(option: SelectOption): void;
+}
+export type SelectOption = {
+    label: string;
+    value: string;
+    readAloud?: boolean;
+    behaviors?: FieldBehavior[];
+};
+type SelectFieldValidation = {
+    validate: boolean;
+    selectOptions?: SelectOption[];
+};
+export declare class MultiselectField extends Field {
+    multiselectFieldValidation?: SelectFieldValidation;
+    constructor(name: string, question: string, eventConfig?: FieldEventConfig);
+    addSelectOption(option: SelectOption): void;
+}
+export declare class YesNoField extends Field {
+    yesNoFieldValidation?: YesNoFieldValidation;
+    constructor(name: string, question: string, eventConfig?: FieldEventConfig);
+    addValidation(validation: YesNoFieldValidation): void;
+}
+type YesNoFieldValidation = {
+    validate: boolean;
+    requireYes?: boolean;
+    requireNo?: boolean;
+};
+export declare class TextAreaField extends Field {
+    textAreaFieldValidation?: TextAreaFieldValidation;
+    constructor(name: string, question: string, eventConfig?: FieldEventConfig);
+    addValidation(validation: TextAreaFieldValidation): void;
+}
+type TextAreaFieldValidation = {
+    validate: boolean;
+    maxCharacters?: number;
+    minCharacters?: number;
+};
+export declare class InfoField extends Field {
+    constructor(name: string, question: string, eventConfig?: FieldEventConfig);
+}
+export declare class VeformBuilder {
+    private fields;
+    addField({ name, question, type }: Field): Field | null;
+    getField(name: string): Field | undefined;
+    getFields(): Field[];
+    setField(name: string, field: Field): boolean;
+    removeField(name: string): boolean;
+}
+export {};

package/dist/veform-builder.js

@@ -0,0 +1,184 @@
+// TMRW MOVE THESE ALL TO CLASSES THAT CAN CONVERT TO THE JSON PAYLOAD WHEN NEEDED
+// then test we can actuall parse this nonsense in GO
+var FieldType;
+(function (FieldType) {
+    FieldType["TEXT"] = "text";
+    FieldType["TEXTAREA"] = "textarea";
+    FieldType["SELECT"] = "select";
+    FieldType["MULTISELECT"] = "multiselect";
+    FieldType["YESNO"] = "yesNo";
+    FieldType["NUMBER"] = "number";
+    FieldType["INFO"] = "info";
+})(FieldType || (FieldType = {}));
+export class Field {
+    constructor(name, question, type, eventConfig, eventHandlers = {}) {
+        this.name = name;
+        this.question = question;
+        this.type = type;
+        this.eventConfig = eventConfig;
+        this.eventHandlers = eventHandlers;
+    }
+    addBehavior(event, behavior) {
+        if (!this.eventConfig) {
+            this.eventConfig = {};
+        }
+        if (!this.eventConfig[event]) {
+            this.eventConfig[event] = [];
+        }
+        if (behavior.type === FieldBehaviorType.MOVE_TO) {
+            const existingMoveToIndex = this.eventConfig[event].findIndex(b => b.type === FieldBehaviorType.MOVE_TO);
+            if (existingMoveToIndex !== -1) {
+                this.eventConfig[event][existingMoveToIndex] = behavior;
+            }
+            else {
+                this.eventConfig[event].push(behavior);
+            }
+        }
+        else {
+            this.eventConfig[event].push(behavior);
+        }
+    }
+    onFocus(callback) {
+        this.eventHandlers.onFocus = callback;
+    }
+    onChange(callback) {
+        this.eventHandlers.onChange = callback;
+    }
+}
+var FieldEvents;
+(function (FieldEvents) {
+    FieldEvents["VALID_ANSWER"] = "validAnswer";
+    FieldEvents["INVALID_ANSWER"] = "invalidAnswer";
+    FieldEvents["MOVE_REQUESTED"] = "moveRequested";
+    FieldEvents["END_REQUESTED"] = "endRequested";
+    FieldEvents["VALID_YES_ANSWER"] = "validYesAnswer";
+    FieldEvents["VALID_NO_ANSWER"] = "validNoAnswer";
+})(FieldEvents || (FieldEvents = {}));
+var FieldBehaviorType;
+(function (FieldBehaviorType) {
+    FieldBehaviorType["MOVE_TO"] = "moveTo";
+    FieldBehaviorType["OUTPUT"] = "output";
+})(FieldBehaviorType || (FieldBehaviorType = {}));
+export class TextField extends Field {
+    constructor(name, question, eventConfig) {
+        super(name, question, FieldType.TEXT, eventConfig);
+    }
+    addValidation(validation) {
+        this.textFieldValidation = validation;
+    }
+}
+export class NumberField extends Field {
+    constructor(name, question, eventConfig) {
+        super(name, question, FieldType.NUMBER, eventConfig);
+    }
+    addValidation(validation) {
+        this.numberFieldValidation = validation;
+    }
+}
+export class SelectField extends Field {
+    constructor(name, question, eventConfig) {
+        super(name, question, FieldType.SELECT, eventConfig);
+        this.selectFieldValidation = {
+            validate: true,
+            selectOptions: [],
+        };
+    }
+    addSelectOption(option) {
+        this.selectFieldValidation?.selectOptions?.push(option);
+    }
+}
+export class MultiselectField extends Field {
+    constructor(name, question, eventConfig) {
+        super(name, question, FieldType.MULTISELECT, eventConfig);
+    }
+    addSelectOption(option) {
+        this.multiselectFieldValidation?.selectOptions?.push(option);
+    }
+}
+export class YesNoField extends Field {
+    constructor(name, question, eventConfig) {
+        super(name, question, FieldType.YESNO, eventConfig);
+    }
+    addValidation(validation) {
+        this.yesNoFieldValidation = validation;
+    }
+}
+export class TextAreaField extends Field {
+    constructor(name, question, eventConfig) {
+        super(name, question, FieldType.TEXTAREA, eventConfig);
+    }
+    addValidation(validation) {
+        this.textAreaFieldValidation = validation;
+    }
+}
+export class InfoField extends Field {
+    constructor(name, question, eventConfig) {
+        super(name, question, FieldType.INFO, eventConfig);
+    }
+}
+export class VeformBuilder {
+    constructor() {
+        this.fields = [];
+    }
+    addField({ name, question, type }) {
+        if (this.getField(name)) {
+            console.error(`Field with name ${name} already exists`);
+            return null;
+        }
+        if (name.length === 0 || question.length === 0) {
+            console.error(`Field with name ${name} and question ${question} has invalid name or question`);
+            return null;
+        }
+        let field;
+        switch (type) {
+            case FieldType.TEXT:
+                field = new TextField(name, question);
+                break;
+            case FieldType.TEXTAREA:
+                field = new TextAreaField(name, question);
+                break;
+            case FieldType.SELECT:
+                field = new SelectField(name, question);
+                break;
+            case FieldType.YESNO:
+                field = new YesNoField(name, question);
+                break;
+            case FieldType.NUMBER:
+                field = new NumberField(name, question);
+                break;
+            case FieldType.INFO:
+                field = new InfoField(name, question);
+                break;
+            case FieldType.MULTISELECT:
+                field = new MultiselectField(name, question);
+                break;
+            default:
+                console.error(`Field with name ${name} has invalid type ${type}`);
+                return null;
+        }
+        this.fields.push(field);
+        return field;
+    }
+    getField(name) {
+        return this.fields.find(field => field.name === name);
+    }
+    getFields() {
+        return this.fields;
+    }
+    setField(name, field) {
+        const index = this.fields.findIndex(field => field.name === name);
+        if (index !== -1) {
+            this.fields[index] = field;
+            return true;
+        }
+        return false;
+    }
+    removeField(name) {
+        const index = this.fields.findIndex(field => field.name === name);
+        if (index !== -1) {
+            this.fields.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+}

package/dist/veform.browser.js

@@ -0,0 +1,514 @@
+"use strict";
+var Veform = (() => {
+  var __defProp = Object.defineProperty;
+  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __export = (target, all) => {
+    for (var name in all)
+      __defProp(target, name, { get: all[name], enumerable: true });
+  };
+  var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from === "object" || typeof from === "function") {
+      for (let key of __getOwnPropNames(from))
+        if (!__hasOwnProp.call(to, key) && key !== except)
+          __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+    }
+    return to;
+  };
+  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+  // dist/index.js
+  var dist_exports = {};
+  __export(dist_exports, {
+    Field: () => Field,
+    InfoField: () => InfoField,
+    MultiselectField: () => MultiselectField,
+    NumberField: () => NumberField,
+    SelectField: () => SelectField,
+    TextAreaField: () => TextAreaField,
+    TextField: () => TextField,
+    Veform: () => Veform,
+    VeformBuilder: () => VeformBuilder,
+    YesNoField: () => YesNoField
+  });
+
+  // dist/veform-builder.js
+  var FieldType;
+  (function(FieldType2) {
+    FieldType2["TEXT"] = "text";
+    FieldType2["TEXTAREA"] = "textarea";
+    FieldType2["SELECT"] = "select";
+    FieldType2["MULTISELECT"] = "multiselect";
+    FieldType2["YESNO"] = "yesNo";
+    FieldType2["NUMBER"] = "number";
+    FieldType2["INFO"] = "info";
+  })(FieldType || (FieldType = {}));
+  var Field = class {
+    constructor(name, question, type, eventConfig, eventHandlers = {}) {
+      this.name = name;
+      this.question = question;
+      this.type = type;
+      this.eventConfig = eventConfig;
+      this.eventHandlers = eventHandlers;
+    }
+    addBehavior(event, behavior) {
+      if (!this.eventConfig) {
+        this.eventConfig = {};
+      }
+      if (!this.eventConfig[event]) {
+        this.eventConfig[event] = [];
+      }
+      if (behavior.type === FieldBehaviorType.MOVE_TO) {
+        const existingMoveToIndex = this.eventConfig[event].findIndex((b) => b.type === FieldBehaviorType.MOVE_TO);
+        if (existingMoveToIndex !== -1) {
+          this.eventConfig[event][existingMoveToIndex] = behavior;
+        } else {
+          this.eventConfig[event].push(behavior);
+        }
+      } else {
+        this.eventConfig[event].push(behavior);
+      }
+    }
+    onFocus(callback) {
+      this.eventHandlers.onFocus = callback;
+    }
+    onChange(callback) {
+      this.eventHandlers.onChange = callback;
+    }
+  };
+  var FieldEvents;
+  (function(FieldEvents2) {
+    FieldEvents2["VALID_ANSWER"] = "validAnswer";
+    FieldEvents2["INVALID_ANSWER"] = "invalidAnswer";
+    FieldEvents2["MOVE_REQUESTED"] = "moveRequested";
+    FieldEvents2["END_REQUESTED"] = "endRequested";
+    FieldEvents2["VALID_YES_ANSWER"] = "validYesAnswer";
+    FieldEvents2["VALID_NO_ANSWER"] = "validNoAnswer";
+  })(FieldEvents || (FieldEvents = {}));
+  var FieldBehaviorType;
+  (function(FieldBehaviorType2) {
+    FieldBehaviorType2["MOVE_TO"] = "moveTo";
+    FieldBehaviorType2["OUTPUT"] = "output";
+  })(FieldBehaviorType || (FieldBehaviorType = {}));
+  var TextField = class extends Field {
+    constructor(name, question, eventConfig) {
+      super(name, question, FieldType.TEXT, eventConfig);
+    }
+    addValidation(validation) {
+      this.textFieldValidation = validation;
+    }
+  };
+  var NumberField = class extends Field {
+    constructor(name, question, eventConfig) {
+      super(name, question, FieldType.NUMBER, eventConfig);
+    }
+    addValidation(validation) {
+      this.numberFieldValidation = validation;
+    }
+  };
+  var SelectField = class extends Field {
+    constructor(name, question, eventConfig) {
+      super(name, question, FieldType.SELECT, eventConfig);
+      this.selectFieldValidation = {
+        validate: true,
+        selectOptions: []
+      };
+    }
+    addSelectOption(option) {
+      this.selectFieldValidation?.selectOptions?.push(option);
+    }
+  };
+  var MultiselectField = class extends Field {
+    constructor(name, question, eventConfig) {
+      super(name, question, FieldType.MULTISELECT, eventConfig);
+    }
+    addSelectOption(option) {
+      this.multiselectFieldValidation?.selectOptions?.push(option);
+    }
+  };
+  var YesNoField = class extends Field {
+    constructor(name, question, eventConfig) {
+      super(name, question, FieldType.YESNO, eventConfig);
+    }
+    addValidation(validation) {
+      this.yesNoFieldValidation = validation;
+    }
+  };
+  var TextAreaField = class extends Field {
+    constructor(name, question, eventConfig) {
+      super(name, question, FieldType.TEXTAREA, eventConfig);
+    }
+    addValidation(validation) {
+      this.textAreaFieldValidation = validation;
+    }
+  };
+  var InfoField = class extends Field {
+    constructor(name, question, eventConfig) {
+      super(name, question, FieldType.INFO, eventConfig);
+    }
+  };
+  var VeformBuilder = class {
+    constructor() {
+      this.fields = [];
+    }
+    addField({ name, question, type }) {
+      if (this.getField(name)) {
+        console.error(`Field with name ${name} already exists`);
+        return null;
+      }
+      if (name.length === 0 || question.length === 0) {
+        console.error(`Field with name ${name} and question ${question} has invalid name or question`);
+        return null;
+      }
+      let field;
+      switch (type) {
+        case FieldType.TEXT:
+          field = new TextField(name, question);
+          break;
+        case FieldType.TEXTAREA:
+          field = new TextAreaField(name, question);
+          break;
+        case FieldType.SELECT:
+          field = new SelectField(name, question);
+          break;
+        case FieldType.YESNO:
+          field = new YesNoField(name, question);
+          break;
+        case FieldType.NUMBER:
+          field = new NumberField(name, question);
+          break;
+        case FieldType.INFO:
+          field = new InfoField(name, question);
+          break;
+        case FieldType.MULTISELECT:
+          field = new MultiselectField(name, question);
+          break;
+        default:
+          console.error(`Field with name ${name} has invalid type ${type}`);
+          return null;
+      }
+      this.fields.push(field);
+      return field;
+    }
+    getField(name) {
+      return this.fields.find((field) => field.name === name);
+    }
+    getFields() {
+      return this.fields;
+    }
+    setField(name, field) {
+      const index = this.fields.findIndex((field2) => field2.name === name);
+      if (index !== -1) {
+        this.fields[index] = field;
+        return true;
+      }
+      return false;
+    }
+    removeField(name) {
+      const index = this.fields.findIndex((field) => field.name === name);
+      if (index !== -1) {
+        this.fields.splice(index, 1);
+        return true;
+      }
+      return false;
+    }
+  };
+
+  // dist/veform.js
+  var DEFAULT_SERVER_URL = "ws://localhost:8080/ws";
+  var Veform = class {
+    constructor(fields) {
+      this.connected = false;
+      this.eventHandlers = {};
+      this.localStream = null;
+      this.peerConnection = null;
+      this.wsConnection = null;
+      this.audioElement = null;
+      if (fields instanceof VeformBuilder) {
+        this.form = { fields: fields.getFields() };
+      } else {
+        this.form = { fields };
+      }
+    }
+    onLoadingStarted(callback) {
+      this.eventHandlers.onLoadingStarted = callback;
+    }
+    onRunningStarted(callback) {
+      this.eventHandlers.onRunningStarted = callback;
+    }
+    onFinished(callback) {
+      this.eventHandlers.onFinished = callback;
+    }
+    onError(callback) {
+      this.eventHandlers.onError = callback;
+    }
+    onCriticalError(callback) {
+      this.eventHandlers.onCriticalError = callback;
+    }
+    onAudioInStart(callback) {
+      this.eventHandlers.onAudioInStart = callback;
+    }
+    onAudioInEnd(callback) {
+      this.eventHandlers.onAudioInEnd = callback;
+    }
+    onAudioOutStart(callback) {
+      this.eventHandlers.onAudioOutStart = callback;
+    }
+    onAudioOutEnd(callback) {
+      this.eventHandlers.onAudioOutEnd = callback;
+    }
+    onFieldValueChanged(callback) {
+      this.eventHandlers.onFieldValueChanged = callback;
+    }
+    onFocusChanged(callback) {
+      this.eventHandlers.onFocusChanged = callback;
+    }
+    /**
+     * Start the conversation
+     * This will connect the client the the veform server with the current set of fields
+     */
+    async start(token) {
+      if (!this.form?.fields || this.form?.fields.length === 0) {
+        console.error("No fields provided or token URL");
+        return false;
+      }
+      if (this.connected || this.wsConnection || this.peerConnection || this.localStream) {
+        console.error("Start already called, try running stop() or creating a new instance");
+        return false;
+      }
+      try {
+        if (token.startsWith("http")) {
+          console.log("Fetching token from URL", token);
+          token = await fetch(token, { method: "POST" }).then((response) => response.json()).then((data) => data.token);
+        }
+        if (!token) {
+          console.error("No token provided or returned from token URL");
+          return false;
+        }
+        this.audioElement = createAudioElement();
+        if (this.eventHandlers.onLoadingStarted) {
+          this.eventHandlers.onLoadingStarted();
+        }
+        this.localStream = await navigator.mediaDevices.getUserMedia({
+          audio: {
+            echoCancellation: true,
+            noiseSuppression: true,
+            sampleRate: 48e3,
+            channelCount: 1
+          },
+          video: false
+        });
+        this.peerConnection = new RTCPeerConnection();
+        this.localStream.getTracks().forEach((track) => {
+          if (!this.localStream || !this.peerConnection) {
+            console.error("Local stream or peer connection not established");
+            return;
+          }
+          this.peerConnection?.addTrack(track, this.localStream);
+        });
+        this.peerConnection.oniceconnectionstatechange = () => {
+          if (this.peerConnection?.iceConnectionState === "connected") {
+            this.connected = true;
+            console.log("Peer connection connected");
+          } else if (this.peerConnection?.iceConnectionState === "disconnected") {
+            console.log("Peer connection disconnected");
+          } else if (this.peerConnection?.iceConnectionState === "failed") {
+            if (this.eventHandlers.onError) {
+              this.eventHandlers.onError("Connection to server failed");
+            }
+          }
+        };
+        this.peerConnection.ontrack = (event) => {
+          if (!this.audioElement) {
+            console.error("Audio element not found");
+            return;
+          }
+          const stream = event.streams[0];
+          this.audioElement.srcObject = stream;
+          this.audioElement.play().catch((e) => console.error("Play error:", e));
+        };
+        this.wsConnection = new WebSocket(DEFAULT_SERVER_URL + "?token=" + token);
+        this.wsConnection.onmessage = (event) => {
+          const message = JSON.parse(event.data);
+          if (!this.peerConnection) {
+            console.error("WS response, Peer connection not established");
+            return;
+          }
+          if (message.type === "answer") {
+            const answer = new RTCSessionDescription(message.payload);
+            this.peerConnection.setRemoteDescription(answer);
+          } else if (message.type === "ice-candidate") {
+            const candidate = new RTCIceCandidate(message.payload);
+            this.peerConnection.addIceCandidate(candidate);
+          } else {
+            this.resolveWsMessage(message);
+          }
+        };
+        this.wsConnection.onopen = async () => {
+          if (!this.peerConnection) {
+            console.error("Peer connection not established");
+            return;
+          }
+          const offer = await this.peerConnection.createOffer();
+          await this.peerConnection.setLocalDescription(offer);
+          this.peerConnection.onicecandidate = (event) => {
+            if (event.candidate) {
+              this.wsConnection?.send(JSON.stringify({
+                type: "ice-candidate",
+                payload: event.candidate
+              }));
+            }
+          };
+          this.wsConnection?.send(JSON.stringify({
+            type: "offer",
+            payload: this.peerConnection?.localDescription
+          }));
+          this.wsConnection?.send(JSON.stringify({
+            type: "form",
+            payload: this.form
+          }));
+        };
+        return true;
+      } catch (error) {
+        console.error("Error starting conversation:", error);
+        this.connected = false;
+        this.wsConnection = null;
+        this.peerConnection = null;
+        this.localStream = null;
+        return false;
+      }
+    }
+    /**
+     * Stop the conversation, this will cut off audio mid output
+     */
+    stop() {
+      console.log("Stop called");
+      if (!this.connected) {
+        console.error("Not connected to veform server");
+        return;
+      }
+      this.connected = false;
+      this.wsConnection?.close();
+      this.wsConnection = null;
+      this.peerConnection?.close();
+      this.peerConnection = null;
+      this.localStream?.getTracks().forEach((track) => {
+        track.stop();
+      });
+      this.localStream = null;
+    }
+    /**
+     * Emit audio to client
+     * interrupt: if true, will interrupt the current output, otherwise will be queued behind current audio
+     */
+    emitAudio(audio, interrupt = false) {
+      console.log("Emit audio called", audio);
+    }
+    /**
+     * Change the current field
+     * This will change the current field to the one provided
+     */
+    changeField(fieldName, interrupt = false) {
+      console.log("Change field called", fieldName, interrupt);
+    }
+    /**
+     * Stop current audio output
+     */
+    interrupt() {
+      console.log("Interrupt called");
+    }
+    resolveWsMessage(message) {
+      console.log("RAW WS MESSAGE:", message);
+      switch (message.type) {
+        case "event-start":
+          if (this.eventHandlers.onRunningStarted) {
+            this.eventHandlers.onRunningStarted();
+          }
+          return;
+        case "event-end":
+          if (this.eventHandlers.onFinished) {
+            this.eventHandlers.onFinished();
+          }
+          return;
+        case "event-audio-out-start":
+          if (this.eventHandlers.onAudioOutStart) {
+            const interrupt = this.eventHandlers.onAudioOutStart(message.payload);
+            if (interrupt) {
+              console.log("Audio out start interrupted");
+            }
+          }
+          return;
+        case "event-audio-out-end":
+          if (this.eventHandlers.onAudioOutEnd) {
+            this.eventHandlers.onAudioOutEnd();
+          }
+          return;
+        case "event-input-start":
+          if (this.eventHandlers.onAudioInStart) {
+            this.eventHandlers.onAudioInStart();
+          }
+          return;
+        case "event-input-end":
+          if (this.eventHandlers.onAudioInEnd) {
+            const interrupt = this.eventHandlers.onAudioInEnd(message.payload);
+            if (interrupt) {
+              console.log("Audio in end interrupted");
+            }
+          }
+          return;
+        case "event-focus-changed":
+          if (this.eventHandlers.onFocusChanged) {
+            const interrupt = this.eventHandlers.onFocusChanged(message.payload.previousName, message.payload.nextName);
+            if (interrupt) {
+              console.log("Focus changed interrupted");
+              return;
+            }
+          }
+          const nextField = this.form.fields.find((field2) => field2.name === message.payload.nextName);
+          if (nextField?.eventHandlers?.onFocus) {
+            nextField.eventHandlers.onFocus(message.payload.previousName);
+          }
+          return;
+        case "event-field-value-changed":
+          console.log("CHECKING FOR FIELD:", message.payload);
+          const field = this.form.fields.find((field2) => field2.name === message.payload.fieldName);
+          console.log("FIELD:", field);
+          if (field?.eventHandlers?.onChange) {
+            field.eventHandlers.onChange(message.payload.value);
+          }
+          if (this.eventHandlers.onFieldValueChanged) {
+            this.eventHandlers.onFieldValueChanged(message.payload.fieldName, message.payload.value);
+          }
+          return;
+        case "event-error":
+          if (this.eventHandlers.onError) {
+            this.eventHandlers.onError(message.payload);
+          }
+          return;
+        case "event-critical-error":
+          if (this.eventHandlers.onCriticalError) {
+            this.eventHandlers.onCriticalError(message.payload);
+            this.stop();
+          }
+          return;
+        default:
+          console.error("Unknown event type:", message.type);
+          break;
+      }
+    }
+  };
+  function createAudioElement() {
+    const element = document.createElement("audio");
+    element.id = "veform-audio";
+    element.style.opacity = "0";
+    element.style.position = "absolute";
+    element.style.bottom = "0";
+    element.style.right = "0";
+    element.style.width = "100%";
+    element.style.height = "100%";
+    document.body.appendChild(element);
+    return element;
+  }
+  return __toCommonJS(dist_exports);
+})();

package/dist/veform.browser.min.js

@@ -0,0 +1 @@
+"use strict";var Veform=(()=>{var C=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var w=(t,e)=>{for(var n in e)C(t,n,{get:e[n],enumerable:!0})},A=(t,e,n,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of H(e))!m.call(t,i)&&i!==n&&C(t,i,{get:()=>e[i],enumerable:!(o=y(e,i))||o.enumerable});return t};var O=t=>A(C({},"__esModule",{value:!0}),t);var R={};w(R,{Field:()=>s,InfoField:()=>v,MultiselectField:()=>u,NumberField:()=>c,SelectField:()=>h,TextAreaField:()=>p,TextField:()=>d,Veform:()=>E,VeformBuilder:()=>a,YesNoField:()=>f});var r;(function(t){t.TEXT="text",t.TEXTAREA="textarea",t.SELECT="select",t.MULTISELECT="multiselect",t.YESNO="yesNo",t.NUMBER="number",t.INFO="info"})(r||(r={}));var s=class{constructor(e,n,o,i,g={}){this.name=e,this.question=n,this.type=o,this.eventConfig=i,this.eventHandlers=g}addBehavior(e,n){if(this.eventConfig||(this.eventConfig={}),this.eventConfig[e]||(this.eventConfig[e]=[]),n.type===l.MOVE_TO){let o=this.eventConfig[e].findIndex(i=>i.type===l.MOVE_TO);o!==-1?this.eventConfig[e][o]=n:this.eventConfig[e].push(n)}else this.eventConfig[e].push(n)}onFocus(e){this.eventHandlers.onFocus=e}onChange(e){this.eventHandlers.onChange=e}},S;(function(t){t.VALID_ANSWER="validAnswer",t.INVALID_ANSWER="invalidAnswer",t.MOVE_REQUESTED="moveRequested",t.END_REQUESTED="endRequested",t.VALID_YES_ANSWER="validYesAnswer",t.VALID_NO_ANSWER="validNoAnswer"})(S||(S={}));var l;(function(t){t.MOVE_TO="moveTo",t.OUTPUT="output"})(l||(l={}));var d=class extends s{constructor(e,n,o){super(e,n,r.TEXT,o)}addValidation(e){this.textFieldValidation=e}},c=class extends s{constructor(e,n,o){super(e,n,r.NUMBER,o)}addValidation(e){this.numberFieldValidation=e}},h=class extends s{constructor(e,n,o){super(e,n,r.SELECT,o),this.selectFieldValidation={validate:!0,selectOptions:[]}}addSelectOption(e){this.selectFieldValidation?.selectOptions?.push(e)}},u=class extends s{constructor(e,n,o){super(e,n,r.MULTISELECT,o)}addSelectOption(e){this.multiselectFieldValidation?.selectOptions?.push(e)}},f=class extends s{constructor(e,n,o){super(e,n,r.YESNO,o)}addValidation(e){this.yesNoFieldValidation=e}},p=class extends s{constructor(e,n,o){super(e,n,r.TEXTAREA,o)}addValidation(e){this.textAreaFieldValidation=e}},v=class extends s{constructor(e,n,o){super(e,n,r.INFO,o)}},a=class{constructor(){this.fields=[]}addField({name:e,question:n,type:o}){if(this.getField(e))return console.error(`Field with name ${e} already exists`),null;if(e.length===0||n.length===0)return console.error(`Field with name ${e} and question ${n} has invalid name or question`),null;let i;switch(o){case r.TEXT:i=new d(e,n);break;case r.TEXTAREA:i=new p(e,n);break;case r.SELECT:i=new h(e,n);break;case r.YESNO:i=new f(e,n);break;case r.NUMBER:i=new c(e,n);break;case r.INFO:i=new v(e,n);break;case r.MULTISELECT:i=new u(e,n);break;default:return console.error(`Field with name ${e} has invalid type ${o}`),null}return this.fields.push(i),i}getField(e){return this.fields.find(n=>n.name===e)}getFields(){return this.fields}setField(e,n){let o=this.fields.findIndex(i=>i.name===e);return o!==-1?(this.fields[o]=n,!0):!1}removeField(e){let n=this.fields.findIndex(o=>o.name===e);return n!==-1?(this.fields.splice(n,1),!0):!1}};var x="ws://localhost:8080/ws",E=class{constructor(e){this.connected=!1,this.eventHandlers={},this.localStream=null,this.peerConnection=null,this.wsConnection=null,this.audioElement=null,e instanceof a?this.form={fields:e.getFields()}:this.form={fields:e}}onLoadingStarted(e){this.eventHandlers.onLoadingStarted=e}onRunningStarted(e){this.eventHandlers.onRunningStarted=e}onFinished(e){this.eventHandlers.onFinished=e}onError(e){this.eventHandlers.onError=e}onCriticalError(e){this.eventHandlers.onCriticalError=e}onAudioInStart(e){this.eventHandlers.onAudioInStart=e}onAudioInEnd(e){this.eventHandlers.onAudioInEnd=e}onAudioOutStart(e){this.eventHandlers.onAudioOutStart=e}onAudioOutEnd(e){this.eventHandlers.onAudioOutEnd=e}onFieldValueChanged(e){this.eventHandlers.onFieldValueChanged=e}onFocusChanged(e){this.eventHandlers.onFocusChanged=e}async start(e){if(!this.form?.fields||this.form?.fields.length===0)return console.error("No fields provided or token URL"),!1;if(this.connected||this.wsConnection||this.peerConnection||this.localStream)return console.error("Start already called, try running stop() or creating a new instance"),!1;try{return e.startsWith("http")&&(console.log("Fetching token from URL",e),e=await fetch(e,{method:"POST"}).then(n=>n.json()).then(n=>n.token)),e?(this.audioElement=N(),this.eventHandlers.onLoadingStarted&&this.eventHandlers.onLoadingStarted(),this.localStream=await navigator.mediaDevices.getUserMedia({audio:{echoCancellation:!0,noiseSuppression:!0,sampleRate:48e3,channelCount:1},video:!1}),this.peerConnection=new RTCPeerConnection,this.localStream.getTracks().forEach(n=>{if(!this.localStream||!this.peerConnection){console.error("Local stream or peer connection not established");return}this.peerConnection?.addTrack(n,this.localStream)}),this.peerConnection.oniceconnectionstatechange=()=>{this.peerConnection?.iceConnectionState==="connected"?(this.connected=!0,console.log("Peer connection connected")):this.peerConnection?.iceConnectionState==="disconnected"?console.log("Peer connection disconnected"):this.peerConnection?.iceConnectionState==="failed"&&this.eventHandlers.onError&&this.eventHandlers.onError("Connection to server failed")},this.peerConnection.ontrack=n=>{if(!this.audioElement){console.error("Audio element not found");return}let o=n.streams[0];this.audioElement.srcObject=o,this.audioElement.play().catch(i=>console.error("Play error:",i))},this.wsConnection=new WebSocket(x+"?token="+e),this.wsConnection.onmessage=n=>{let o=JSON.parse(n.data);if(!this.peerConnection){console.error("WS response, Peer connection not established");return}if(o.type==="answer"){let i=new RTCSessionDescription(o.payload);this.peerConnection.setRemoteDescription(i)}else if(o.type==="ice-candidate"){let i=new RTCIceCandidate(o.payload);this.peerConnection.addIceCandidate(i)}else this.resolveWsMessage(o)},this.wsConnection.onopen=async()=>{if(!this.peerConnection){console.error("Peer connection not established");return}let n=await this.peerConnection.createOffer();await this.peerConnection.setLocalDescription(n),this.peerConnection.onicecandidate=o=>{o.candidate&&this.wsConnection?.send(JSON.stringify({type:"ice-candidate",payload:o.candidate}))},this.wsConnection?.send(JSON.stringify({type:"offer",payload:this.peerConnection?.localDescription})),this.wsConnection?.send(JSON.stringify({type:"form",payload:this.form}))},!0):(console.error("No token provided or returned from token URL"),!1)}catch(n){return console.error("Error starting conversation:",n),this.connected=!1,this.wsConnection=null,this.peerConnection=null,this.localStream=null,!1}}stop(){if(console.log("Stop called"),!this.connected){console.error("Not connected to veform server");return}this.connected=!1,this.wsConnection?.close(),this.wsConnection=null,this.peerConnection?.close(),this.peerConnection=null,this.localStream?.getTracks().forEach(e=>{e.stop()}),this.localStream=null}emitAudio(e,n=!1){console.log("Emit audio called",e)}changeField(e,n=!1){console.log("Change field called",e,n)}interrupt(){console.log("Interrupt called")}resolveWsMessage(e){switch(console.log("RAW WS MESSAGE:",e),e.type){case"event-start":this.eventHandlers.onRunningStarted&&this.eventHandlers.onRunningStarted();return;case"event-end":this.eventHandlers.onFinished&&this.eventHandlers.onFinished();return;case"event-audio-out-start":this.eventHandlers.onAudioOutStart&&this.eventHandlers.onAudioOutStart(e.payload)&&console.log("Audio out start interrupted");return;case"event-audio-out-end":this.eventHandlers.onAudioOutEnd&&this.eventHandlers.onAudioOutEnd();return;case"event-input-start":this.eventHandlers.onAudioInStart&&this.eventHandlers.onAudioInStart();return;case"event-input-end":this.eventHandlers.onAudioInEnd&&this.eventHandlers.onAudioInEnd(e.payload)&&console.log("Audio in end interrupted");return;case"event-focus-changed":if(this.eventHandlers.onFocusChanged&&this.eventHandlers.onFocusChanged(e.payload.previousName,e.payload.nextName)){console.log("Focus changed interrupted");return}let n=this.form.fields.find(i=>i.name===e.payload.nextName);n?.eventHandlers?.onFocus&&n.eventHandlers.onFocus(e.payload.previousName);return;case"event-field-value-changed":console.log("CHECKING FOR FIELD:",e.payload);let o=this.form.fields.find(i=>i.name===e.payload.fieldName);console.log("FIELD:",o),o?.eventHandlers?.onChange&&o.eventHandlers.onChange(e.payload.value),this.eventHandlers.onFieldValueChanged&&this.eventHandlers.onFieldValueChanged(e.payload.fieldName,e.payload.value);return;case"event-error":this.eventHandlers.onError&&this.eventHandlers.onError(e.payload);return;case"event-critical-error":this.eventHandlers.onCriticalError&&(this.eventHandlers.onCriticalError(e.payload),this.stop());return;default:console.error("Unknown event type:",e.type);break}}};function N(){let t=document.createElement("audio");return t.id="veform-audio",t.style.opacity="0",t.style.position="absolute",t.style.bottom="0",t.style.right="0",t.style.width="100%",t.style.height="100%",document.body.appendChild(t),t}return O(R);})();

package/dist/veform.d.ts

@@ -0,0 +1,102 @@
+import { Field, VeformBuilder } from './veform-builder';
+type EventHandlers = {
+    /**
+    * Called immediately after start() is called
+    */
+    onLoadingStarted?: () => void;
+    /**
+     * Called when connections established and conversation begins
+     * This can be treated as a loading finished event
+    */
+    onRunningStarted?: () => void;
+    /**
+     * Called when conversation is complete
+    */
+    onFinished?: () => void;
+    /**
+     * Called when an error occurs.
+     * Veform will attempt to recover from these errors.
+    */
+    onError?: (error: string) => void;
+    /**
+     * Called when a critical error occurs.
+     * veform audio will output a generic error and end the conversation when these occur.
+    */
+    onCriticalError?: (error: string) => void;
+    /**
+     * Called when user talking is detected
+    */
+    onAudioInStart?: () => void;
+    /**
+     * Called when user done talking is detected
+        Returning true blocks veform from processing this input and continuing the conversation.
+     * If you block this you must call `changeField` or`emitAudio` to keep the conversation going.
+     */
+    onAudioInEnd?: (input: string) => boolean;
+    /**
+     * Called before audio output starts.
+     * Returning true blocks veform from emitting this output and continuing the conversation.
+     * If you block this you must call `changeField` or`emitAudio` to keep the conversation going.
+    */
+    onAudioOutStart?: (chunk: string) => boolean;
+    /**
+     * Called when audio output ends
+     */
+    onAudioOutEnd?: () => void;
+    /**
+     * Called when the current field focus changes
+     * Returning true blocks veform from changing the field and continuing the conversation.
+     * If you block this you must call `changeField` or `emitAudio` to keep the conversation going.
+    */
+    onFocusChanged?: (previousName: string, nextName: string) => boolean;
+    /**
+     * Called when an answer is provided to a field
+     */
+    onFieldValueChanged?: (fieldName: string, answer: string | number | boolean) => void;
+};
+export declare class Veform {
+    private connected;
+    private form;
+    private eventHandlers;
+    private localStream;
+    private peerConnection;
+    private wsConnection;
+    private audioElement;
+    constructor(fields: Field[] | VeformBuilder);
+    onLoadingStarted(callback: EventHandlers['onLoadingStarted']): void;
+    onRunningStarted(callback: EventHandlers['onRunningStarted']): void;
+    onFinished(callback: EventHandlers['onFinished']): void;
+    onError(callback: EventHandlers['onError']): void;
+    onCriticalError(callback: EventHandlers['onCriticalError']): void;
+    onAudioInStart(callback: EventHandlers['onAudioInStart']): void;
+    onAudioInEnd(callback: EventHandlers['onAudioInEnd']): void;
+    onAudioOutStart(callback: EventHandlers['onAudioOutStart']): void;
+    onAudioOutEnd(callback: EventHandlers['onAudioOutEnd']): void;
+    onFieldValueChanged(callback: EventHandlers['onFieldValueChanged']): void;
+    onFocusChanged(callback: EventHandlers['onFocusChanged']): void;
+    /**
+     * Start the conversation
+     * This will connect the client the the veform server with the current set of fields
+     */
+    start(token: string): Promise<boolean>;
+    /**
+     * Stop the conversation, this will cut off audio mid output
+     */
+    stop(): void;
+    /**
+     * Emit audio to client
+     * interrupt: if true, will interrupt the current output, otherwise will be queued behind current audio
+     */
+    emitAudio(audio: string, interrupt?: boolean): void;
+    /**
+     * Change the current field
+     * This will change the current field to the one provided
+     */
+    changeField(fieldName: string, interrupt?: boolean): void;
+    /**
+     * Stop current audio output
+     */
+    interrupt(): void;
+    private resolveWsMessage;
+}
+export {};

package/dist/veform.js

@@ -0,0 +1,305 @@
+import { VeformBuilder } from './veform-builder';
+const DEFAULT_SERVER_URL = 'ws://localhost:8080/ws';
+// this is what exposes all the cancelable events to user
+export class Veform {
+    constructor(fields) {
+        this.connected = false;
+        this.eventHandlers = {};
+        this.localStream = null;
+        this.peerConnection = null;
+        this.wsConnection = null;
+        this.audioElement = null;
+        if (fields instanceof VeformBuilder) {
+            this.form = { fields: fields.getFields() };
+        }
+        else {
+            this.form = { fields: fields };
+        }
+    }
+    onLoadingStarted(callback) {
+        this.eventHandlers.onLoadingStarted = callback;
+    }
+    onRunningStarted(callback) {
+        this.eventHandlers.onRunningStarted = callback;
+    }
+    onFinished(callback) {
+        this.eventHandlers.onFinished = callback;
+    }
+    onError(callback) {
+        this.eventHandlers.onError = callback;
+    }
+    onCriticalError(callback) {
+        this.eventHandlers.onCriticalError = callback;
+    }
+    onAudioInStart(callback) {
+        this.eventHandlers.onAudioInStart = callback;
+    }
+    onAudioInEnd(callback) {
+        this.eventHandlers.onAudioInEnd = callback;
+    }
+    onAudioOutStart(callback) {
+        this.eventHandlers.onAudioOutStart = callback;
+    }
+    onAudioOutEnd(callback) {
+        this.eventHandlers.onAudioOutEnd = callback;
+    }
+    onFieldValueChanged(callback) {
+        this.eventHandlers.onFieldValueChanged = callback;
+    }
+    onFocusChanged(callback) {
+        this.eventHandlers.onFocusChanged = callback;
+    }
+    /**
+     * Start the conversation
+     * This will connect the client the the veform server with the current set of fields
+     */
+    async start(token) {
+        if (!this.form?.fields || this.form?.fields.length === 0) {
+            console.error('No fields provided or token URL');
+            return false;
+        }
+        if (this.connected || this.wsConnection || this.peerConnection || this.localStream) {
+            console.error('Start already called, try running stop() or creating a new instance');
+            return false;
+        }
+        try {
+            if (token.startsWith('http')) {
+                console.log('Fetching token from URL', token);
+                token = await fetch(token, { method: 'POST' }).then(response => response.json()).then(data => data.token);
+            }
+            if (!token) {
+                console.error('No token provided or returned from token URL');
+                return false;
+            }
+            this.audioElement = createAudioElement();
+            if (this.eventHandlers.onLoadingStarted) {
+                this.eventHandlers.onLoadingStarted();
+            }
+            // get local audio track
+            this.localStream = await navigator.mediaDevices.getUserMedia({
+                audio: {
+                    echoCancellation: true,
+                    noiseSuppression: true,
+                    sampleRate: 48000,
+                    channelCount: 1,
+                },
+                video: false,
+            });
+            // setup local peerconnection
+            this.peerConnection = new RTCPeerConnection();
+            this.localStream.getTracks().forEach((track) => {
+                if (!this.localStream || !this.peerConnection) {
+                    console.error('Local stream or peer connection not established');
+                    return;
+                }
+                this.peerConnection?.addTrack(track, this.localStream);
+            });
+            this.peerConnection.oniceconnectionstatechange = () => {
+                if (this.peerConnection?.iceConnectionState === 'connected') {
+                    this.connected = true;
+                    console.log('Peer connection connected');
+                }
+                else if (this.peerConnection?.iceConnectionState === 'disconnected') {
+                    console.log('Peer connection disconnected');
+                }
+                else if (this.peerConnection?.iceConnectionState === 'failed') {
+                    if (this.eventHandlers.onError) {
+                        this.eventHandlers.onError('Connection to server failed');
+                    }
+                }
+            };
+            this.peerConnection.ontrack = (event) => {
+                if (!this.audioElement) {
+                    console.error('Audio element not found');
+                    return;
+                }
+                const stream = event.streams[0];
+                this.audioElement.srcObject = stream;
+                this.audioElement.play().catch((e) => console.error("Play error:", e));
+            };
+            // create websocket connection
+            this.wsConnection = new WebSocket(DEFAULT_SERVER_URL + '?token=' + token);
+            this.wsConnection.onmessage = (event) => {
+                const message = JSON.parse(event.data);
+                if (!this.peerConnection) {
+                    console.error('WS response, Peer connection not established');
+                    return;
+                }
+                if (message.type === "answer") {
+                    const answer = new RTCSessionDescription(message.payload);
+                    this.peerConnection.setRemoteDescription(answer);
+                }
+                else if (message.type === "ice-candidate") {
+                    const candidate = new RTCIceCandidate(message.payload);
+                    this.peerConnection.addIceCandidate(candidate);
+                }
+                else {
+                    this.resolveWsMessage(message);
+                }
+            };
+            this.wsConnection.onopen = async () => {
+                if (!this.peerConnection) {
+                    console.error('Peer connection not established');
+                    return;
+                }
+                const offer = await this.peerConnection.createOffer();
+                await this.peerConnection.setLocalDescription(offer);
+                this.peerConnection.onicecandidate = (event) => {
+                    if (event.candidate) {
+                        this.wsConnection?.send(JSON.stringify({
+                            type: "ice-candidate",
+                            payload: event.candidate,
+                        }));
+                    }
+                };
+                this.wsConnection?.send(JSON.stringify({
+                    type: "offer",
+                    payload: this.peerConnection?.localDescription,
+                }));
+                this.wsConnection?.send(JSON.stringify({
+                    type: "form",
+                    payload: this.form,
+                }));
+            };
+            return true;
+        }
+        catch (error) {
+            console.error('Error starting conversation:', error);
+            this.connected = false;
+            this.wsConnection = null;
+            this.peerConnection = null;
+            this.localStream = null;
+            return false;
+        }
+    }
+    /**
+     * Stop the conversation, this will cut off audio mid output
+     */
+    stop() {
+        console.log('Stop called');
+        if (!this.connected) {
+            console.error('Not connected to veform server');
+            return;
+        }
+        this.connected = false;
+        this.wsConnection?.close();
+        this.wsConnection = null;
+        this.peerConnection?.close();
+        this.peerConnection = null;
+        this.localStream?.getTracks().forEach((track) => {
+            track.stop();
+        });
+        this.localStream = null;
+    }
+    /**
+     * Emit audio to client
+     * interrupt: if true, will interrupt the current output, otherwise will be queued behind current audio
+     */
+    emitAudio(audio, interrupt = false) {
+        console.log('Emit audio called', audio);
+    }
+    /**
+     * Change the current field
+     * This will change the current field to the one provided
+     */
+    changeField(fieldName, interrupt = false) {
+        console.log('Change field called', fieldName, interrupt);
+    }
+    /**
+     * Stop current audio output
+     */
+    interrupt() {
+        console.log('Interrupt called');
+    }
+    resolveWsMessage(message) {
+        console.log('RAW WS MESSAGE:', message);
+        switch (message.type) {
+            case "event-start":
+                if (this.eventHandlers.onRunningStarted) {
+                    this.eventHandlers.onRunningStarted();
+                }
+                return;
+            case "event-end":
+                if (this.eventHandlers.onFinished) {
+                    this.eventHandlers.onFinished();
+                }
+                return;
+            case "event-audio-out-start":
+                if (this.eventHandlers.onAudioOutStart) {
+                    const interrupt = this.eventHandlers.onAudioOutStart(message.payload);
+                    if (interrupt) {
+                        console.log('Audio out start interrupted');
+                    }
+                }
+                return;
+            case "event-audio-out-end":
+                if (this.eventHandlers.onAudioOutEnd) {
+                    this.eventHandlers.onAudioOutEnd();
+                }
+                return;
+            case "event-input-start":
+                if (this.eventHandlers.onAudioInStart) {
+                    this.eventHandlers.onAudioInStart();
+                }
+                return;
+            case "event-input-end":
+                if (this.eventHandlers.onAudioInEnd) {
+                    const interrupt = this.eventHandlers.onAudioInEnd(message.payload);
+                    if (interrupt) {
+                        console.log('Audio in end interrupted');
+                    }
+                }
+                return;
+            case "event-focus-changed":
+                if (this.eventHandlers.onFocusChanged) {
+                    const interrupt = this.eventHandlers.onFocusChanged(message.payload.previousName, message.payload.nextName);
+                    if (interrupt) {
+                        console.log('Focus changed interrupted');
+                        return;
+                    }
+                }
+                const nextField = this.form.fields.find((field) => field.name === message.payload.nextName);
+                if (nextField?.eventHandlers?.onFocus) {
+                    nextField.eventHandlers.onFocus(message.payload.previousName);
+                }
+                return;
+            case "event-field-value-changed":
+                console.log('CHECKING FOR FIELD:', message.payload);
+                const field = this.form.fields.find((field) => field.name === message.payload.fieldName);
+                console.log('FIELD:', field);
+                if (field?.eventHandlers?.onChange) {
+                    field.eventHandlers.onChange(message.payload.value);
+                }
+                if (this.eventHandlers.onFieldValueChanged) {
+                    this.eventHandlers.onFieldValueChanged(message.payload.fieldName, message.payload.value);
+                }
+                return;
+            case "event-error":
+                if (this.eventHandlers.onError) {
+                    this.eventHandlers.onError(message.payload);
+                }
+                return;
+            case "event-critical-error":
+                if (this.eventHandlers.onCriticalError) {
+                    this.eventHandlers.onCriticalError(message.payload);
+                    this.stop();
+                }
+                return;
+            default:
+                console.error('Unknown event type:', message.type);
+                break;
+        }
+    }
+}
+function createAudioElement() {
+    const element = document.createElement('audio');
+    element.id = 'veform-audio';
+    element.style.opacity = '0';
+    element.style.position = 'absolute';
+    element.style.bottom = '0';
+    element.style.right = '0';
+    element.style.width = '100%';
+    element.style.height = '100%';
+    document.body.appendChild(element);
+    return element;
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "veform-js",
+  "version": "0.1.0",
+  "description": "Veform JavaScript/TypeScript library",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc && node build.js",
+    "prepare": "yarn build",
+    "watch": "tsc --watch"
+  },
+  "keywords": [
+    "veform"
+  ],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "esbuild": "^0.19.0"
+  },
+  "files": [
+    "dist"
+  ]
+}