@rippling/rippling-sdk 0.2.0-alpha.61 → 0.2.0-alpha.63

package/src/resources/devices.ts

@@ -0,0 +1,496 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as BusinessPartnersAPI from './business-partners';
+import * as WorkersAPI from './workers';
+import { APIPromise } from '../core/api-promise';
+import { PageCursorURL, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * Devices (laptops, desktops, phones, tablets) managed by Rippling
+ */
+export class Devices extends APIResource {
+  /**
+   * A list of devices.
+   *
+   * - Requires: `API Tier 2`
+   * - Filterable fields: `worker_id`, `serial_number`, `lifecycle_state`,
+   *   `enrollment_status`
+   * - Expandable fields: `worker`, `pending_actions`
+   * - Sortable fields: `id`, `created_at`, `updated_at`
+   */
+  list(
+    query: DeviceListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<DeviceListResponsesPageCursorURL, DeviceListResponse> {
+    return this._client.getAPIList('/devices/', PageCursorURL<DeviceListResponse>, { query, ...options });
+  }
+
+  /**
+   * Retrieve a specific device
+   */
+  retrieve(
+    id: string,
+    query: DeviceRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DeviceRetrieveResponse> {
+    return this._client.get(path`/devices/${id}/`, { query, ...options });
+  }
+}
+
+export type DeviceListResponsesPageCursorURL = PageCursorURL<DeviceListResponse>;
+
+export interface DeviceListResponse {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * The MDM enrollment status: ENROLLED, UNENROLLED, WAITING_FOR_CONNECTION, ERROR,
+   * etc.
+   */
+  enrollment_status?: 'ENROLLED' | 'WAITING_FOR_CONNECTION' | 'ERROR' | 'UNENROLLED';
+
+  /**
+   * Whether the device's disk is encrypted (FileVault on macOS, BitLocker on
+   * Windows).
+   */
+  is_encrypted?: boolean;
+
+  /**
+   * Whether the device is managed via MDM.
+   */
+  is_managed?: boolean;
+
+  /**
+   * When the Rippling agent last checked in from this device.
+   */
+  last_checkin_at?: string;
+
+  /**
+   * When the device last synced with MDM.
+   */
+  last_mdm_sync_at?: string;
+
+  /**
+   * The device lifecycle state (e.g. ACTIVE, READY, LOCKED, LOST, DECOMMISSIONED).
+   */
+  lifecycle_state?:
+    | 'INIT'
+    | 'ACTIVE'
+    | 'ACTIVATING'
+    | 'LOCKED'
+    | 'LOCKING'
+    | 'INACTIVE'
+    | 'PENDING_MDM'
+    | 'CLEANING'
+    | 'READY'
+    | 'DECOMMISSIONING'
+    | 'DECOMMISSIONED'
+    | 'FULL_WIPING'
+    | 'FULL_WIPED'
+    | 'E_CYCLED'
+    | 'MDM_LOCKED'
+    | 'LOST'
+    | 'LOST_PLAYING_SOUND';
+
+  /**
+   * The MDM provider currently recorded on the device (RIPPLING, JAMFCLOUD, INTUNE,
+   * KANDJI, etc.). Null when the device is not currently MDM-managed (typical for
+   * unenrolled or recently-reset devices).
+   */
+  mdm_provider?:
+    | 'RIPPLING'
+    | 'JUMPCLOUD'
+    | 'JAMFCLOUD'
+    | 'FLEETSMITH'
+    | 'HEXNODE'
+    | 'MICROMDM'
+    | 'MERAKI'
+    | 'SOTI'
+    | 'ADDIGY'
+    | 'FLEETDM'
+    | 'KANDJI'
+    | 'ZOHO'
+    | 'INTUNE'
+    | 'OTHER';
+
+  /**
+   * The device hardware model identifier as reported by MDM (e.g. 'MacBookPro18,3',
+   * 'iPhone15,2').
+   */
+  model?: string;
+
+  /**
+   * The device operating system name.
+   */
+  os_name?: string;
+
+  /**
+   * The device operating system version.
+   */
+  os_version?: string;
+
+  /**
+   * Actions currently queued against the device (not yet completed). Expandable.
+   *
+   * Expandable field
+   */
+  pending_actions?: Array<DeviceListResponse.PendingAction>;
+
+  /**
+   * The IDs of actions currently queued against the device (not yet completed).
+   */
+  pending_actions_id?: Array<string>;
+
+  /**
+   * The OS platform the device runs: MACOS, WINDOWS, IOS, or IPADOS.
+   */
+  platform?: 'MACOS' | 'WINDOWS' | 'IOS' | 'IPADOS';
+
+  /**
+   * The device's hardware serial number.
+   */
+  serial_number?: string;
+
+  /**
+   * The worker this device is currently assigned to.
+   *
+   * Expandable field
+   */
+  worker?: WorkersAPI.Worker;
+
+  /**
+   * The ID of the worker this device is currently assigned to. Null if unassigned.
+   */
+  worker_id?: string;
+}
+
+export namespace DeviceListResponse {
+  export interface PendingAction {
+    /**
+     * Identifier field
+     */
+    id: string;
+
+    /**
+     * Record creation date
+     */
+    created_at: string;
+
+    /**
+     * Record update date
+     */
+    updated_at: string;
+
+    /**
+     * The type of the pending device action (e.g. LOCK_DEVICE, RESET_PASSWORD).
+     */
+    action_type?:
+      | 'ADD_USER_TO_FILEVAULT'
+      | 'ASSIGN_DEVICE'
+      | 'AUTHENTICATE_AGENT'
+      | 'CHANGE_FILEVAULT_RECOVERY_KEY'
+      | 'CHANGE_PASSWORD'
+      | 'CLEAR_PASSCODE'
+      | 'CREATE_RIPPLING_ADMIN'
+      | 'DELETE_LOCAL_ACCOUNT'
+      | 'DEMOTE_ACCOUNT_PERMISSION'
+      | 'DISABLE_FIND_MY'
+      | 'DISABLE_LOST_MODE'
+      | 'DISABLE_REMOTE_DESKTOP'
+      | 'ENABLE_LOST_MODE'
+      | 'ENABLE_REMOTE_DESKTOP'
+      | 'ENFORCE_PASSWORD_POLICY'
+      | 'FORCE_CHECK_IN'
+      | 'FULL_WIPE'
+      | 'GRANT_SECURE_TOKEN'
+      | 'INSTALL_ENROLLMENT_PROFILE'
+      | 'LOCK_DEVICE'
+      | 'LOCK_USER_ACCOUNT'
+      | 'LOST_MODE_GET_LOCATION'
+      | 'LOST_MODE_PLAY_SOUND'
+      | 'PROMOTE_ACCOUNT_PERMISSION'
+      | 'RECOVER_AGENT_VIA_MDM'
+      | 'REINSTALL_AGENT'
+      | 'REINSTALL_ENROLLMENT_PROFILE'
+      | 'REMOVE_OTHER_ENROLLMENT_PROFILES'
+      | 'RESET_PASSWORD'
+      | 'RESTART_DEVICE'
+      | 'ROTATE_FILEVAULT_KEY'
+      | 'SHUTDOWN_DEVICE'
+      | 'SOFT_WIPE'
+      | 'TURN_ON_FILEVAULT'
+      | 'UNASSIGN_DEVICE'
+      | 'UNINSTALL_AGENT'
+      | 'UNINSTALL_ANTIVIRUS'
+      | 'UNINSTALL_MDM'
+      | 'UNLOCK_DEVICE'
+      | 'UNLOCK_USER_ACCOUNT'
+      | 'UPDATE_OS'
+      | 'UNKNOWN';
+
+    /**
+     * When the action was queued.
+     */
+    queued_at?: string;
+
+    /**
+     * The current state of the pending action (e.g. QUEUED, WAITING_FOR_USER_ACTION).
+     */
+    state?: string;
+  }
+}
+
+/**
+ * Meta information for the response.
+ */
+export interface DeviceRetrieveResponse extends BusinessPartnersAPI.Meta {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * The MDM enrollment status: ENROLLED, UNENROLLED, WAITING_FOR_CONNECTION, ERROR,
+   * etc.
+   */
+  enrollment_status?: 'ENROLLED' | 'WAITING_FOR_CONNECTION' | 'ERROR' | 'UNENROLLED';
+
+  /**
+   * Whether the device's disk is encrypted (FileVault on macOS, BitLocker on
+   * Windows).
+   */
+  is_encrypted?: boolean;
+
+  /**
+   * Whether the device is managed via MDM.
+   */
+  is_managed?: boolean;
+
+  /**
+   * When the Rippling agent last checked in from this device.
+   */
+  last_checkin_at?: string;
+
+  /**
+   * When the device last synced with MDM.
+   */
+  last_mdm_sync_at?: string;
+
+  /**
+   * The device lifecycle state (e.g. ACTIVE, READY, LOCKED, LOST, DECOMMISSIONED).
+   */
+  lifecycle_state?:
+    | 'INIT'
+    | 'ACTIVE'
+    | 'ACTIVATING'
+    | 'LOCKED'
+    | 'LOCKING'
+    | 'INACTIVE'
+    | 'PENDING_MDM'
+    | 'CLEANING'
+    | 'READY'
+    | 'DECOMMISSIONING'
+    | 'DECOMMISSIONED'
+    | 'FULL_WIPING'
+    | 'FULL_WIPED'
+    | 'E_CYCLED'
+    | 'MDM_LOCKED'
+    | 'LOST'
+    | 'LOST_PLAYING_SOUND';
+
+  /**
+   * The MDM provider currently recorded on the device (RIPPLING, JAMFCLOUD, INTUNE,
+   * KANDJI, etc.). Null when the device is not currently MDM-managed (typical for
+   * unenrolled or recently-reset devices).
+   */
+  mdm_provider?:
+    | 'RIPPLING'
+    | 'JUMPCLOUD'
+    | 'JAMFCLOUD'
+    | 'FLEETSMITH'
+    | 'HEXNODE'
+    | 'MICROMDM'
+    | 'MERAKI'
+    | 'SOTI'
+    | 'ADDIGY'
+    | 'FLEETDM'
+    | 'KANDJI'
+    | 'ZOHO'
+    | 'INTUNE'
+    | 'OTHER';
+
+  /**
+   * The device hardware model identifier as reported by MDM (e.g. 'MacBookPro18,3',
+   * 'iPhone15,2').
+   */
+  model?: string;
+
+  /**
+   * The device operating system name.
+   */
+  os_name?: string;
+
+  /**
+   * The device operating system version.
+   */
+  os_version?: string;
+
+  /**
+   * Actions currently queued against the device (not yet completed). Expandable.
+   *
+   * Expandable field
+   */
+  pending_actions?: Array<DeviceRetrieveResponse.PendingAction>;
+
+  /**
+   * The IDs of actions currently queued against the device (not yet completed).
+   */
+  pending_actions_id?: Array<string>;
+
+  /**
+   * The OS platform the device runs: MACOS, WINDOWS, IOS, or IPADOS.
+   */
+  platform?: 'MACOS' | 'WINDOWS' | 'IOS' | 'IPADOS';
+
+  /**
+   * The device's hardware serial number.
+   */
+  serial_number?: string;
+
+  /**
+   * The worker this device is currently assigned to.
+   *
+   * Expandable field
+   */
+  worker?: WorkersAPI.Worker;
+
+  /**
+   * The ID of the worker this device is currently assigned to. Null if unassigned.
+   */
+  worker_id?: string;
+}
+
+export namespace DeviceRetrieveResponse {
+  export interface PendingAction {
+    /**
+     * Identifier field
+     */
+    id: string;
+
+    /**
+     * Record creation date
+     */
+    created_at: string;
+
+    /**
+     * Record update date
+     */
+    updated_at: string;
+
+    /**
+     * The type of the pending device action (e.g. LOCK_DEVICE, RESET_PASSWORD).
+     */
+    action_type?:
+      | 'ADD_USER_TO_FILEVAULT'
+      | 'ASSIGN_DEVICE'
+      | 'AUTHENTICATE_AGENT'
+      | 'CHANGE_FILEVAULT_RECOVERY_KEY'
+      | 'CHANGE_PASSWORD'
+      | 'CLEAR_PASSCODE'
+      | 'CREATE_RIPPLING_ADMIN'
+      | 'DELETE_LOCAL_ACCOUNT'
+      | 'DEMOTE_ACCOUNT_PERMISSION'
+      | 'DISABLE_FIND_MY'
+      | 'DISABLE_LOST_MODE'
+      | 'DISABLE_REMOTE_DESKTOP'
+      | 'ENABLE_LOST_MODE'
+      | 'ENABLE_REMOTE_DESKTOP'
+      | 'ENFORCE_PASSWORD_POLICY'
+      | 'FORCE_CHECK_IN'
+      | 'FULL_WIPE'
+      | 'GRANT_SECURE_TOKEN'
+      | 'INSTALL_ENROLLMENT_PROFILE'
+      | 'LOCK_DEVICE'
+      | 'LOCK_USER_ACCOUNT'
+      | 'LOST_MODE_GET_LOCATION'
+      | 'LOST_MODE_PLAY_SOUND'
+      | 'PROMOTE_ACCOUNT_PERMISSION'
+      | 'RECOVER_AGENT_VIA_MDM'
+      | 'REINSTALL_AGENT'
+      | 'REINSTALL_ENROLLMENT_PROFILE'
+      | 'REMOVE_OTHER_ENROLLMENT_PROFILES'
+      | 'RESET_PASSWORD'
+      | 'RESTART_DEVICE'
+      | 'ROTATE_FILEVAULT_KEY'
+      | 'SHUTDOWN_DEVICE'
+      | 'SOFT_WIPE'
+      | 'TURN_ON_FILEVAULT'
+      | 'UNASSIGN_DEVICE'
+      | 'UNINSTALL_AGENT'
+      | 'UNINSTALL_ANTIVIRUS'
+      | 'UNINSTALL_MDM'
+      | 'UNLOCK_DEVICE'
+      | 'UNLOCK_USER_ACCOUNT'
+      | 'UPDATE_OS'
+      | 'UNKNOWN';
+
+    /**
+     * When the action was queued.
+     */
+    queued_at?: string;
+
+    /**
+     * The current state of the pending action (e.g. QUEUED, WAITING_FOR_USER_ACTION).
+     */
+    state?: string;
+  }
+}
+
+export interface DeviceListParams {
+  cursor?: string;
+
+  expand?: string;
+
+  filter?: string;
+
+  order_by?: string;
+}
+
+export interface DeviceRetrieveParams {
+  expand?: string;
+}
+
+export declare namespace Devices {
+  export {
+    type DeviceListResponse as DeviceListResponse,
+    type DeviceRetrieveResponse as DeviceRetrieveResponse,
+    type DeviceListResponsesPageCursorURL as DeviceListResponsesPageCursorURL,
+    type DeviceListParams as DeviceListParams,
+    type DeviceRetrieveParams as DeviceRetrieveParams,
+  };
+}

package/src/resources/functions/deployments.ts

@@ -112,6 +112,11 @@ export interface FunctionDeployment {
    */
   function_version_id?: string;
 
+  /**
+   * Input and output JSON Schema contracts for the deployment
+   */
+  io_contract?: unknown;
+
   /**
    * Additional, runtime-specific options for the deployment
    */
@@ -181,6 +186,11 @@ export interface DeploymentCreateParams {
    */
   dependencies?: unknown;
 
+  /**
+   * Input and output JSON Schema contracts for the deployment
+   */
+  io_contract?: unknown;
+
   /**
    * Additional, runtime-specific options for the deployment
    */

package/src/resources/index.ts

@@ -1,6 +1,14 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export * from './shared';
+export {
+  AppUsers,
+  type AppUserListResponse,
+  type AppUserRetrieveResponse,
+  type AppUserListParams,
+  type AppUserRetrieveParams,
+  type AppUserListResponsesPageCursorURL,
+} from './app-users';
 export {
   BreakPolicies,
   type BreakPolicyListResponse,
@@ -140,6 +148,22 @@ export {
   type DepartmentUpdateParams,
   type DepartmentsPageCursorURL,
 } from './departments';
+export {
+  DeviceOrders,
+  type DeviceOrderListResponse,
+  type DeviceOrderRetrieveResponse,
+  type DeviceOrderListParams,
+  type DeviceOrderRetrieveParams,
+  type DeviceOrderListResponsesPageCursorURL,
+} from './device-orders';
+export {
+  Devices,
+  type DeviceListResponse,
+  type DeviceRetrieveResponse,
+  type DeviceListParams,
+  type DeviceRetrieveParams,
+  type DeviceListResponsesPageCursorURL,
+} from './devices';
 export { DraftHires, type DraftHireCreateResponse, type DraftHireCreateParams } from './draft-hires';
 export {
   EarningTypes,

package/src/resources/job-assignments.ts

@@ -256,7 +256,8 @@ export interface JobAssignmentCreateParams {
 
   /**
    * Date and time the change becomes effective (ISO 8601 format, e.g.,
-   * 2025-11-07T17:00:00.000+00:00).
+   * 2025-11-07T17:00:00.000+00:00); defaults to current time in UTC if not provided.
+   * job_pay_rate_effective_from is ignored if this field is provided.
    */
   effective_from?: string;
 
@@ -267,15 +268,14 @@ export interface JobAssignmentCreateParams {
   job_pay_rate?: number;
 
   /**
-   * Reason for setting, updating, or resetting the pay rate for the job assigned to
-   * the worker.
+   * This field is deprecated and will be removed in a future version, use the new
+   * change_reason field instead.
    */
   job_pay_rate_change_reason?: string;
 
   /**
-   * Date and time the pay rate becomes effective (ISO 8601 format
-   * YYYY-MM-DDTHH:mm:ss.sssZ, e.g., 2025-11-07T17:00:00.000+00:00); defaults to
-   * current time in UTC if not provided.
+   * This field is deprecated and will be removed in a future version, use the new
+   * effective_from field instead.
    */
   job_pay_rate_effective_from?: string;
 }
@@ -302,7 +302,8 @@ export interface JobAssignmentUpdateParams {
 
   /**
    * Date and time the change becomes effective (ISO 8601 format, e.g.,
-   * 2025-11-07T17:00:00.000+00:00).
+   * 2025-11-07T17:00:00.000+00:00); defaults to current time in UTC if not provided.
+   * job_pay_rate_effective_from is ignored if this field is provided.
    */
   effective_from?: string;
 
@@ -313,15 +314,14 @@ export interface JobAssignmentUpdateParams {
   job_pay_rate?: number;
 
   /**
-   * Reason for setting, updating, or resetting the pay rate for the job assigned to
-   * the worker.
+   * This field is deprecated and will be removed in a future version, use the new
+   * change_reason field instead.
    */
   job_pay_rate_change_reason?: string;
 
   /**
-   * Date and time the pay rate becomes effective (ISO 8601 format
-   * YYYY-MM-DDTHH:mm:ss.sssZ, e.g., 2025-11-07T17:00:00.000+00:00); defaults to
-   * current time in UTC if not provided.
+   * This field is deprecated and will be removed in a future version, use the new
+   * effective_from field instead.
    */
   job_pay_rate_effective_from?: string;
 }

package/src/resources/workers.ts

@@ -822,6 +822,11 @@ export namespace Worker {
      */
     ca?: CountryFields.Ca;
 
+    /**
+     * Country-wise regional fields for New Zealand
+     */
+    nz?: CountryFields.Nz;
+
     /**
      * Country-wise regional fields for USA
      */
@@ -839,6 +844,16 @@ export namespace Worker {
       sin?: string;
     }
 
+    /**
+     * Country-wise regional fields for New Zealand
+     */
+    export interface Nz {
+      /**
+       * Inland Revenue Department (IRD) number for New Zealand employees.
+       */
+      ird_number?: string;
+    }
+
     /**
      * Country-wise regional fields for USA
      */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.2.0-alpha.61'; // x-release-please-version
+export const VERSION = '0.2.0-alpha.63'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0-alpha.61";
+export declare const VERSION = "0.2.0-alpha.63";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0-alpha.61";
+export declare const VERSION = "0.2.0-alpha.63";
 //# 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 = '0.2.0-alpha.61'; // x-release-please-version
+exports.VERSION = '0.2.0-alpha.63'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.2.0-alpha.61'; // x-release-please-version
+export const VERSION = '0.2.0-alpha.63'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map