@smplkit/sdk 3.0.55 → 3.0.57

package/dist/index.d.cts

@@ -304,15 +304,20 @@ declare class Forwarder {
      */
     filter: Record<string, unknown> | null;
     /**
-     * Optional template applied to each event before delivery. Shape
-     * depends on {@link transformType}; for `"JSONATA"`, a JSONata
+     * 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.
+     *
+     * {@link transform} and {@link transformType} travel as a pair —
+     * both set, or both `null`. The SDK enforces this at save time.
      */
-    transform: string | null;
+    transform: unknown;
     /**
-     * Engine used to evaluate {@link transform}. Currently only
-     * `"JSONATA"` is supported. Auto-filled by the SDK whenever
-     * {@link transform} is set on save.
+     * Engine used to evaluate {@link transform}. Required whenever
+     * {@link transform} is set, forbidden when it isn't. Today only
+     * {@link TransformType.JSONATA} is supported.
      */
     transformType: TransformType | null;
     /**
@@ -336,7 +341,7 @@ declare class Forwarder {
         enabled?: boolean;
         description?: string | null;
         filter?: Record<string, unknown> | null;
-        transform?: string | null;
+        transform?: unknown;
         transformType?: TransformType | null;
         createdAt?: string | null;
         updatedAt?: string | null;
@@ -2861,18 +2866,19 @@ declare class ManagementFlagsClient {
 /**
  * Log severity levels used by the Smpl Logging service.
  *
- * Members are declared in alphabetical order. Severity ordering is not
- * derived from declaration order — it lives in the framework adapter
- * code that maps these to each framework's native numeric level.
+ * Members are declared in increasing order of severity per the
+ * convention of every major JS/TS logging library (winston, bunyan,
+ * pino, npm). `SILENT` is the all-suppressing sentinel and sits at
+ * the end.
  */
 declare enum LogLevel {
+    TRACE = "TRACE",
     DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARN = "WARN",
     ERROR = "ERROR",
     FATAL = "FATAL",
-    INFO = "INFO",
-    SILENT = "SILENT",
-    TRACE = "TRACE",
-    WARN = "WARN"
+    SILENT = "SILENT"
 }
 /**
  * Describes a logger effective-level change. Frozen — fields cannot be
@@ -3192,20 +3198,27 @@ declare class ForwardersClient implements ForwarderModelClient {
      * Construct an unsaved {@link Forwarder}. Call {@link Forwarder.save}
      * to persist.
      *
-     * @param fields.name           Display name. Free-form.
-     * @param fields.forwarderType  Destination type — see {@link ForwarderType}.
-     * @param fields.configuration  Destination HTTP request configuration.
-     *                              Headers carry credentials and are
-     *                              encrypted at rest server-side; reads
-     *                              return them redacted.
-     * @param fields.enabled        Whether the forwarder is active. Defaults true.
-     * @param fields.description    Optional free-text description.
-     * @param fields.filter         Optional JSON Logic filter; events that
-     *                              don't match are recorded as
-     *                              `filtered_out` deliveries.
-     * @param fields.transform      Optional JSONata template applied to
-     *                              the event payload before POST. `null`
-     *                              delivers the event as-is.
+     * @param fields.name            Display name. Free-form.
+     * @param fields.forwarderType   Destination type — see {@link ForwarderType}.
+     * @param fields.configuration   Destination HTTP request configuration.
+     *                               Headers carry credentials and are
+     *                               encrypted at rest server-side; reads
+     *                               return them redacted.
+     * @param fields.enabled         Whether the forwarder is active. Defaults true.
+     * @param fields.description     Optional free-text description.
+     * @param fields.filter          Optional JSON Logic filter; events that
+     *                               don't match are recorded as
+     *                               `filtered_out` deliveries.
+     * @param fields.transformType   Engine used to evaluate `transform`.
+     *                               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, it
+     *                               must be a string containing a JSONata
+     *                               expression. Must be supplied together
+     *                               with `transformType` (both or neither).
      */
     new(fields: {
         name: string;
@@ -3214,7 +3227,8 @@ declare class ForwardersClient implements ForwarderModelClient {
         enabled?: boolean;
         description?: string | null;
         filter?: Record<string, unknown> | null;
-        transform?: string | null;
+        transformType?: TransformType | null;
+        transform?: unknown;
     }): Forwarder;
     /**
      * List forwarders for the authenticated account.

package/dist/index.d.ts

@@ -304,15 +304,20 @@ declare class Forwarder {
      */
     filter: Record<string, unknown> | null;
     /**
-     * Optional template applied to each event before delivery. Shape
-     * depends on {@link transformType}; for `"JSONATA"`, a JSONata
+     * 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.
+     *
+     * {@link transform} and {@link transformType} travel as a pair —
+     * both set, or both `null`. The SDK enforces this at save time.
      */
-    transform: string | null;
+    transform: unknown;
     /**
-     * Engine used to evaluate {@link transform}. Currently only
-     * `"JSONATA"` is supported. Auto-filled by the SDK whenever
-     * {@link transform} is set on save.
+     * Engine used to evaluate {@link transform}. Required whenever
+     * {@link transform} is set, forbidden when it isn't. Today only
+     * {@link TransformType.JSONATA} is supported.
      */
     transformType: TransformType | null;
     /**
@@ -336,7 +341,7 @@ declare class Forwarder {
         enabled?: boolean;
         description?: string | null;
         filter?: Record<string, unknown> | null;
-        transform?: string | null;
+        transform?: unknown;
         transformType?: TransformType | null;
         createdAt?: string | null;
         updatedAt?: string | null;
@@ -2861,18 +2866,19 @@ declare class ManagementFlagsClient {
 /**
  * Log severity levels used by the Smpl Logging service.
  *
- * Members are declared in alphabetical order. Severity ordering is not
- * derived from declaration order — it lives in the framework adapter
- * code that maps these to each framework's native numeric level.
+ * Members are declared in increasing order of severity per the
+ * convention of every major JS/TS logging library (winston, bunyan,
+ * pino, npm). `SILENT` is the all-suppressing sentinel and sits at
+ * the end.
  */
 declare enum LogLevel {
+    TRACE = "TRACE",
     DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARN = "WARN",
     ERROR = "ERROR",
     FATAL = "FATAL",
-    INFO = "INFO",
-    SILENT = "SILENT",
-    TRACE = "TRACE",
-    WARN = "WARN"
+    SILENT = "SILENT"
 }
 /**
  * Describes a logger effective-level change. Frozen — fields cannot be
@@ -3192,20 +3198,27 @@ declare class ForwardersClient implements ForwarderModelClient {
      * Construct an unsaved {@link Forwarder}. Call {@link Forwarder.save}
      * to persist.
      *
-     * @param fields.name           Display name. Free-form.
-     * @param fields.forwarderType  Destination type — see {@link ForwarderType}.
-     * @param fields.configuration  Destination HTTP request configuration.
-     *                              Headers carry credentials and are
-     *                              encrypted at rest server-side; reads
-     *                              return them redacted.
-     * @param fields.enabled        Whether the forwarder is active. Defaults true.
-     * @param fields.description    Optional free-text description.
-     * @param fields.filter         Optional JSON Logic filter; events that
-     *                              don't match are recorded as
-     *                              `filtered_out` deliveries.
-     * @param fields.transform      Optional JSONata template applied to
-     *                              the event payload before POST. `null`
-     *                              delivers the event as-is.
+     * @param fields.name            Display name. Free-form.
+     * @param fields.forwarderType   Destination type — see {@link ForwarderType}.
+     * @param fields.configuration   Destination HTTP request configuration.
+     *                               Headers carry credentials and are
+     *                               encrypted at rest server-side; reads
+     *                               return them redacted.
+     * @param fields.enabled         Whether the forwarder is active. Defaults true.
+     * @param fields.description     Optional free-text description.
+     * @param fields.filter          Optional JSON Logic filter; events that
+     *                               don't match are recorded as
+     *                               `filtered_out` deliveries.
+     * @param fields.transformType   Engine used to evaluate `transform`.
+     *                               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, it
+     *                               must be a string containing a JSONata
+     *                               expression. Must be supplied together
+     *                               with `transformType` (both or neither).
      */
     new(fields: {
         name: string;
@@ -3214,7 +3227,8 @@ declare class ForwardersClient implements ForwarderModelClient {
         enabled?: boolean;
         description?: string | null;
         filter?: Record<string, unknown> | null;
-        transform?: string | null;
+        transformType?: TransformType | null;
+        transform?: unknown;
     }): Forwarder;
     /**
      * List forwarders for the authenticated account.

package/dist/index.js

@@ -19211,13 +19211,13 @@ function _coerceValues(values) {
 
 // src/logging/types.ts
 var LogLevel = /* @__PURE__ */ ((LogLevel5) => {
+  LogLevel5["TRACE"] = "TRACE";
   LogLevel5["DEBUG"] = "DEBUG";
+  LogLevel5["INFO"] = "INFO";
+  LogLevel5["WARN"] = "WARN";
   LogLevel5["ERROR"] = "ERROR";
   LogLevel5["FATAL"] = "FATAL";
-  LogLevel5["INFO"] = "INFO";
   LogLevel5["SILENT"] = "SILENT";
-  LogLevel5["TRACE"] = "TRACE";
-  LogLevel5["WARN"] = "WARN";
   return LogLevel5;
 })(LogLevel || {});
 var LoggerChangeEvent = class {
@@ -19893,15 +19893,20 @@ var Forwarder = class {
    */
   filter;
   /**
-   * Optional template applied to each event before delivery. Shape
-   * depends on {@link transformType}; for `"JSONATA"`, a JSONata
+   * 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.
+   *
+   * {@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}. Currently only
-   * `"JSONATA"` is supported. Auto-filled by the SDK whenever
-   * {@link transform} is set on save.
+   * Engine used to evaluate {@link transform}. Required whenever
+   * {@link transform} is set, forbidden when it isn't. Today only
+   * {@link TransformType.JSONATA} is supported.
    */
   transformType;
   /**
@@ -20032,8 +20037,20 @@ function _forwarderAttrs(forwarder) {
   if (forwarder.filter !== null) {
     attrs.filter = forwarder.filter;
   }
-  if (forwarder.transform !== null) {
-    attrs.transform_type = "JSONATA" /* JSONATA */;
+  const hasTransform = forwarder.transform !== null && forwarder.transform !== void 0;
+  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;
   }
   return attrs;
@@ -20065,20 +20082,27 @@ var ForwardersClient = class {
    * Construct an unsaved {@link Forwarder}. Call {@link Forwarder.save}
    * to persist.
    *
-   * @param fields.name           Display name. Free-form.
-   * @param fields.forwarderType  Destination type — see {@link ForwarderType}.
-   * @param fields.configuration  Destination HTTP request configuration.
-   *                              Headers carry credentials and are
-   *                              encrypted at rest server-side; reads
-   *                              return them redacted.
-   * @param fields.enabled        Whether the forwarder is active. Defaults true.
-   * @param fields.description    Optional free-text description.
-   * @param fields.filter         Optional JSON Logic filter; events that
-   *                              don't match are recorded as
-   *                              `filtered_out` deliveries.
-   * @param fields.transform      Optional JSONata template applied to
-   *                              the event payload before POST. `null`
-   *                              delivers the event as-is.
+   * @param fields.name            Display name. Free-form.
+   * @param fields.forwarderType   Destination type — see {@link ForwarderType}.
+   * @param fields.configuration   Destination HTTP request configuration.
+   *                               Headers carry credentials and are
+   *                               encrypted at rest server-side; reads
+   *                               return them redacted.
+   * @param fields.enabled         Whether the forwarder is active. Defaults true.
+   * @param fields.description     Optional free-text description.
+   * @param fields.filter          Optional JSON Logic filter; events that
+   *                               don't match are recorded as
+   *                               `filtered_out` deliveries.
+   * @param fields.transformType   Engine used to evaluate `transform`.
+   *                               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, it
+   *                               must be a string containing a JSONata
+   *                               expression. Must be supplied together
+   *                               with `transformType` (both or neither).
    */
   new(fields) {
     return new Forwarder(this, {
@@ -20088,6 +20112,7 @@ var ForwardersClient = class {
       enabled: fields.enabled,
       description: fields.description,
       filter: fields.filter,
+      transformType: fields.transformType,
       transform: fields.transform
     });
   }