@rippling/rippling-sdk 0.2.0-alpha.33 → 0.2.0-alpha.35

package/src/lib/sdui/index.ts

@@ -0,0 +1,365 @@
+/**
+ * AUTO-GENERATED — component exports are generated from component-manifest.json
+ * Generated at: 2026-04-17T04:10:01.127Z
+ * Components: 128
+ *
+ * Do not edit manually. Run: npx tsx scripts/codegen-builder.ts
+ */
+
+// --- Named exports (individual imports) ---
+
+// State
+export { createState, extractPath } from './state';
+export type { StateProxy, StateRef, BindStateRef } from './state';
+
+// Conditions
+export { eq, neq, gt, gte, lt, lte, truthy, falsy, and, or } from './conditions';
+export type { StateCondition, OrCondition, VisibilityCondition } from './conditions';
+
+// Dynamic props
+export { cond, template } from './props';
+export type { CondRef, TemplateRef } from './props';
+
+// Actions
+export { set, push, remove, callFunction, nav, notify, validate, openModal, closeModal } from './actions';
+export type { ActionBinding } from './actions';
+
+// Components
+export {
+  TextInput,
+  Select,
+  AppGroupSelect,
+  Checkbox,
+  CheckboxGroup,
+  Email,
+  Number,
+  Date,
+  DateRange,
+  DateInlineMulti,
+  Textarea,
+  Radio,
+  Phone,
+  Password,
+  Switch,
+  FileDrop,
+  TextAutoSuggest,
+  Currency,
+  WorkEmail,
+  Percentage,
+  SegmentedControl,
+  Time,
+  TimeRange,
+  Timezone,
+  Slider,
+  RangeSlider,
+  Masker,
+  DaySelector,
+  ColorPicker,
+  SelectableGroup,
+  Ssn,
+  Sin,
+  Signature,
+  Survey,
+  Tree,
+  TreeSelect,
+  File,
+  InputGroup,
+  Field,
+  ActionCard,
+  Alert,
+  Avatar,
+  Badge,
+  Chip,
+  Card,
+  ContentLoader,
+  Divider,
+  Icon,
+  Label,
+  ListItem,
+  Modal,
+  ModalFooter,
+  ProgressBar,
+  Skeleton,
+  Spinner,
+  Stepper,
+  TextClip,
+  TextSnippet,
+  Tip,
+  CheckList,
+  DistributionBar,
+  ImageViewer,
+  ObjectUI,
+  ObjectUITemplate,
+  ObjectUIHeader,
+  ObjectUIContent,
+  ObjectUIStats,
+  SnackBar,
+  Video,
+  AvatarList,
+  Image,
+  AtomsSeparator,
+  Carousel,
+  TableBasic,
+  LocationCard,
+  LoaderCard,
+  LayoutCard,
+  AppGroupLoader,
+  ChartLoader,
+  ReportLoader,
+  ReportShareLoader,
+  ReportViewerLoader,
+  SettingsLoader,
+  ChipGroup,
+  ModalCloseButton,
+  Status,
+  ApiError,
+  Circle,
+  CountDown,
+  Country,
+  ToggleableArrow,
+  TitleCaption,
+  AiIcon,
+  Breadcrumb,
+  Button,
+  ButtonGroup,
+  DraggableList,
+  Drawer,
+  Dropdown,
+  ExpansionPanel,
+  ExpansionPanelGroup,
+  FloatingButton,
+  IconButton,
+  ItemNavigator,
+  Link,
+  MenuList,
+  NestedList,
+  Paginate,
+  SelectableMenu,
+  ShowMore,
+  Tab,
+  Heading,
+  Text,
+  Box,
+  Grid,
+  HStack,
+  LabelGroup,
+  Layout,
+  PageContent,
+  PageHeader,
+  PageAppLogo,
+  PageFooter,
+  Pane,
+  Responsive,
+  SplitPane,
+  VStack,
+  CustomObjectGrid,
+  ObjectListView,
+} from './components';
+export type { SpecNode } from './components';
+
+// Directives
+export { visible, repeat, $item, $bindItem, $index } from './directives';
+export type { ItemRef, BindItemRef, IndexRef } from './directives';
+
+// Render
+export { render } from './render';
+export type { FlatElement, Spec } from './render';
+
+// Component (stateful components with local state + lifecycle)
+export { component } from './component';
+export type { StateScope } from './component';
+
+// --- Namespaced exports ---
+
+import * as _conditions from './conditions';
+import * as _actions from './actions';
+import * as _components from './components';
+import * as _directives from './directives';
+
+export const conditions = {
+  eq: _conditions.eq,
+  neq: _conditions.neq,
+  gt: _conditions.gt,
+  gte: _conditions.gte,
+  lt: _conditions.lt,
+  lte: _conditions.lte,
+  truthy: _conditions.truthy,
+  falsy: _conditions.falsy,
+  and: _conditions.and,
+  or: _conditions.or,
+};
+
+export const actions = {
+  set: _actions.set,
+  push: _actions.push,
+  remove: _actions.remove,
+  callFunction: _actions.callFunction,
+  nav: _actions.nav,
+  notify: _actions.notify,
+  validate: _actions.validate,
+  openModal: _actions.openModal,
+  closeModal: _actions.closeModal,
+};
+
+export const components = {
+  TextInput: _components.TextInput,
+  Select: _components.Select,
+  AppGroupSelect: _components.AppGroupSelect,
+  Checkbox: _components.Checkbox,
+  CheckboxGroup: _components.CheckboxGroup,
+  Email: _components.Email,
+  Number: _components.Number,
+  Date: _components.Date,
+  DateRange: _components.DateRange,
+  DateInlineMulti: _components.DateInlineMulti,
+  Textarea: _components.Textarea,
+  Radio: _components.Radio,
+  Phone: _components.Phone,
+  Password: _components.Password,
+  Switch: _components.Switch,
+  FileDrop: _components.FileDrop,
+  TextAutoSuggest: _components.TextAutoSuggest,
+  Currency: _components.Currency,
+  WorkEmail: _components.WorkEmail,
+  Percentage: _components.Percentage,
+  SegmentedControl: _components.SegmentedControl,
+  Time: _components.Time,
+  TimeRange: _components.TimeRange,
+  Timezone: _components.Timezone,
+  Slider: _components.Slider,
+  RangeSlider: _components.RangeSlider,
+  Masker: _components.Masker,
+  DaySelector: _components.DaySelector,
+  ColorPicker: _components.ColorPicker,
+  SelectableGroup: _components.SelectableGroup,
+  Ssn: _components.Ssn,
+  Sin: _components.Sin,
+  Signature: _components.Signature,
+  Survey: _components.Survey,
+  Tree: _components.Tree,
+  TreeSelect: _components.TreeSelect,
+  File: _components.File,
+  InputGroup: _components.InputGroup,
+  Field: _components.Field,
+  ActionCard: _components.ActionCard,
+  Alert: _components.Alert,
+  Avatar: _components.Avatar,
+  Badge: _components.Badge,
+  Chip: _components.Chip,
+  Card: _components.Card,
+  ContentLoader: _components.ContentLoader,
+  Divider: _components.Divider,
+  Icon: _components.Icon,
+  Label: _components.Label,
+  ListItem: _components.ListItem,
+  Modal: _components.Modal,
+  ModalFooter: _components.ModalFooter,
+  ProgressBar: _components.ProgressBar,
+  Skeleton: _components.Skeleton,
+  Spinner: _components.Spinner,
+  Stepper: _components.Stepper,
+  TextClip: _components.TextClip,
+  TextSnippet: _components.TextSnippet,
+  Tip: _components.Tip,
+  CheckList: _components.CheckList,
+  DistributionBar: _components.DistributionBar,
+  ImageViewer: _components.ImageViewer,
+  ObjectUI: _components.ObjectUI,
+  ObjectUITemplate: _components.ObjectUITemplate,
+  ObjectUIHeader: _components.ObjectUIHeader,
+  ObjectUIContent: _components.ObjectUIContent,
+  ObjectUIStats: _components.ObjectUIStats,
+  SnackBar: _components.SnackBar,
+  Video: _components.Video,
+  AvatarList: _components.AvatarList,
+  Image: _components.Image,
+  AtomsSeparator: _components.AtomsSeparator,
+  Carousel: _components.Carousel,
+  TableBasic: _components.TableBasic,
+  LocationCard: _components.LocationCard,
+  LoaderCard: _components.LoaderCard,
+  LayoutCard: _components.LayoutCard,
+  AppGroupLoader: _components.AppGroupLoader,
+  ChartLoader: _components.ChartLoader,
+  ReportLoader: _components.ReportLoader,
+  ReportShareLoader: _components.ReportShareLoader,
+  ReportViewerLoader: _components.ReportViewerLoader,
+  SettingsLoader: _components.SettingsLoader,
+  ChipGroup: _components.ChipGroup,
+  ModalCloseButton: _components.ModalCloseButton,
+  Status: _components.Status,
+  ApiError: _components.ApiError,
+  Circle: _components.Circle,
+  CountDown: _components.CountDown,
+  Country: _components.Country,
+  ToggleableArrow: _components.ToggleableArrow,
+  TitleCaption: _components.TitleCaption,
+  AiIcon: _components.AiIcon,
+  Breadcrumb: _components.Breadcrumb,
+  Button: _components.Button,
+  ButtonGroup: _components.ButtonGroup,
+  DraggableList: _components.DraggableList,
+  Drawer: _components.Drawer,
+  Dropdown: _components.Dropdown,
+  ExpansionPanel: _components.ExpansionPanel,
+  ExpansionPanelGroup: _components.ExpansionPanelGroup,
+  FloatingButton: _components.FloatingButton,
+  IconButton: _components.IconButton,
+  ItemNavigator: _components.ItemNavigator,
+  Link: _components.Link,
+  MenuList: _components.MenuList,
+  NestedList: _components.NestedList,
+  Paginate: _components.Paginate,
+  SelectableMenu: _components.SelectableMenu,
+  ShowMore: _components.ShowMore,
+  Tab: _components.Tab,
+  Heading: _components.Heading,
+  Text: _components.Text,
+  Box: _components.Box,
+  Grid: _components.Grid,
+  HStack: _components.HStack,
+  LabelGroup: _components.LabelGroup,
+  Layout: _components.Layout,
+  PageContent: _components.PageContent,
+  PageHeader: _components.PageHeader,
+  PageAppLogo: _components.PageAppLogo,
+  PageFooter: _components.PageFooter,
+  Pane: _components.Pane,
+  Responsive: _components.Responsive,
+  SplitPane: _components.SplitPane,
+  VStack: _components.VStack,
+  CustomObjectGrid: _components.CustomObjectGrid,
+  ObjectListView: _components.ObjectListView,
+};
+
+export const directives = {
+  visible: _directives.visible,
+  repeat: _directives.repeat,
+  $item: _directives.$item,
+  $bindItem: _directives.$bindItem,
+  $index: _directives.$index,
+};
+
+// --- Default export (namespace object) ---
+
+import { createState } from './state';
+import { cond, template } from './props';
+import { render } from './render';
+import { visible, repeat } from './directives';
+import { component } from './component';
+
+const SDUI = {
+  createState,
+  render,
+  visible,
+  repeat,
+  cond,
+  component,
+  template,
+  components,
+  actions,
+  conditions,
+  directives,
+};
+
+export default SDUI;

