@smplkit/sdk 3.0.56 → 3.0.57

package/dist/index.cjs

@@ -19963,20 +19963,20 @@ var Forwarder = class {
    */
   filter;
   /**
-   * Optional template applied to each event before delivery. Shape
-   * depends on {@link transformType}; for {@link TransformType.JSONATA}
-   * the value is a JSONata expression string, but the wire schema
-   * widens to arbitrary JSON to leave room for future transform engines
-   * carrying structured templates. `null` delivers the event JSON as-is.
+   * Optional template applied to each event before delivery. The wire
+   * schema widens to arbitrary JSON to leave room for future transform
+   * engines carrying structured templates; for
+   * {@link TransformType.JSONATA} the value must be a JSONata
+   * expression string. `null` delivers the event JSON as-is.
    *
-   * Whenever {@link transform} is set, {@link transformType} must also
-   * be set; the SDK enforces this at save time.
+   * {@link transform} and {@link transformType} travel as a pair —
+   * both set, or both `null`. The SDK enforces this at save time.
    */
   transform;
   /**
    * Engine used to evaluate {@link transform}. Required whenever
-   * {@link transform} is set. Today only {@link TransformType.JSONATA}
-   * is supported.
+   * {@link transform} is set, forbidden when it isn't. Today only
+   * {@link TransformType.JSONATA} is supported.
    */
   transformType;
   /**
@@ -20108,10 +20108,18 @@ function _forwarderAttrs(forwarder) {
     attrs.filter = forwarder.filter;
   }
   const hasTransform = forwarder.transform !== null && forwarder.transform !== void 0;
-  if (hasTransform && forwarder.transformType === null) {
-    throw new Error("Forwarder.transform requires Forwarder.transformType to be set");
+  const hasTransformType = forwarder.transformType !== null && forwarder.transformType !== void 0;
+  if (hasTransform !== hasTransformType) {
+    throw new Error(
+      "Forwarder.transform and Forwarder.transformType must be set together (or both unset)"
+    );
   }
   if (hasTransform) {
+    if (forwarder.transformType === "JSONATA" /* JSONATA */ && typeof forwarder.transform !== "string") {
+      throw new Error(
+        "Forwarder.transform must be a string when Forwarder.transformType is JSONATA"
+      );
+    }
     attrs.transform_type = forwarder.transformType;
     attrs.transform = forwarder.transform;
   }
@@ -20156,15 +20164,15 @@ var ForwardersClient = class {
    *                               don't match are recorded as
    *                               `filtered_out` deliveries.
    * @param fields.transformType   Engine used to evaluate `transform`.
-   *                               Required whenever `transform` is set;
-   *                               today only {@link TransformType.JSONATA}
-   *                               is supported.
+   *                               Today only {@link TransformType.JSONATA}
+   *                               is supported. Must be supplied together
+   *                               with `transform` (both or neither).
    * @param fields.transform       Optional template applied to each
    *                               event before delivery. The value is
-   *                               arbitrary JSON — for JSONATA, supply
-   *                               an expression string; future engines
-   *                               may accept other shapes. Omit (or pass
-   *                               `null`) to deliver events unchanged.
+   *                               arbitrary JSON — for JSONATA, it
+   *                               must be a string containing a JSONata
+   *                               expression. Must be supplied together
+   *                               with `transformType` (both or neither).
    */
   new(fields) {
     return new Forwarder(this, {