@rippling/rippling-sdk 0.2.0-alpha.94 → 0.2.0-alpha.96

package/src/resources/business-structure-paths.ts

@@ -5,6 +5,7 @@ import * as BusinessPartnersAPI from './business-partners';
 import * as JobCodesAPI from './job-codes';
 import { APIPromise } from '../core/api-promise';
 import { PageCursorURL, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -30,6 +31,16 @@ export class BusinessStructurePaths extends APIResource {
     );
   }
 
+  /**
+   * Create a new business-structure-path
+   */
+  create(
+    body: BusinessStructurePathCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<BusinessStructurePathCreateResponse> {
+    return this._client.post('/business-structure-paths/', { body, ...options });
+  }
+
   /**
    * Retrieve a specific business-structure-path
    */
@@ -40,6 +51,16 @@ export class BusinessStructurePaths extends APIResource {
   ): APIPromise<BusinessStructurePathRetrieveResponse> {
     return this._client.get(path`/business-structure-paths/${id}/`, { query, ...options });
   }
+
+  /**
+   * Delete a Business Structure path and all of its descendant paths.
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/business-structure-paths/${id}/`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 export type BusinessStructurePathListResponsesPageCursorURL =
@@ -88,6 +109,49 @@ export interface BusinessStructurePathListResponse {
   parent_id?: string;
 }
 
+export interface BusinessStructurePathCreateResponse {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * Ordered list of full JobCode objects for each job in the path, top to bottom.
+   * Populate via ?expand=job_codes. Requires both business-structure-paths.read and
+   * job-codes.read scopes.
+   *
+   * Expandable field
+   */
+  job_codes?: Array<JobCodesAPI.JobCode>;
+
+  /**
+   * Ordered list of Job code IDs from top to bottom.
+   */
+  job_codes_id?: Array<string>;
+
+  /**
+   * Name of the path (e.g. 'SF Office > Coffee > Barista').
+   */
+  name?: string;
+
+  parent?: unknown;
+
+  /**
+   * Id of the parent BusinessStructurePath. None for root path.
+   */
+  parent_id?: string;
+}
+
 /**
  * Meta information for the response.
  */
@@ -147,6 +211,18 @@ export interface BusinessStructurePathListParams {
   order_by?: string;
 }
 
+export interface BusinessStructurePathCreateParams {
+  /**
+   * The Job Code to place at this Business Structure path.
+   */
+  job_code_id: string;
+
+  /**
+   * Id of the parent BusinessStructurePath. None for root path.
+   */
+  parent_id?: string;
+}
+
 export interface BusinessStructurePathRetrieveParams {
   expand?: string;
 }