package/src/lib/sdui/props.ts

@@ -0,0 +1,32 @@
+import type { VisibilityCondition } from './conditions';
+import { extractPath } from './state';
+
+export interface CondRef {
+  $cond: VisibilityCondition;
+  $then: unknown;
+  $else: unknown;
+}
+
+export interface TemplateRef {
+  $template: string;
+}
+
+export function cond(condition: VisibilityCondition, thenValue: unknown, elseValue: unknown): CondRef {
+  return { $cond: condition, $then: thenValue, $else: elseValue };
+}
+
+export function template(strings: TemplateStringsArray, ...values: unknown[]): TemplateRef {
+  let result = '';
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i < values.length) {
+      try {
+        const path = extractPath(values[i]);
+        result += `\${${path}}`;
+      } catch {
+        result += String(values[i]);
+      }
+    }
+  }
+  return { $template: result };
+}

package/src/lib/sdui/render.ts

@@ -0,0 +1,58 @@
+import type { SpecNode } from './components';
+import type { ActionBinding } from './actions';
+
+export interface FlatElement {
+  type: string;
+  props: Record<string, unknown>;
+  children: string[];
+  on?: Record<string, ActionBinding | ActionBinding[]>;
+  visible?: unknown;
+  watch?: Record<string, unknown>;
+  repeat?: { statePath: string; key?: string };
+}
+
+export interface Spec {
+  root: string;
+  elements: Record<string, FlatElement>;
+  state: Record<string, unknown>;
+}
+
+export function render(stateProxy: { $initialValues: Record<string, unknown> }, rootElement: SpecNode): Spec {
+  const elements: Record<string, FlatElement> = {};
+  const localStates: { path: string; initial: unknown }[] = [];
+  let counter = 0;
+
+  function flattenNode(node: SpecNode | null | undefined): string | null {
+    if (!node) return null;
+
+    // Collect local state registrations from component() wrappers
+    const registration = (node as any)._localStateRegistration;
+    if (registration) {
+      localStates.push(registration);
+    }
+
+    const id = `${node.type.toLowerCase()}_${counter++}`;
+    const childIds = node.children.map(flattenNode).filter((id): id is string => id !== null);
+
+    const element: FlatElement = { type: node.type, props: node.props, children: childIds };
+    if (node.visible !== undefined) element.visible = node.visible;
+    if (node.on) element.on = node.on;
+    if (node.watch) element.watch = node.watch;
+    if (node.repeat) element.repeat = node.repeat;
+
+    elements[id] = element;
+    return id;
+  }
+
+  const rootId = flattenNode(rootElement)!;
+
+  // Merge global state + local states from component() calls
+  const state: Record<string, unknown> = { ...stateProxy.$initialValues };
+  for (const { path, initial } of localStates) {
+    // path is like "/auto_xxx" — strip leading / for state key
+    const key = path.startsWith('/') ? path.slice(1) : path;
+    state[key] = initial;
+  }
+
+  return { root: rootId, elements, state };
+}

