@arizeai/phoenix-client 3.1.0 → 4.0.0

package/dist/esm/spans/types.js

@@ -1,18 +1,51 @@
+/**
+ * Build and validate annotation result fields
+ */
+function buildAnnotationResult(annotation, annotationType) {
+    const result = {};
+    // Build result with trimming for string fields
+    if (annotation.label !== undefined) {
+        result.label = annotation.label.trim() || null;
+    }
+    if (annotation.score !== undefined) {
+        result.score = annotation.score;
+    }
+    if (annotation.explanation !== undefined) {
+        result.explanation = annotation.explanation.trim() || null;
+    }
+    // Validate that at least one result field is provided
+    const hasValidResult = result.label || result.score !== undefined || result.explanation;
+    if (!hasValidResult) {
+        throw new Error(`At least one of label, score, or explanation must be provided for ${annotationType} annotation`);
+    }
+    return result;
+}
 /**
  * Convert a SpanAnnotation to the API format
  */
 export function toSpanAnnotationData(annotation) {
+    const result = buildAnnotationResult(annotation, "span");
+    return {
+        span_id: annotation.spanId.trim(),
+        name: annotation.name.trim(),
+        annotator_kind: annotation.annotatorKind ?? "HUMAN",
+        result,
+        metadata: annotation.metadata ?? null,
+        identifier: annotation.identifier?.trim() ?? "",
+    };
+}
+/**
+ * Convert a DocumentAnnotation to the API format
+ */
+export function toDocumentAnnotationData(annotation) {
+    const result = buildAnnotationResult(annotation, "document");
     return {
-        span_id: annotation.spanId,
-        name: annotation.name,
+        span_id: annotation.spanId.trim(),
+        document_position: annotation.documentPosition,
+        name: annotation.name.trim(),
         annotator_kind: annotation.annotatorKind ?? "HUMAN",
-        result: {
-            label: annotation.label ?? null,
-            score: annotation.score ?? null,
-            explanation: null,
-        },
+        result,
         metadata: annotation.metadata ?? null,
-        identifier: annotation.identifier ?? "",
     };
 }
 //# sourceMappingURL=types.js.map

package/dist/esm/spans/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/spans/types.ts"],"names":[],"mappings":"AAyCA;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA0B;IAE1B,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,MAAM;QAC1B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,cAAc,EAAE,UAAU,CAAC,aAAa,IAAI,OAAO;QACnD,MAAM,EAAE;YACN,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,IAAI;YAC/B,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,IAAI;YAC/B,WAAW,EAAE,IAAI;SAClB;QACD,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,IAAI;QACrC,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,EAAE;KACxC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/spans/types.ts"],"names":[],"mappings":"AA8FA;;GAEG;AACH,SAAS,qBAAqB,CAC5B,UAGC,EACD,cAAmC;IAEnC,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,+CAA+C;IAC/C,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IACjD,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAClC,CAAC;IACD,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC7D,CAAC;IAED,sDAAsD;IACtD,MAAM,cAAc,GAClB,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC;IACnE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,qEAAqE,cAAc,aAAa,CACjG,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA0B;IAE1B,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEzD,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE;QACjC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QAC5B,cAAc,EAAE,UAAU,CAAC,aAAa,IAAI,OAAO;QACnD,MAAM;QACN,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,IAAI;QACrC,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE;KAChD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAA8B;IAE9B,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAE7D,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE;QACjC,iBAAiB,EAAE,UAAU,CAAC,gBAAgB;QAC9C,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QAC5B,cAAc,EAAE,UAAU,CAAC,aAAa,IAAI,OAAO;QACnD,MAAM;QACN,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,IAAI;KACtC,CAAC;AACJ,CAAC"}