@rippling/rippling-sdk 0.2.0-alpha.88 → 0.2.0-alpha.89

package/resources/metadata/validation-runs.d.mts

@@ -0,0 +1,275 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Custom objects defined by the company
+ */
+export declare 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>;
+    /**
+     * 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>;
+    /**
+     * Queue validation for a metadata component package and return a run id for
+     * polling.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const validationRun =
+     *   await client.metadata.validationRuns.create({
+     *     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,
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    create(params: ValidationRunCreateParams, options?: RequestOptions): APIPromise<ValidationRunCreateResponse>;
+    /**
+     * Poll a metadata validation run until the terminal field is true.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const validationRun =
+     *   await client.metadata.validationRuns.get('run_id');
+     * ```
+     */
+    get(runID: string, options?: RequestOptions): APIPromise<ValidationRunGetResponse>;
+}
+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.
+     */
+    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 ValidationRunGetResponse {
+    /**
+     * 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 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 declare namespace ValidationRunCreateV2Params {
+    /**
+     * A metadata component config. The `type` field selects the concrete component
+     * schema. Fetch type-specific fields from GET /metadata/schema/?type=<TYPE>.
+     */
+    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.
+     */
+    components: Array<ValidationRunCreateParams.Component>;
+    /**
+     * Header param: Optional idempotency key used to deduplicate retried create
+     * requests.
+     */
+    'Idempotency-Key'?: string;
+}
+export declare namespace ValidationRunCreateParams {
+    /**
+     * A metadata component config. The `type` field selects the concrete component
+     * schema. Fetch type-specific fields from GET /metadata/schema/?type=<TYPE>.
+     */
+    interface Component {
+        /**
+         * Metadata component type, such as CUSTOM_OBJECT or CUSTOM_OBJECT_FIELD.
+         */
+        type: string;
+        [k: string]: unknown;
+    }
+}
+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, };
+}
+//# sourceMappingURL=validation-runs.d.mts.map

package/resources/metadata/validation-runs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-runs.d.mts","sourceRoot":"","sources":["../../src/resources/metadata/validation-runs.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,275 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Custom objects defined by the company
+ */
+export declare 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>;
+    /**
+     * 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>;
+    /**
+     * Queue validation for a metadata component package and return a run id for
+     * polling.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const validationRun =
+     *   await client.metadata.validationRuns.create({
+     *     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,
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    create(params: ValidationRunCreateParams, options?: RequestOptions): APIPromise<ValidationRunCreateResponse>;
+    /**
+     * Poll a metadata validation run until the terminal field is true.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const validationRun =
+     *   await client.metadata.validationRuns.get('run_id');
+     * ```
+     */
+    get(runID: string, options?: RequestOptions): APIPromise<ValidationRunGetResponse>;
+}
+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.
+     */
+    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 ValidationRunGetResponse {
+    /**
+     * 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 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 declare namespace ValidationRunCreateV2Params {
+    /**
+     * A metadata component config. The `type` field selects the concrete component
+     * schema. Fetch type-specific fields from GET /metadata/schema/?type=<TYPE>.
+     */
+    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.
+     */
+    components: Array<ValidationRunCreateParams.Component>;
+    /**
+     * Header param: Optional idempotency key used to deduplicate retried create
+     * requests.
+     */
+    'Idempotency-Key'?: string;
+}
+export declare namespace ValidationRunCreateParams {
+    /**
+     * A metadata component config. The `type` field selects the concrete component
+     * schema. Fetch type-specific fields from GET /metadata/schema/?type=<TYPE>.
+     */
+    interface Component {
+        /**
+         * Metadata component type, such as CUSTOM_OBJECT or CUSTOM_OBJECT_FIELD.
+         */
+        type: string;
+        [k: string]: unknown;
+    }
+}
+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, };
+}
+//# sourceMappingURL=validation-runs.d.ts.map

package/resources/metadata/validation-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-runs.d.ts","sourceRoot":"","sources":["../../src/resources/metadata/validation-runs.ts"],"names":[],"mappings":"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"}

package/resources/metadata/validation-runs.js

@@ -0,0 +1,133 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationRuns = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Custom objects defined by the company
+ */
+class ValidationRuns extends resource_1.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, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/metadata/v2/validation-runs/', {
+            body,
+            ...options,
+            headers: (0, headers_1.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, options) {
+        return this._client.get((0, path_1.path) `/metadata/v2/validation-runs/${runID}/`, options);
+    }
+    /**
+     * Queue validation for a metadata component package and return a run id for
+     * polling.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const validationRun =
+     *   await client.metadata.validationRuns.create({
+     *     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,
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/metadata/validation-runs/', {
+            body,
+            ...options,
+            headers: (0, headers_1.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 validationRun =
+     *   await client.metadata.validationRuns.get('run_id');
+     * ```
+     */
+    get(runID, options) {
+        return this._client.get((0, path_1.path) `/metadata/validation-runs/${runID}/`, options);
+    }
+}
+exports.ValidationRuns = ValidationRuns;
+//# sourceMappingURL=validation-runs.js.map