@mobilerun/sdk 5.1.0 → 5.2.0

package/src/resources/workflows/flows/flows.ts

@@ -24,21 +24,28 @@ export class Flows extends APIResource {
   actions: ActionsAPI.Actions = new ActionsAPI.Actions(this._client);
 
   /**
-   * Create a flow
+   * Create a flow that binds a trigger (`triggerId`) to an ordered list of actions,
+   * with at least one action required. Optional settings include target `deviceIds`,
+   * a cooldown (`cooldownSeconds`/`cooldownScope`), and webhook notifications on
+   * success or failure.
    */
   create(body: FlowCreateParams, options?: RequestOptions): APIPromise<FlowCreateResponse> {
     return this._client.post('/flows', { body, ...options });
   }
 
   /**
-   * Get a flow
+   * Fetch a single flow by its ID, including its trigger binding, configuration, and
+   * current status. Returns 404 if no flow matches.
    */
   retrieve(flowID: string, options?: RequestOptions): APIPromise<FlowRetrieveResponse> {
     return this._client.get(path`/flows/${flowID}`, options);
   }
 
   /**
-   * Update a flow
+   * Partially update a flow's settings — name, trigger binding, enabled state,
+   * target devices, cooldown, or notifications; all fields are optional. Actions are
+   * managed through the flow-actions endpoints, not here. Returns 404 if the flow
+   * does not exist.
    */
   update(
     flowID: string,
@@ -49,7 +56,10 @@ export class Flows extends APIResource {
   }
 
   /**
-   * List flows
+   * Return a paginated list of flows. Supports filtering by `triggerId`, `enabled`,
+   * one or more health `status` values (healthy, failing, blocked), `mine` (flows
+   * created by the calling actor), `createdBy` (flows created by a given actor id —
+   * mutually exclusive with `mine`), plus free-text `search` and ordering.
    */
   list(
     query: FlowListParams | null | undefined = {},
@@ -59,14 +69,16 @@ export class Flows extends APIResource {
   }
 
   /**
-   * Delete a flow
+   * Delete a flow by its ID. Returns 404 if no flow matches.
    */
   delete(flowID: string, options?: RequestOptions): APIPromise<FlowDeleteResponse> {
     return this._client.delete(path`/flows/${flowID}`, options);
   }
 
   /**
-   * Clone a flow
+   * Create a copy of an existing flow, including its actions and settings. The
+   * optional body can override the new flow's `name` and target `deviceIds`. Returns
+   * 404 if the source flow does not exist.
    */
   clone(
     flowID: string,
@@ -148,11 +160,17 @@ export interface FlowCreateParams {
 
   enabled?: boolean;
 
+  healthMonitoringEnabled?: boolean;
+
   notifyOnFailure?: boolean;
 
   notifyOnSuccess?: boolean;
 
   notifyWebhookId?: string | null;
+
+  selfHealingEnabled?: boolean;
+
+  selfHealingMaxAttempts?: number;
 }
 
 export namespace FlowCreateParams {
@@ -182,6 +200,8 @@ export interface FlowUpdateParams {
 
   enabled?: boolean;
 
+  healthMonitoringEnabled?: boolean;
+
   name?: string;
 
   notifyOnFailure?: boolean;
@@ -190,11 +210,25 @@ export interface FlowUpdateParams {
 
   notifyWebhookId?: string | null;
 
+  selfHealingEnabled?: boolean;
+
+  selfHealingMaxAttempts?: number;
+
   triggerId?: string;
 }
 
 export interface FlowListParams {
-  enabled?: boolean | null;
+  createdBy?: string;
+
+  /**
+   * Only include flows with this enabled state.
+   */
+  enabled?: 'true' | 'false';
+
+  /**
+   * Only include flows created by you.
+   */
+  mine?: 'true' | 'false';
 
   orderBy?: 'name' | 'createdAt' | 'updatedAt';
 

package/src/resources/workflows/triggers.ts

@@ -8,21 +8,27 @@ import { path } from '../../internal/utils/path';
 
 export class Triggers extends APIResource {
   /**
-   * Create a trigger
+   * Create a trigger with an activation type of `event`, `schedule`, or `custom`.
+   * Each type requires its own fields (e.g. `eventType` and optional `conditions`
+   * for events, `scheduleRule` and `timezone` for schedules, `customPayloadSchema`
+   * for custom triggers); mismatched fields are rejected.
    */
   create(body: TriggerCreateParams, options?: RequestOptions): APIPromise<TriggerCreateResponse> {
     return this._client.post('/triggers', { body, ...options });
   }
 
   /**
-   * Get a trigger
+   * Fetch a single trigger by its ID, including its activation type and
+   * type-specific configuration. Returns 404 if no trigger matches.
    */
   retrieve(triggerID: string, options?: RequestOptions): APIPromise<TriggerRetrieveResponse> {
     return this._client.get(path`/triggers/${triggerID}`, options);
   }
 
   /**
-   * Update a trigger
+   * Partially update a trigger; all fields are optional. When `activation` is
+   * changed, the type-specific field rules are re-validated. Returns 404 if the
+   * trigger does not exist.
    */
   update(
     triggerID: string,
@@ -33,7 +39,8 @@ export class Triggers extends APIResource {
   }
 
   /**
-   * List triggers
+   * Return a paginated list of triggers. Supports filtering by `activation` and
+   * `eventType`, free-text `search`, and ordering by name, createdAt, or updatedAt.
    */
   list(
     query: TriggerListParams | null | undefined = {},
@@ -43,7 +50,7 @@ export class Triggers extends APIResource {
   }
 
   /**
-   * Delete a trigger
+   * Delete a trigger by its ID. Returns 404 if no trigger matches.
    */
   delete(triggerID: string, options?: RequestOptions): APIPromise<TriggerDeleteResponse> {
     return this._client.delete(path`/triggers/${triggerID}`, options);
@@ -89,6 +96,8 @@ export namespace TriggerCreateResponse {
 
     createdAt: string | null;
 
+    createdBy: string | null;
+
     customPayloadSchema: { [key: string]: unknown } | null;
 
     description: string | null;
@@ -97,12 +106,17 @@ export namespace TriggerCreateResponse {
 
     name: string;
 
+    ownerId: string;
+
     scheduleRule: Data.ScheduleRule;
 
     timezone: string | null;
 
     updatedAt: string | null;
 
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
     userId: string;
 
     conditions?: unknown;
@@ -124,11 +138,27 @@ export namespace TriggerCreateResponse {
        */
       expression?: string;
 
+      /**
+       * Optional per-occurrence random window around the nominal schedule time
+       */
+      jitter?: ScheduleRule.Jitter;
+
       /**
        * RRULE string (for type=recurring)
        */
       rrule?: string;
     }
+
+    export namespace ScheduleRule {
+      /**
+       * Optional per-occurrence random window around the nominal schedule time
+       */
+      export interface Jitter {
+        afterMinutes?: number;
+
+        beforeMinutes?: number;
+      }
+    }
   }
 }
 
@@ -144,6 +174,8 @@ export namespace TriggerRetrieveResponse {
 
     createdAt: string | null;
 
+    createdBy: string | null;
+
     customPayloadSchema: { [key: string]: unknown } | null;
 
     description: string | null;
@@ -152,39 +184,23 @@ export namespace TriggerRetrieveResponse {
 
     name: string;
 
-    scheduleRule: Data.ScheduleRule | null;
+    ownerId: string;
+
+    scheduleRule: unknown;
 
     timezone: string | null;
 
     updatedAt: string | null;
 
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
     userId: string;
 
     conditions?: unknown;
 
     nextFireTime?: string | null;
   }
-
-  export namespace Data {
-    export interface ScheduleRule {
-      type: 'once' | 'cron' | 'recurring';
-
-      /**
-       * ISO 8601 datetime (for type=once)
-       */
-      dateTime?: string;
-
-      /**
-       * Cron expression (for type=cron)
-       */
-      expression?: string;
-
-      /**
-       * RRULE string (for type=recurring)
-       */
-      rrule?: string;
-    }
-  }
 }
 
 export interface TriggerUpdateResponse {
@@ -199,6 +215,8 @@ export namespace TriggerUpdateResponse {
 
     createdAt: string | null;
 
+    createdBy: string | null;
+
     customPayloadSchema: { [key: string]: unknown } | null;
 
     description: string | null;
@@ -207,39 +225,23 @@ export namespace TriggerUpdateResponse {
 
     name: string;
 
-    scheduleRule: Data.ScheduleRule | null;
+    ownerId: string;
+
+    scheduleRule: unknown;
 
     timezone: string | null;
 
     updatedAt: string | null;
 
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
     userId: string;
 
     conditions?: unknown;
 
     nextFireTime?: string | null;
   }
-
-  export namespace Data {
-    export interface ScheduleRule {
-      type: 'once' | 'cron' | 'recurring';
-
-      /**
-       * ISO 8601 datetime (for type=once)
-       */
-      dateTime?: string;
-
-      /**
-       * Cron expression (for type=cron)
-       */
-      expression?: string;
-
-      /**
-       * RRULE string (for type=recurring)
-       */
-      rrule?: string;
-    }
-  }
 }
 
 export interface TriggerListResponse {
@@ -256,6 +258,8 @@ export namespace TriggerListResponse {
 
     createdAt: string | null;
 
+    createdBy: string | null;
+
     customPayloadSchema: { [key: string]: unknown } | null;
 
     description: string | null;
@@ -264,39 +268,23 @@ export namespace TriggerListResponse {
 
     name: string;
 
-    scheduleRule: Item.ScheduleRule | null;
+    ownerId: string;
+
+    scheduleRule: unknown;
 
     timezone: string | null;
 
     updatedAt: string | null;
 
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
     userId: string;
 
     conditions?: unknown;
 
     nextFireTime?: string | null;
   }
-
-  export namespace Item {
-    export interface ScheduleRule {
-      type: 'once' | 'cron' | 'recurring';
-
-      /**
-       * ISO 8601 datetime (for type=once)
-       */
-      dateTime?: string;
-
-      /**
-       * Cron expression (for type=cron)
-       */
-      expression?: string;
-
-      /**
-       * RRULE string (for type=recurring)
-       */
-      rrule?: string;
-    }
-  }
 }
 
 export interface TriggerDeleteResponse {
@@ -358,11 +346,27 @@ export namespace TriggerCreateParams {
      */
     expression?: string;
 
+    /**
+     * Optional per-occurrence random window around the nominal schedule time
+     */
+    jitter?: ScheduleRule.Jitter;
+
     /**
      * RRULE string (for type=recurring)
      */
     rrule?: string;
   }
+
+  export namespace ScheduleRule {
+    /**
+     * Optional per-occurrence random window around the nominal schedule time
+     */
+    export interface Jitter {
+      afterMinutes?: number;
+
+      beforeMinutes?: number;
+    }
+  }
 }
 
 export interface TriggerUpdateParams {
@@ -370,10 +374,7 @@ export interface TriggerUpdateParams {
 
   conditions?: TriggerUpdateParams.Conditions;
 
-  /**
-   * Optional JSON Schema for validating payloads sent to this custom trigger
-   */
-  customPayloadSchema?: { [key: string]: unknown } | null;
+  customPayloadSchema?: { [key: string]: unknown };
 
   description?: string;
 
@@ -406,11 +407,27 @@ export namespace TriggerUpdateParams {
      */
     expression?: string;
 
+    /**
+     * Optional per-occurrence random window around the nominal schedule time
+     */
+    jitter?: ScheduleRule.Jitter;
+
     /**
      * RRULE string (for type=recurring)
      */
     rrule?: string;
   }
+
+  export namespace ScheduleRule {
+    /**
+     * Optional per-occurrence random window around the nominal schedule time
+     */
+    export interface Jitter {
+      afterMinutes?: number;
+
+      beforeMinutes?: number;
+    }
+  }
 }
 
 export interface TriggerListParams {

package/src/resources/workflows/workflows.ts

@@ -97,12 +97,16 @@ export interface Flow {
 
   createdAt: string | null;
 
+  createdBy: string | null;
+
   description: string | null;
 
   deviceIds: Array<string>;
 
   enabled: boolean;
 
+  healthMonitoringEnabled: boolean;
+
   lastFailureAt: string | null;
 
   lastFailureCode:
@@ -124,12 +128,29 @@ export interface Flow {
 
   notifyWebhookId: string | null;
 
+  ownerId: string;
+
+  selfHealingEnabled: boolean;
+
+  selfHealingMaxAttempts: number;
+
   status: 'healthy' | 'failing' | 'blocked';
 
+  /**
+   * Template-resolver semantics this flow runs under (MVA-23). 1 = legacy
+   * (missing/forbidden/null all resolve to ''). 2 = typed (missing/forbidden throw,
+   * a whole-token null stays JSON null). Existing flows stay 1; new flows default
+   * to 2.
+   */
+  templateResolutionVersion: number;
+
   triggerId: string;
 
   updatedAt: string | null;
 
+  /**
+   * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+   */
   userId: string;
 }
 

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '5.1.0'; // x-release-please-version
+export const VERSION = '5.2.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.1.0";
+export declare const VERSION = "5.2.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.1.0";
+export declare const VERSION = "5.2.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '5.1.0'; // x-release-please-version
+exports.VERSION = '5.2.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '5.1.0'; // x-release-please-version
+export const VERSION = '5.2.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map