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

package/resources/metadata/components.d.mts.map

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

package/resources/metadata/components.d.ts

@@ -0,0 +1,544 @@
+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 Components extends APIResource {
+    /**
+     * Extract the company's selectable metadata components, optionally filtered by a
+     * search query.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const response = await client.metadata.components.extract();
+     * ```
+     */
+    extract(query?: ComponentExtractParams | null | undefined, options?: RequestOptions): APIPromise<ComponentExtractResponse>;
+    /**
+     * Validate component schemas and dependencies without installing them. Use the
+     * normalized results before deploy.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.metadata.components.validateV2({
+     *     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,
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    validateV2(body: ComponentValidateV2Params, options?: RequestOptions): APIPromise<ComponentValidateV2Response>;
+    /**
+     * Validate a complete metadata component package without installing it.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const response = await client.metadata.components.validate({
+     *   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,
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    validate(body: ComponentValidateParams, options?: RequestOptions): APIPromise<ComponentValidateResponse>;
+    /**
+     * Create or update the supplied metadata components as one package. Call
+     * validation first and deploy only valid input.
+     *
+     * Requires the Metadata entitlement.
+     *
+     * @example
+     * ```ts
+     * const response = await client.metadata.components.deploy({
+     *   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,
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    deploy(body: ComponentDeployParams, options?: RequestOptions): APIPromise<ComponentDeployResponse>;
+}
+export interface ComponentExtractResponse {
+    /**
+     * Full component configs needed to recreate the selected roots.
+     */
+    component_configs: Array<ComponentExtractResponse.ComponentConfig>;
+    /**
+     * Serialized dependency graph for the extracted package.
+     */
+    dependency_graph: {
+        [key: string]: unknown;
+    };
+    /**
+     * Topological install order for the extracted package.
+     */
+    install_order: Array<{
+        [key: string]: unknown;
+    }>;
+    /**
+     * Components selected as extraction roots.
+     */
+    root_components: Array<ComponentExtractResponse.RootComponent>;
+    /**
+     * For search-backed extraction, whether contextual expansion completed.
+     */
+    context_complete?: boolean;
+    /**
+     * Warnings from search-backed contextual expansion.
+     */
+    context_warnings?: Array<string>;
+    external_managed_dependencies?: Array<{
+        [key: string]: unknown;
+    }>;
+    [k: string]: unknown;
+}
+export declare namespace ComponentExtractResponse {
+    /**
+     * A metadata component config. The `type` field selects the concrete component
+     * schema. Fetch type-specific fields from GET /metadata/schema/?type=<TYPE>.
+     */
+    interface ComponentConfig {
+        /**
+         * Metadata component type, such as CUSTOM_OBJECT or CUSTOM_OBJECT_FIELD.
+         */
+        type: string;
+        [k: string]: unknown;
+    }
+    /**
+     * Selectable package root returned by metadata extraction.
+     */
+    interface RootComponent {
+        /**
+         * Identifier for the selected component.
+         */
+        identifier?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Display name for the selectable component.
+         */
+        name?: string;
+        [k: string]: unknown;
+    }
+}
+export interface ComponentValidateV2Response {
+    /**
+     * Package-level validation issues.
+     */
+    errors: Array<ComponentValidateV2Response.Error>;
+    /**
+     * Per-component validation results.
+     */
+    results: Array<ComponentValidateV2Response.Result>;
+    /**
+     * True only when every component and dependency check passed.
+     */
+    valid: boolean;
+}
+export declare namespace ComponentValidateV2Response {
+    /**
+     * A validation, dependency, permission, or deployment issue.
+     */
+    interface Error {
+        /**
+         * Stable machine-readable issue code.
+         */
+        code: string;
+        /**
+         * Human-readable remediation message.
+         */
+        message: string;
+        /**
+         * Lower-level cause associated with the issue, when available.
+         */
+        cause?: string | null;
+        /**
+         * Component type associated with the issue, when available.
+         */
+        component_type?: string | null;
+        [k: string]: unknown;
+    }
+    interface Result {
+        /**
+         * Metadata component type.
+         */
+        type: string;
+        /**
+         * Whether this component passed validation.
+         */
+        valid: boolean;
+        errors?: Array<Result.Error>;
+        /**
+         * Existing component config matched by the identifier, when available.
+         */
+        existing?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Resolved component identifier.
+         */
+        identifier?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Merged target state for updates, when available.
+         */
+        merged?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Schema-normalized component config.
+         */
+        normalized?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Upsert classification computed during validation.
+         */
+        outcome?: 'CREATE' | 'NO_OP' | 'UPDATE' | 'UNSUPPORTED_UPDATE' | null;
+        [k: string]: unknown;
+    }
+    namespace Result {
+        /**
+         * A validation, dependency, permission, or deployment issue.
+         */
+        interface Error {
+            /**
+             * Stable machine-readable issue code.
+             */
+            code: string;
+            /**
+             * Human-readable remediation message.
+             */
+            message: string;
+            /**
+             * Lower-level cause associated with the issue, when available.
+             */
+            cause?: string | null;
+            /**
+             * Component type associated with the issue, when available.
+             */
+            component_type?: string | null;
+            [k: string]: unknown;
+        }
+    }
+}
+export interface ComponentValidateResponse {
+    /**
+     * Package-level validation issues.
+     */
+    errors: Array<ComponentValidateResponse.Error>;
+    /**
+     * Per-component validation results.
+     */
+    results: Array<ComponentValidateResponse.Result>;
+    /**
+     * True only when every component and dependency check passed.
+     */
+    valid: boolean;
+}
+export declare namespace ComponentValidateResponse {
+    /**
+     * A validation, dependency, permission, or deployment issue.
+     */
+    interface Error {
+        /**
+         * Stable machine-readable issue code.
+         */
+        code: string;
+        /**
+         * Human-readable remediation message.
+         */
+        message: string;
+        /**
+         * Lower-level cause associated with the issue, when available.
+         */
+        cause?: string | null;
+        /**
+         * Component type associated with the issue, when available.
+         */
+        component_type?: string | null;
+        [k: string]: unknown;
+    }
+    interface Result {
+        /**
+         * Metadata component type.
+         */
+        type: string;
+        /**
+         * Whether this component passed validation.
+         */
+        valid: boolean;
+        errors?: Array<Result.Error>;
+        /**
+         * Existing component config matched by the identifier, when available.
+         */
+        existing?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Resolved component identifier.
+         */
+        identifier?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Merged target state for updates, when available.
+         */
+        merged?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Schema-normalized component config.
+         */
+        normalized?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Upsert classification computed during validation.
+         */
+        outcome?: 'CREATE' | 'NO_OP' | 'UPDATE' | 'UNSUPPORTED_UPDATE' | null;
+        [k: string]: unknown;
+    }
+    namespace Result {
+        /**
+         * A validation, dependency, permission, or deployment issue.
+         */
+        interface Error {
+            /**
+             * Stable machine-readable issue code.
+             */
+            code: string;
+            /**
+             * Human-readable remediation message.
+             */
+            message: string;
+            /**
+             * Lower-level cause associated with the issue, when available.
+             */
+            cause?: string | null;
+            /**
+             * Component type associated with the issue, when available.
+             */
+            component_type?: string | null;
+            [k: string]: unknown;
+        }
+    }
+}
+export interface ComponentDeployResponse {
+    /**
+     * Per-component deployment results.
+     */
+    installations: Array<ComponentDeployResponse.Installation>;
+    /**
+     * Whether the package deployment completed.
+     */
+    success: boolean;
+    /**
+     * A validation, dependency, permission, or deployment issue.
+     */
+    error?: ComponentDeployResponse.Error;
+}
+export declare namespace ComponentDeployResponse {
+    interface Installation {
+        /**
+         * Installed component identifier.
+         */
+        identifier: {
+            [key: string]: unknown;
+        };
+        /**
+         * Per-component install result.
+         */
+        status: 'SUCCESS' | 'FAILED' | 'SKIPPED_ALREADY_EXISTS' | 'UPDATED' | 'SKIPPED_NO_CHANGES';
+        /**
+         * Metadata component type.
+         */
+        type: string;
+        /**
+         * Navigation target for the installed component, when available.
+         */
+        navigation_target?: Installation.NavigationTarget | null;
+        /**
+         * Type-specific install result.
+         */
+        result?: {
+            [key: string]: unknown;
+        };
+        [k: string]: unknown;
+    }
+    namespace Installation {
+        /**
+         * Navigation target for the installed component, when available.
+         */
+        interface NavigationTarget {
+            /**
+             * Type of UI target.
+             */
+            target_type: string;
+            /**
+             * Display title for the navigation target.
+             */
+            title: string;
+            /**
+             * Relative URL for the installed component.
+             */
+            url: string;
+        }
+    }
+    /**
+     * A validation, dependency, permission, or deployment issue.
+     */
+    interface Error {
+        /**
+         * Stable machine-readable issue code.
+         */
+        code: string;
+        /**
+         * Human-readable remediation message.
+         */
+        message: string;
+        /**
+         * Lower-level cause associated with the issue, when available.
+         */
+        cause?: string | null;
+        /**
+         * Component type associated with the issue, when available.
+         */
+        component_type?: string | null;
+        [k: string]: unknown;
+    }
+}
+export interface ComponentExtractParams {
+    /**
+     * Maximum search results to return when q is provided.
+     */
+    limit?: number;
+    /**
+     * Optional text search over selectable components.
+     */
+    q?: string;
+}
+export interface ComponentValidateV2Params {
+    /**
+     * Complete package of metadata components, including dependencies.
+     */
+    components: Array<ComponentValidateV2Params.Component>;
+}
+export declare namespace ComponentValidateV2Params {
+    /**
+     * 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 ComponentValidateParams {
+    /**
+     * Complete package of metadata components, including dependencies.
+     */
+    components: Array<ComponentValidateParams.Component>;
+}
+export declare namespace ComponentValidateParams {
+    /**
+     * 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 ComponentDeployParams {
+    /**
+     * Complete package of metadata components, including dependencies.
+     */
+    components: Array<ComponentDeployParams.Component>;
+}
+export declare namespace ComponentDeployParams {
+    /**
+     * 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 Components {
+    export { type ComponentExtractResponse as ComponentExtractResponse, type ComponentValidateV2Response as ComponentValidateV2Response, type ComponentValidateResponse as ComponentValidateResponse, type ComponentDeployResponse as ComponentDeployResponse, type ComponentExtractParams as ComponentExtractParams, type ComponentValidateV2Params as ComponentValidateV2Params, type ComponentValidateParams as ComponentValidateParams, type ComponentDeployParams as ComponentDeployParams, };
+}
+//# sourceMappingURL=components.d.ts.map

package/resources/metadata/components.d.ts.map

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