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

package/src/resources/metadata/validation-runs.ts

@@ -10,71 +10,6 @@ import { path } from '../../internal/utils/path';
  * Custom objects defined by the company
  */
 export class ValidationRuns extends APIResource {
-  /**
-   * Queue validation for a metadata component package and return a run id for
-   * polling.
-   *
-   * Requires the Metadata entitlement.
-   *
-   * @example
-   * ```ts
-   * const response =
-   *   await client.metadata.validationRuns.createV2({
-   *     components: [
-   *       {
-   *         type: 'CUSTOM_OBJECT',
-   *         api_name: 'purchase_order__c',
-   *         name: 'Purchase Order',
-   *         description: 'Tracks purchase requests',
-   *         category_api_name: 'procurement__c',
-   *       },
-   *       {
-   *         type: 'CUSTOM_OBJECT_FIELD',
-   *         custom_object_api_name: 'purchase_order__c',
-   *         field_api_name: 'amount__c',
-   *         field_display_name: 'Amount',
-   *         data_type: {
-   *           field_type: 'CURRENCY',
-   *           currency: 'USD',
-   *           num_of_decimal_places: 2,
-   *         },
-   *         is_standard: false,
-   *       },
-   *     ],
-   *   });
-   * ```
-   */
-  createV2(
-    params: ValidationRunCreateV2Params,
-    options?: RequestOptions,
-  ): APIPromise<ValidationRunCreateV2Response> {
-    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
-    return this._client.post('/metadata/v2/validation-runs/', {
-      body,
-      ...options,
-      headers: buildHeaders([
-        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
-        options?.headers,
-      ]),
-    });
-  }
-
-  /**
-   * Poll a metadata validation run until the terminal field is true.
-   *
-   * Requires the Metadata entitlement.
-   *
-   * @example
-   * ```ts
-   * const response = await client.metadata.validationRuns.getV2(
-   *   'run_id',
-   * );
-   * ```
-   */
-  getV2(runID: string, options?: RequestOptions): APIPromise<ValidationRunGetV2Response> {
-    return this._client.get(path`/metadata/v2/validation-runs/${runID}/`, options);
-  }
-
   /**
    * Queue validation for a metadata component package and return a run id for
    * polling.
@@ -140,80 +75,6 @@ export class ValidationRuns extends APIResource {
   }
 }
 
-export interface ValidationRunCreateV2Response {
-  /**
-   * Metadata run id.
-   */
-  id: string;
-
-  progress: { [key: string]: unknown };
-
-  /**
-   * Suggested client polling delay in milliseconds.
-   */
-  retry_after_ms: number;
-
-  status: 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'expired';
-
-  /**
-   * Whether the run has reached a terminal status.
-   */
-  terminal: boolean;
-
-  type: 'validation' | 'deployment';
-
-  created_at?: string | null;
-
-  error?: { [key: string]: unknown } | null;
-
-  expires_at?: string | null;
-
-  finished_at?: string | null;
-
-  result?: { [key: string]: unknown } | null;
-
-  started_at?: string | null;
-
-  updated_at?: string | null;
-}
-
-export interface ValidationRunGetV2Response {
-  /**
-   * Metadata run id.
-   */
-  id: string;
-
-  progress: { [key: string]: unknown };
-
-  /**
-   * Suggested client polling delay in milliseconds.
-   */
-  retry_after_ms: number;
-
-  status: 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'expired';
-
-  /**
-   * Whether the run has reached a terminal status.
-   */
-  terminal: boolean;
-
-  type: 'validation' | 'deployment';
-
-  created_at?: string | null;
-
-  error?: { [key: string]: unknown } | null;
-
-  expires_at?: string | null;
-
-  finished_at?: string | null;
-
-  result?: { [key: string]: unknown } | null;
-
-  started_at?: string | null;
-
-  updated_at?: string | null;
-}
-
 export interface ValidationRunCreateResponse {
   /**
    * Metadata run id.
@@ -288,34 +149,6 @@ export interface ValidationRunGetResponse {
   updated_at?: string | null;
 }
 
-export interface ValidationRunCreateV2Params {
-  /**
-   * Body param: Complete package of metadata components, including dependencies.
-   */
-  components: Array<ValidationRunCreateV2Params.Component>;
-
-  /**
-   * Header param: Optional idempotency key used to deduplicate retried create
-   * requests.
-   */
-  'Idempotency-Key'?: string;
-}
-
-export namespace ValidationRunCreateV2Params {
-  /**
-   * A metadata component config. The `type` field selects the concrete component
-   * schema. Fetch type-specific fields from GET /metadata/schema/?type=<TYPE>.
-   */
-  export interface Component {
-    /**
-     * Metadata component type, such as CUSTOM_OBJECT or CUSTOM_OBJECT_FIELD.
-     */
-    type: string;
-
-    [k: string]: unknown;
-  }
-}
-
 export interface ValidationRunCreateParams {
   /**
    * Body param: Complete package of metadata components, including dependencies.
@@ -346,11 +179,8 @@ export namespace ValidationRunCreateParams {
 
 export declare namespace ValidationRuns {
   export {
-    type ValidationRunCreateV2Response as ValidationRunCreateV2Response,
-    type ValidationRunGetV2Response as ValidationRunGetV2Response,
     type ValidationRunCreateResponse as ValidationRunCreateResponse,
     type ValidationRunGetResponse as ValidationRunGetResponse,
-    type ValidationRunCreateV2Params as ValidationRunCreateV2Params,
     type ValidationRunCreateParams as ValidationRunCreateParams,
   };
 }

package/src/resources/package-sandbox-links.ts

@@ -0,0 +1,195 @@
+// 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';
+import { path } from '../internal/utils/path';
+
+/**
+ * Author, publish, and install Unity Packages V2 packages
+ */
+export class PackageSandboxLinks extends APIResource {
+  /**
+   * Link a package to a sandbox in EDIT or INSTALL mode.
+   */
+  create(
+    body: PackageSandboxLinkCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<PackageSandboxLinkCreateResponse> {
+    return this._client.post('/package-sandbox-links/', { body, ...options });
+  }
+
+  /**
+   * Retrieve the status of a package sandbox link.
+   */
+  retrieve(trackerID: string, options?: RequestOptions): APIPromise<PackageSandboxLinkRetrieveResponse> {
+    return this._client.get(path`/package-sandbox-links/${trackerID}/`, options);
+  }
+}
+
+/**
+ * Request to link a package to a sandbox, or poll an EDIT-mode installation
+ * tracker.
+ */
+export interface PackageSandboxLinkCreateResponse {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * How the sandbox is linked to the package (INSTALL or EDIT)
+   */
+  mode: string;
+
+  /**
+   * The package key to link into the sandbox
+   */
+  package_key: string;
+
+  /**
+   * The company receiving the sandbox package installation
+   */
+  sandbox_company_id: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * Error message when EDIT-mode linking failed
+   */
+  error_message?: string;
+
+  /**
+   * Installation record ID when EDIT-mode linking completes
+   */
+  installation_record_id?: string;
+
+  /**
+   * The internal sandbox installation tracker ID
+   */
+  installation_tracker_id?: string;
+
+  /**
+   * The package version being linked in EDIT mode
+   */
+  package_version_id?: string;
+
+  /**
+   * Component to open after EDIT-mode linking completes
+   */
+  post_install_landing_component?: unknown;
+
+  /**
+   * EDIT-mode installation progress entries
+   */
+  progress?: Array<unknown>;
+
+  /**
+   * INSTALL completion status, or EDIT installation tracker status
+   */
+  status?: string;
+}
+
+/**
+ * Request to link a package to a sandbox, or poll an EDIT-mode installation
+ * tracker.
+ */
+export interface PackageSandboxLinkRetrieveResponse {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * How the sandbox is linked to the package (INSTALL or EDIT)
+   */
+  mode: string;
+
+  /**
+   * The package key to link into the sandbox
+   */
+  package_key: string;
+
+  /**
+   * The company receiving the sandbox package installation
+   */
+  sandbox_company_id: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * Error message when EDIT-mode linking failed
+   */
+  error_message?: string;
+
+  /**
+   * Installation record ID when EDIT-mode linking completes
+   */
+  installation_record_id?: string;
+
+  /**
+   * The internal sandbox installation tracker ID
+   */
+  installation_tracker_id?: string;
+
+  /**
+   * The package version being linked in EDIT mode
+   */
+  package_version_id?: string;
+
+  /**
+   * Component to open after EDIT-mode linking completes
+   */
+  post_install_landing_component?: unknown;
+
+  /**
+   * EDIT-mode installation progress entries
+   */
+  progress?: Array<unknown>;
+
+  /**
+   * INSTALL completion status, or EDIT installation tracker status
+   */
+  status?: string;
+}
+
+export interface PackageSandboxLinkCreateParams {
+  /**
+   * How the sandbox is linked to the package (INSTALL or EDIT)
+   */
+  mode: string;
+
+  /**
+   * The package key to link into the sandbox
+   */
+  package_key: string;
+
+  /**
+   * The company receiving the sandbox package installation
+   */
+  sandbox_company_id: string;
+}
+
+export declare namespace PackageSandboxLinks {
+  export {
+    type PackageSandboxLinkCreateResponse as PackageSandboxLinkCreateResponse,
+    type PackageSandboxLinkRetrieveResponse as PackageSandboxLinkRetrieveResponse,
+    type PackageSandboxLinkCreateParams as PackageSandboxLinkCreateParams,
+  };
+}

package/src/resources/package-upgrades.ts

@@ -0,0 +1,183 @@
+// 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';
+import { path } from '../internal/utils/path';
+
+/**
+ * Author, publish, and install Unity Packages V2 packages
+ */
+export class PackageUpgrades extends APIResource {
+  /**
+   * Start upgrading a managed package install asynchronously.
+   */
+  create(
+    body: PackageUpgradeCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<PackageUpgradeCreateResponse> {
+    return this._client.post('/package-upgrades/', { body, ...options });
+  }
+
+  /**
+   * Retrieve the status of a managed package upgrade.
+   */
+  retrieve(trackerID: string, options?: RequestOptions): APIPromise<PackageUpgradeRetrieveResponse> {
+    return this._client.get(path`/package-upgrades/${trackerID}/`, options);
+  }
+}
+
+/**
+ * Async managed package upgrade tracker for subscriber companies.
+ */
+export interface PackageUpgradeCreateResponse {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * Error message when upgrade failed
+   */
+  error_message?: string;
+
+  /**
+   * The install key of the managed package install
+   */
+  install_key?: string;
+
+  /**
+   * The published package version being upgraded to
+   */
+  new_version_id?: string;
+
+  /**
+   * The currently installed package version being upgraded from
+   */
+  old_version_id?: string;
+
+  /**
+   * The package key of the managed package
+   */
+  package_key?: string;
+
+  /**
+   * Component to open after upgrade completes
+   */
+  post_install_landing_component?: unknown;
+
+  /**
+   * Upgrade status (IN_PROGRESS, COMPLETE, or FAILED)
+   */
+  status?: string;
+
+  /**
+   * Upgrade plan snapshot when available
+   */
+  upgrade_plan?: unknown;
+
+  /**
+   * Components upgraded so far
+   */
+  upgraded_components?: Array<unknown>;
+}
+
+/**
+ * Async managed package upgrade tracker for subscriber companies.
+ */
+export interface PackageUpgradeRetrieveResponse {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * Error message when upgrade failed
+   */
+  error_message?: string;
+
+  /**
+   * The install key of the managed package install
+   */
+  install_key?: string;
+
+  /**
+   * The published package version being upgraded to
+   */
+  new_version_id?: string;
+
+  /**
+   * The currently installed package version being upgraded from
+   */
+  old_version_id?: string;
+
+  /**
+   * The package key of the managed package
+   */
+  package_key?: string;
+
+  /**
+   * Component to open after upgrade completes
+   */
+  post_install_landing_component?: unknown;
+
+  /**
+   * Upgrade status (IN_PROGRESS, COMPLETE, or FAILED)
+   */
+  status?: string;
+
+  /**
+   * Upgrade plan snapshot when available
+   */
+  upgrade_plan?: unknown;
+
+  /**
+   * Components upgraded so far
+   */
+  upgraded_components?: Array<unknown>;
+}
+
+export interface PackageUpgradeCreateParams {
+  /**
+   * The install key of the managed package install to upgrade.
+   */
+  install_key: string;
+
+  /**
+   * The package key of the managed package to upgrade.
+   */
+  package_key: string;
+
+  /**
+   * The published package version to upgrade to.
+   */
+  version_id: string;
+}
+
+export declare namespace PackageUpgrades {
+  export {
+    type PackageUpgradeCreateResponse as PackageUpgradeCreateResponse,
+    type PackageUpgradeRetrieveResponse as PackageUpgradeRetrieveResponse,
+    type PackageUpgradeCreateParams as PackageUpgradeCreateParams,
+  };
+}

package/src/resources/package-versions/index.ts

@@ -1,8 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { NextVersions, type NextVersionCreateResponse, type NextVersionCreateParams } from './next-versions';
 export {
   PackageVersions,
+  type PackageVersionRetrieveResponse,
   type PackageVersionUpdateResponse,
   type PackageVersionUpdateParams,
 } from './package-versions';
+export { Publish, type PublishCreateResponse } from './publish';

package/src/resources/package-versions/package-versions.ts

@@ -1,8 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as NextVersionsAPI from './next-versions';
-import { NextVersionCreateParams, NextVersionCreateResponse, NextVersions } from './next-versions';
+import * as PublishAPI from './publish';
+import { Publish, PublishCreateResponse } from './publish';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -11,7 +11,14 @@ import { path } from '../../internal/utils/path';
  * Author, publish, and install Unity Packages V2 packages
  */
 export class PackageVersions extends APIResource {
-  nextVersions: NextVersionsAPI.NextVersions = new NextVersionsAPI.NextVersions(this._client);
+  publish: PublishAPI.Publish = new PublishAPI.Publish(this._client);
+
+  /**
+   * Get a package version by ID.
+   */
+  retrieve(versionID: string, options?: RequestOptions): APIPromise<PackageVersionRetrieveResponse> {
+    return this._client.get(path`/package-versions/${versionID}/`, options);
+  }
 
   /**
    * Update the description of an unpublished package version.
@@ -25,6 +32,58 @@ export class PackageVersions extends APIResource {
   }
 }
 
+export interface PackageVersionRetrieveResponse {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * The semantic version number for this package version
+   */
+  version_number: string;
+
+  /**
+   * Components included in this package version
+   */
+  components?: Array<unknown>;
+
+  /**
+   * The description of the package version
+   */
+  description?: string;
+
+  /**
+   * Whether this package version has been published
+   */
+  is_published?: boolean;
+
+  /**
+   * The display name of the parent package
+   */
+  package_display_name?: string;
+
+  /**
+   * The ID of the parent package
+   */
+  package_id?: string;
+
+  /**
+   * The package key of the parent package
+   */
+  package_key?: string;
+}
+
 export interface PackageVersionUpdateResponse {
   /**
    * Identifier field
@@ -84,17 +143,14 @@ export interface PackageVersionUpdateParams {
   description: string;
 }
 
-PackageVersions.NextVersions = NextVersions;
+PackageVersions.Publish = Publish;
 
 export declare namespace PackageVersions {
   export {
+    type PackageVersionRetrieveResponse as PackageVersionRetrieveResponse,
     type PackageVersionUpdateResponse as PackageVersionUpdateResponse,
     type PackageVersionUpdateParams as PackageVersionUpdateParams,
   };
 
-  export {
-    NextVersions as NextVersions,
-    type NextVersionCreateResponse as NextVersionCreateResponse,
-    type NextVersionCreateParams as NextVersionCreateParams,
-  };
+  export { Publish as Publish, type PublishCreateResponse as PublishCreateResponse };
 }