package/src/lib/sdui/state.ts

@@ -0,0 +1,60 @@
+// State proxy — creates deeply nested proxies that produce $state refs on access
+
+export type StateRef = { $state: string };
+export type BindStateRef = { $bindState: string };
+
+// Deep proxy type — every property access returns another proxy (for s.teamData.team.name)
+// This allows deep access regardless of the initial value (even null)
+type DeepStateProxy = {
+  readonly [key: string]: DeepStateProxy;
+} & { readonly $state: string; readonly $bind: BindStateRef; readonly $path: string };
+
+export type StateProxy<T> = {
+  [K in keyof T]: T[K] extends Record<string, unknown> ? StateProxy<T[K]> & DeepStateProxy : DeepStateProxy;
+} & DeepStateProxy & { readonly $initialValues: T };
+
+const PROXY_MARKER = Symbol('stateProxy');
+const INITIAL_VALUES = Symbol('initialValues');
+
+function isStateProxy(value: unknown): boolean {
+  return typeof value === 'object' && value !== null && (value as any)[PROXY_MARKER] === true;
+}
+
+export function extractPath(ref: unknown): string {
+  if (isStateProxy(ref)) return (ref as any).$path;
+  if (typeof ref === 'object' && ref !== null && '$state' in ref) return (ref as any).$state;
+  // Support scope proxies from component() — they have $path as a getter
+  if (typeof ref === 'object' && ref !== null) {
+    try {
+      const p = (ref as any).$path;
+      if (typeof p === 'string') return p;
+    } catch {}
+  }
+  throw new Error('Expected a state proxy or { $state } ref');
+}
+
+function createProxy<T>(path: string, initialValues: T): StateProxy<T> {
+  const handler: ProxyHandler<object> = {
+    get(_target, prop) {
+      if (prop === PROXY_MARKER) return true;
+      if (prop === INITIAL_VALUES) return initialValues;
+      if (prop === '$initialValues') return initialValues;
+      if (prop === '$state') return path;
+      if (prop === '$bind') return { $bindState: path };
+      if (prop === '$path') return path;
+      // Support JSON serialization — toJSON returns { $state: path }
+      if (prop === 'toJSON') return () => ({ $state: path });
+      // For equality checks
+      if (prop === Symbol.toPrimitive) return () => `$state:${path}`;
+
+      const childPath = `${path}/${String(prop)}`;
+      return createProxy(childPath, undefined as any);
+    },
+  };
+
+  return new Proxy({} as any, handler);
+}
+
+export function createState<T extends Record<string, unknown>>(shape: T): StateProxy<T> {
+  return createProxy('', shape);
+}