@@ -154,9 +230,11 @@ export interface BusinessStructurePathRetrieveParams {
 export declare namespace BusinessStructurePaths {
   export {
     type BusinessStructurePathListResponse as BusinessStructurePathListResponse,
+    type BusinessStructurePathCreateResponse as BusinessStructurePathCreateResponse,
     type BusinessStructurePathRetrieveResponse as BusinessStructurePathRetrieveResponse,
     type BusinessStructurePathListResponsesPageCursorURL as BusinessStructurePathListResponsesPageCursorURL,
     type BusinessStructurePathListParams as BusinessStructurePathListParams,
+    type BusinessStructurePathCreateParams as BusinessStructurePathCreateParams,
     type BusinessStructurePathRetrieveParams as BusinessStructurePathRetrieveParams,
   };
 }

package/src/resources/developer-program-application.ts

@@ -0,0 +1,233 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { PageCursorURL, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+
+/**
+ * Developer Platform account and team management
+ */
+export class DeveloperProgramApplication extends APIResource {
+  /**
+   * A list of developer program application.
+   *
+   * - Requires: `Developer Program`
+   */
+  list(
+    options?: RequestOptions,
+  ): PagePromise<
+    DeveloperProgramApplicationListResponsesPageCursorURL,
+    DeveloperProgramApplicationListResponse
+  > {
+    return this._client.getAPIList(
+      '/developer-program-application/',
+      PageCursorURL<DeveloperProgramApplicationListResponse>,
+      options,
+    );
+  }
+
+  /**
+   * Submit a Developer Program application for the authenticated company.
+   */
+  create(
+    body: DeveloperProgramApplicationCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DeveloperProgramApplicationCreateResponse> {
+    return this._client.post('/developer-program-application/', { body, ...options });
+  }
+}
+
+export type DeveloperProgramApplicationListResponsesPageCursorURL =
+  PageCursorURL<DeveloperProgramApplicationListResponse>;
+
+/**
+ * Developer Program application resource for Path B existing-company apply.
+ */
+export interface DeveloperProgramApplicationListResponse {
+  /**
+   * Stable application ID
+   */
+  id: string;
+
+  /**
+   * What the company plans to build on Rippling
+   */
+  build_description?: string;
+
+  /**
+   * Rippling company ID on the application
+   */
+  company_id?: string;
+
+  /**
+   * Applicant email on the application
+   */
+  email?: string;
+
+  /**
+   * Time after which ops can no longer approve this pending application
+   */
+  expires_at?: string;
+
+  /**
+   * Applicant role ID
+   */
+  role_id?: string;
+
+  /**
+   * Deprecated alias of id. Prefer id.
+   */
+  signup_id?: string;
+
+  /**
+   * Application checklist stages
+   */
+  stages?: DeveloperProgramApplicationListResponse.Stages;
+
+  /**
+   * Application status: EMAIL_VERIFICATION_PENDING, SUBMITTED, APPROVED, VERIFIED,
+   * REJECTED, or EXPIRED. Existing-company apply writes SUBMITTED and never
+   * EMAIL_VERIFICATION_PENDING. VERIFIED means provision finished, not email
+   * verified.
+   */
+  status?: 'EMAIL_VERIFICATION_PENDING' | 'SUBMITTED' | 'APPROVED' | 'VERIFIED' | 'REJECTED' | 'EXPIRED';
+
+  /**
+   * Time the application was submitted
+   */
+  submitted_at?: string;
+}
+
+export namespace DeveloperProgramApplicationListResponse {
+  /**
+   * Application checklist stages
+   */
+  export interface Stages {
+    /**
+     * Whether ops approved the application and provisioning is pending
+     */
+    access_ready?: boolean;
+
+    /**
+     * Whether the application has been submitted
+     */
+    application_submitted?: boolean;
+
+    /**
+     * Whether the applicant email is confirmed
+     */
+    email_confirmed?: boolean;
+
+    /**
+     * Whether Developer Program access has been provisioned
+     */
+    start_building?: boolean;
+  }
+}
+
+/**
+ * Developer Program application resource for Path B existing-company apply.
+ */
+export interface DeveloperProgramApplicationCreateResponse {
+  /**
+   * Stable application ID
+   */
+  id: string;
+
+  /**
+   * What the company plans to build on Rippling
+   */
+  build_description?: string;
+
+  /**
+   * Rippling company ID on the application
+   */
+  company_id?: string;
+
+  /**
+   * Applicant email on the application
+   */
+  email?: string;
+
+  /**
+   * Time after which ops can no longer approve this pending application
+   */
+  expires_at?: string;
+
+  /**
+   * Applicant role ID
+   */
+  role_id?: string;
+
+  /**
+   * Deprecated alias of id. Prefer id.
+   */
+  signup_id?: string;
+
+  /**
+   * Application checklist stages
+   */
+  stages?: DeveloperProgramApplicationCreateResponse.Stages;
+
+  /**
+   * Application status: EMAIL_VERIFICATION_PENDING, SUBMITTED, APPROVED, VERIFIED,
+   * REJECTED, or EXPIRED. Existing-company apply writes SUBMITTED and never
+   * EMAIL_VERIFICATION_PENDING. VERIFIED means provision finished, not email
+   * verified.
+   */
+  status?: 'EMAIL_VERIFICATION_PENDING' | 'SUBMITTED' | 'APPROVED' | 'VERIFIED' | 'REJECTED' | 'EXPIRED';
+
+  /**
+   * Time the application was submitted
+   */
+  submitted_at?: string;
+}
+
+export namespace DeveloperProgramApplicationCreateResponse {
+  /**
+   * Application checklist stages
+   */
+  export interface Stages {
+    /**
+     * Whether ops approved the application and provisioning is pending
+     */
+    access_ready?: boolean;
+
+    /**
+     * Whether the application has been submitted
+     */
+    application_submitted?: boolean;
+
+    /**
+     * Whether the applicant email is confirmed
+     */
+    email_confirmed?: boolean;
+
+    /**
+     * Whether Developer Program access has been provisioned
+     */
+    start_building?: boolean;
+  }
+}
+
+export interface DeveloperProgramApplicationCreateParams {
+  /**
+   * What the company plans to build on Rippling
+   */
+  build_description?: string;
+
+  /**
+   * Apply entrypoint: llm_cli_apply or web_apply
+   */
+  entrypoint?: 'llm_cli_apply' | 'web_apply';
+}
+
+export declare namespace DeveloperProgramApplication {
+  export {
+    type DeveloperProgramApplicationListResponse as DeveloperProgramApplicationListResponse,
+    type DeveloperProgramApplicationCreateResponse as DeveloperProgramApplicationCreateResponse,
+    type DeveloperProgramApplicationListResponsesPageCursorURL as DeveloperProgramApplicationListResponsesPageCursorURL,
+    type DeveloperProgramApplicationCreateParams as DeveloperProgramApplicationCreateParams,
+  };
+}

package/src/resources/developer-users.ts

@@ -0,0 +1,77 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { PageCursorURL, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+
+/**
+ * Developer Platform account and team management
+ */
+export class DeveloperUsers extends APIResource {
+  /**
+   * A list of App Shop publisher users.
+   *
+   * - Requires: `Developer Program`
+   * - Filterable fields: `email`, `role_state`
+   */
+  list(
+    query: DeveloperUserListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<DeveloperUserListResponsesPageCursorURL, DeveloperUserListResponse> {
+    return this._client.getAPIList('/developer-users/', PageCursorURL<DeveloperUserListResponse>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export type DeveloperUserListResponsesPageCursorURL = PageCursorURL<DeveloperUserListResponse>;
+
+/**
+ * App Shop Publishers Super Group member.
+ */
+export interface DeveloperUserListResponse {
+  /**
+   * Role ID of a member of the App Shop Publishers Super Group
+   */
+  id?: string;
+
+  /**
+   * The publisher's work or invite email
+   */
+  email?: string;
+
+  /**
+   * The publisher's full name
+   */
+  full_name?: string;
+
+  /**
+   * Whether this publisher is a Super Admin
+   */
+  is_super_admin?: boolean;
+
+  /**
+   * Role state: INIT, HIRED, ACCEPTED, ACTIVE, or TERMINATED
+   */
+  role_state?: 'INIT' | 'HIRED' | 'ACCEPTED' | 'ACTIVE' | 'TERMINATED';
+}
+
+export interface DeveloperUserListParams {
+  cursor?: string;
+
+  filter?: string;
+
+  /**
+   * The maximum number of results to return. Defaults to 50. Maximum is 100.
+   */
+  limit?: number;
+}
+
+export declare namespace DeveloperUsers {
+  export {
+    type DeveloperUserListResponse as DeveloperUserListResponse,
+    type DeveloperUserListResponsesPageCursorURL as DeveloperUserListResponsesPageCursorURL,
+    type DeveloperUserListParams as DeveloperUserListParams,
+  };
+}

package/src/resources/earnings-inputs.ts

@@ -83,6 +83,18 @@ export interface EarningsInputListResponse {
    */
   earning_code?: string;
 
+  /**
+   * End of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_end_date?: string;
+
+  /**
+   * Start of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_start_date?: string;
+
   /**
    * External reference identifier for this earning.
    */
@@ -159,6 +171,18 @@ export interface EarningsInputCreateResponse {
    */
   earning_code?: string;
 
+  /**
+   * End of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_end_date?: string;
+
+  /**
+   * Start of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_start_date?: string;
+
   /**
    * External reference identifier for this earning.
    */
@@ -233,6 +257,18 @@ export interface EarningsInputCreateParams {
    */
   earning_code?: string;
 
+  /**
+   * End of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_end_date?: string;
+
+  /**
+   * Start of the period this earning was earned. Used for regular-rate-of-pay (RROP)
+   * attribution. Distinct from pay_period_basis_date, which selects the pay run.
+   */
+  earning_start_date?: string;
+
   /**
    * External reference identifier for this earning.
    */

package/src/resources/hire-requirements.ts

@@ -0,0 +1,140 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+/**
+ * Baseline required fields for submitting hires by country and hire type
+ */
+export class HireRequirements extends APIResource {
+  /**
+   * Return baseline required fields for a country and hire type. POST /hires/
+   * remains authoritative for company-specific validation.
+   */
+  list(query: HireRequirementListParams, options?: RequestOptions): APIPromise<HireRequirementListResponse> {
+    return this._client.get('/hire-requirements/', { query, ...options });
+  }
+}
+
+/**
+ * Public GET /hire-requirements/ body. Shape matches hiring's catalog JSON.
+ */
+export interface HireRequirementListResponse {
+  /**
+   * ISO 3166-1 alpha-2 country code used for the lookup.
+   */
+  country_code: string;
+
+  /**
+   * Hiring-owned field catalog grouped by request section.
+   */
+  fields_by_group: Array<unknown>;
+
+  /**
+   * Hire type used for the lookup.
+   */
+  hire_type: string;
+
+  /**
+   * Catalog groups that apply for this selector tuple.
+   */
+  required_groups: Array<string>;
+
+  /**
+   * Baseline requirement contract version for this selector tuple.
+   */
+  requirements_version: string;
+
+  /**
+   * Item-level fields such as client_request_id.
+   */
+  top_level_fields?: Array<HireRequirementListResponse.TopLevelField>;
+
+  /**
+   * Public field paths that are not writable for this selector tuple.
+   */
+  unsupported_fields?: Array<string>;
+
+  /**
+   * Non-fatal warnings for this lookup.
+   */
+  warnings?: Array<string>;
+}
+
+export namespace HireRequirementListResponse {
+  export interface TopLevelField {
+    /**
+     * JSON type string, or a list of allowed types for custom-field values.
+     */
+    type: unknown;
+
+    /**
+     * Public field name relative to its group, or omitted for array item descriptors.
+     */
+    field?: string;
+
+    /**
+     * Nested object fields when type is object.
+     */
+    fields?: Array<unknown>;
+
+    /**
+     * date means YYYY-MM-DD.
+     */
+    format?: string;
+
+    items?: unknown;
+
+    /**
+     * Sibling-field condition when requiredness is dependent.
+     */
+    required_when?: TopLevelField.RequiredWhen;
+
+    /**
+     * required, optional, or dependent.
+     */
+    requiredness?: string;
+  }
+
+  export namespace TopLevelField {
+    /**
+     * Sibling-field condition when requiredness is dependent.
+     */
+    export interface RequiredWhen {
+      /**
+       * Sibling field in the same object that this condition inspects.
+       */
+      field: string;
+
+      /**
+       * equals, not_equals, present, or absent.
+       */
+      operator: string;
+
+      /**
+       * Comparison value for equals and not_equals. Omitted for present and absent.
+       */
+      value?: unknown;
+    }
+  }
+}
+
+export interface HireRequirementListParams {
+  /**
+   * ISO 3166-1 alpha-2 country code. First milestone supports US and CA.
+   */
+  country_code: string;
+
+  /**
+   * Hire type. First milestone supports direct_hire only.
+   */
+  hire_type: 'direct_hire';
+}
+
+export declare namespace HireRequirements {
+  export {
+    type HireRequirementListResponse as HireRequirementListResponse,
+    type HireRequirementListParams as HireRequirementListParams,
+  };
+}