package/src/resources/draft-hires.ts

@@ -118,6 +118,11 @@ export namespace DraftHireCreateParams {
      * Custom fields for the draft hire
      */
     custom_fields?: Array<DraftHire.CustomField>;
+
+    /**
+     * Documents to attach to this draft hire
+     */
+    documents?: Array<DraftHire.Document>;
   }
 
   export namespace DraftHire {
@@ -177,6 +182,11 @@ export namespace DraftHireCreateParams {
        */
       equity_vesting_schedule?: EmploymentInfo.EquityVestingSchedule;
 
+      /**
+       * Job family ID
+       */
+      job_family_id?: string;
+
       /**
        * Job title
        */
@@ -538,6 +548,27 @@ export namespace DraftHireCreateParams {
        */
       field_value: unknown;
     }
+
+    /**
+     * A document to attach to a draft hire, referencing a pre-uploaded file.
+     */
+    export interface Document {
+      /**
+       * Id of a FileUploadTracker in ACTIVE status whose file should become a document
+       * on the hire
+       */
+      file_id: string;
+
+      /**
+       * Document name. Defaults to the uploaded file name when omitted.
+       */
+      name?: string;
+
+      /**
+       * Signature date in YYYY-MM-DD format.
+       */
+      signature_date?: string;
+    }
   }
 }
 

package/src/resources/earnings-inputs.ts

@@ -22,6 +22,16 @@ export class EarningsInputs extends APIResource {
     return this._client.getAPIList('/earnings-inputs/', PageCursorURL<EarningsInputListResponse>, options);
   }
 
+  /**
+   * Create a new earnings-input
+   */
+  create(
+    body: EarningsInputCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<EarningsInputCreateResponse> {
+    return this._client.post('/earnings-inputs/', { body, ...options });
+  }
+
   /**
    * Delete a earnings-input
    */
@@ -98,9 +108,126 @@ export interface EarningsInputListResponse {
   worker_id?: string;
 }
 
+/**
+ * V2 DTO representing an external earnings input record.
+ *
+ *     Used by:
+ *       - GET /earnings-inputs/  (list)
+ */
+export interface EarningsInputCreateResponse {
+  /**
+   * Unique identifier for the earnings input.
+   */
+  id?: string;
+
+  /**
+   * Earning amount as a string-encoded decimal.
+   */
+  amount?: string;
+
+  /**
+   * How the earning is assigned (e.g. BY_PAY_PERIOD).
+   */
+  assignment_type?: string;
+
+  /**
+   * Code identifying the earning type (e.g. regular_salary).
+   */
+  earning_code?: string;
+
+  /**
+   * External reference identifier for this earning.
+   */
+  external_id?: string;
+
+  /**
+   * Hours associated with this earning as a string-encoded decimal.
+   */
+  hours?: string;
+
+  /**
+   * The pay period basis date for this earning.
+   */
+  pay_period_basis_date?: string;
+
+  /**
+   * Identifier of the payroll run this earning is assigned to, if any.
+   */
+  run_id?: string;
+
+  /**
+   * Current status of the earnings input (e.g. UNASSIGNED, ASSIGNED).
+   */
+  status?: string;
+
+  /**
+   * Time tracking labels associated with this earning.
+   */
+  time_labels?: Array<string>;
+
+  /**
+   * Identifier of the worker (role ID).
+   */
+  worker_id?: string;
+}
+
+export interface EarningsInputCreateParams {
+  /**
+   * Earning amount as a string-encoded decimal.
+   */
+  amount?: string;
+
+  /**
+   * How the earning is assigned (e.g. BY_PAY_PERIOD).
+   */
+  assignment_type?: string;
+
+  /**
+   * Code identifying the earning type (e.g. regular_salary).
+   */
+  earning_code?: string;
+
+  /**
+   * External reference identifier for this earning.
+   */
+  external_id?: string;
+
+  /**
+   * Hours associated with this earning as a string-encoded decimal.
+   */
+  hours?: string;
+
+  /**
+   * The pay period basis date for this earning.
+   */
+  pay_period_basis_date?: string;
+
+  /**
+   * Identifier of the payroll run this earning is assigned to, if any.
+   */
+  run_id?: string;
+
+  /**
+   * Current status of the earnings input (e.g. UNASSIGNED, ASSIGNED).
+   */
+  status?: string;
+
+  /**
+   * Time tracking labels associated with this earning.
+   */
+  time_labels?: Array<string>;
+
+  /**
+   * Identifier of the worker (role ID).
+   */
+  worker_id?: string;
+}
+
 export declare namespace EarningsInputs {
   export {
     type EarningsInputListResponse as EarningsInputListResponse,
+    type EarningsInputCreateResponse as EarningsInputCreateResponse,
     type EarningsInputListResponsesPageCursorURL as EarningsInputListResponsesPageCursorURL,
+    type EarningsInputCreateParams as EarningsInputCreateParams,
   };
 }