@amp-labs/react 1.0.0

package/build/generated-sources/api/src/models/HydratedRevision.js

@@ -0,0 +1,60 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HydratedRevisionToJSON = exports.HydratedRevisionFromJSONTyped = exports.HydratedRevisionFromJSON = exports.instanceOfHydratedRevision = void 0;
+const HydratedIntegration_1 = require("./HydratedIntegration");
+/**
+ * Check if a given object implements the HydratedRevision interface.
+ */
+function instanceOfHydratedRevision(value) {
+    let isInstance = true;
+    isInstance = isInstance && "id" in value;
+    isInstance = isInstance && "specVersion" in value;
+    isInstance = isInstance && "createTime" in value;
+    isInstance = isInstance && "content" in value;
+    return isInstance;
+}
+exports.instanceOfHydratedRevision = instanceOfHydratedRevision;
+function HydratedRevisionFromJSON(json) {
+    return HydratedRevisionFromJSONTyped(json, false);
+}
+exports.HydratedRevisionFromJSON = HydratedRevisionFromJSON;
+function HydratedRevisionFromJSONTyped(json, ignoreDiscriminator) {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        'id': json['id'],
+        'specVersion': json['specVersion'],
+        'createTime': (new Date(json['createTime'])),
+        'content': (0, HydratedIntegration_1.HydratedIntegrationFromJSON)(json['content']),
+    };
+}
+exports.HydratedRevisionFromJSONTyped = HydratedRevisionFromJSONTyped;
+function HydratedRevisionToJSON(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        'id': value.id,
+        'specVersion': value.specVersion,
+        'createTime': (value.createTime.toISOString()),
+        'content': (0, HydratedIntegration_1.HydratedIntegrationToJSON)(value.content),
+    };
+}
+exports.HydratedRevisionToJSON = HydratedRevisionToJSON;

package/build/generated-sources/api/src/models/ImportConnectionRequest.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface ImportConnectionRequest
+ */
+export interface ImportConnectionRequest {
+    /**
+     * The SaaS provider that this installation connects to.
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    provider: string;
+    /**
+     * ID of the provider app (e.g. Salesforce connected app), returned from a CreateProviderApp call. If omitted, the default provider app that was set up on the Ampersand Console is assumed.
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    providerAppId?: string;
+    /**
+     * The ID of the user group that has access to this installation. This is any ID that your app uses to identify a group of users - such as an org, team, or workspace.
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    groupRef: string;
+    /**
+     * The display name of the user group that has access to this installation.
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    groupName: string;
+    /**
+     * The ID of the user whose credential was used for this connection. This is the ID that your app uses to identify a user - such as a user ID or username.
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    consumerRef: string;
+    /**
+     * The display name of the user whose credential was used for this connection.
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    consumerName: string;
+    /**
+     * The identifier for the provider workspace (e.g. the Salesforce subdomain)
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    providerWorkspaceRef: string;
+    /**
+     * The ID that Salesforce/Hubspot uses to identify this user (e.g. Salesforce has IDs in the form of https://login.salesforce.com/id/00D4x0000019CQTEA2/0054x000000orJ4AA)
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    providerConsumerRef?: string;
+    /**
+     * The refresh token.
+     * @type {string}
+     * @memberof ImportConnectionRequest
+     */
+    refreshToken: string;
+    /**
+     * The OAuth scopes for this token. If it is unknown, then leave this field empty.
+     * @type {Array<string>}
+     * @memberof ImportConnectionRequest
+     */
+    scopes?: Array<string>;
+}
+/**
+ * Check if a given object implements the ImportConnectionRequest interface.
+ */
+export declare function instanceOfImportConnectionRequest(value: object): boolean;
+export declare function ImportConnectionRequestFromJSON(json: any): ImportConnectionRequest;
+export declare function ImportConnectionRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ImportConnectionRequest;
+export declare function ImportConnectionRequestToJSON(value?: ImportConnectionRequest | null): any;

package/build/generated-sources/api/src/models/ImportConnectionRequest.js

@@ -0,0 +1,75 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportConnectionRequestToJSON = exports.ImportConnectionRequestFromJSONTyped = exports.ImportConnectionRequestFromJSON = exports.instanceOfImportConnectionRequest = void 0;
+const runtime_1 = require("../runtime");
+/**
+ * Check if a given object implements the ImportConnectionRequest interface.
+ */
+function instanceOfImportConnectionRequest(value) {
+    let isInstance = true;
+    isInstance = isInstance && "provider" in value;
+    isInstance = isInstance && "groupRef" in value;
+    isInstance = isInstance && "groupName" in value;
+    isInstance = isInstance && "consumerRef" in value;
+    isInstance = isInstance && "consumerName" in value;
+    isInstance = isInstance && "providerWorkspaceRef" in value;
+    isInstance = isInstance && "refreshToken" in value;
+    return isInstance;
+}
+exports.instanceOfImportConnectionRequest = instanceOfImportConnectionRequest;
+function ImportConnectionRequestFromJSON(json) {
+    return ImportConnectionRequestFromJSONTyped(json, false);
+}
+exports.ImportConnectionRequestFromJSON = ImportConnectionRequestFromJSON;
+function ImportConnectionRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        'provider': json['provider'],
+        'providerAppId': !(0, runtime_1.exists)(json, 'providerAppId') ? undefined : json['providerAppId'],
+        'groupRef': json['groupRef'],
+        'groupName': json['groupName'],
+        'consumerRef': json['consumerRef'],
+        'consumerName': json['consumerName'],
+        'providerWorkspaceRef': json['providerWorkspaceRef'],
+        'providerConsumerRef': !(0, runtime_1.exists)(json, 'providerConsumerRef') ? undefined : json['providerConsumerRef'],
+        'refreshToken': json['refreshToken'],
+        'scopes': !(0, runtime_1.exists)(json, 'scopes') ? undefined : json['scopes'],
+    };
+}
+exports.ImportConnectionRequestFromJSONTyped = ImportConnectionRequestFromJSONTyped;
+function ImportConnectionRequestToJSON(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        'provider': value.provider,
+        'providerAppId': value.providerAppId,
+        'groupRef': value.groupRef,
+        'groupName': value.groupName,
+        'consumerRef': value.consumerRef,
+        'consumerName': value.consumerName,
+        'providerWorkspaceRef': value.providerWorkspaceRef,
+        'providerConsumerRef': value.providerConsumerRef,
+        'refreshToken': value.refreshToken,
+        'scopes': value.scopes,
+    };
+}
+exports.ImportConnectionRequestToJSON = ImportConnectionRequestToJSON;

package/build/generated-sources/api/src/models/ImportInstallationRequest.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { ImportConnectionRequest } from './ImportConnectionRequest';
+import type { ImportInstallationRequestConfig } from './ImportInstallationRequestConfig';
+/**
+ *
+ * @export
+ * @interface ImportInstallationRequest
+ */
+export interface ImportInstallationRequest {
+    /**
+     *
+     * @type {ImportConnectionRequest}
+     * @memberof ImportInstallationRequest
+     */
+    connection: ImportConnectionRequest;
+    /**
+     *
+     * @type {ImportInstallationRequestConfig}
+     * @memberof ImportInstallationRequest
+     */
+    config: ImportInstallationRequestConfig;
+}
+/**
+ * Check if a given object implements the ImportInstallationRequest interface.
+ */
+export declare function instanceOfImportInstallationRequest(value: object): boolean;
+export declare function ImportInstallationRequestFromJSON(json: any): ImportInstallationRequest;
+export declare function ImportInstallationRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ImportInstallationRequest;
+export declare function ImportInstallationRequestToJSON(value?: ImportInstallationRequest | null): any;

package/build/generated-sources/api/src/models/ImportInstallationRequest.js

@@ -0,0 +1,55 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportInstallationRequestToJSON = exports.ImportInstallationRequestFromJSONTyped = exports.ImportInstallationRequestFromJSON = exports.instanceOfImportInstallationRequest = void 0;
+const ImportConnectionRequest_1 = require("./ImportConnectionRequest");
+const ImportInstallationRequestConfig_1 = require("./ImportInstallationRequestConfig");
+/**
+ * Check if a given object implements the ImportInstallationRequest interface.
+ */
+function instanceOfImportInstallationRequest(value) {
+    let isInstance = true;
+    isInstance = isInstance && "connection" in value;
+    isInstance = isInstance && "config" in value;
+    return isInstance;
+}
+exports.instanceOfImportInstallationRequest = instanceOfImportInstallationRequest;
+function ImportInstallationRequestFromJSON(json) {
+    return ImportInstallationRequestFromJSONTyped(json, false);
+}
+exports.ImportInstallationRequestFromJSON = ImportInstallationRequestFromJSON;
+function ImportInstallationRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        'connection': (0, ImportConnectionRequest_1.ImportConnectionRequestFromJSON)(json['connection']),
+        'config': (0, ImportInstallationRequestConfig_1.ImportInstallationRequestConfigFromJSON)(json['config']),
+    };
+}
+exports.ImportInstallationRequestFromJSONTyped = ImportInstallationRequestFromJSONTyped;
+function ImportInstallationRequestToJSON(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        'connection': (0, ImportConnectionRequest_1.ImportConnectionRequestToJSON)(value.connection),
+        'config': (0, ImportInstallationRequestConfig_1.ImportInstallationRequestConfigToJSON)(value.config),
+    };
+}
+exports.ImportInstallationRequestToJSON = ImportInstallationRequestToJSON;

package/build/generated-sources/api/src/models/ImportInstallationRequestConfig.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { ConfigContent } from './ConfigContent';
+/**
+ * The config of the installation.
+ * @export
+ * @interface ImportInstallationRequestConfig
+ */
+export interface ImportInstallationRequestConfig {
+    /**
+     * The ID of the integration revision that this config is based on. If omitted, the latest revision is assumed.
+     * @type {string}
+     * @memberof ImportInstallationRequestConfig
+     */
+    revisionId?: string;
+    /**
+     *
+     * @type {ConfigContent}
+     * @memberof ImportInstallationRequestConfig
+     */
+    content: ConfigContent;
+}
+/**
+ * Check if a given object implements the ImportInstallationRequestConfig interface.
+ */
+export declare function instanceOfImportInstallationRequestConfig(value: object): boolean;
+export declare function ImportInstallationRequestConfigFromJSON(json: any): ImportInstallationRequestConfig;
+export declare function ImportInstallationRequestConfigFromJSONTyped(json: any, ignoreDiscriminator: boolean): ImportInstallationRequestConfig;
+export declare function ImportInstallationRequestConfigToJSON(value?: ImportInstallationRequestConfig | null): any;

package/build/generated-sources/api/src/models/ImportInstallationRequestConfig.js

@@ -0,0 +1,54 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportInstallationRequestConfigToJSON = exports.ImportInstallationRequestConfigFromJSONTyped = exports.ImportInstallationRequestConfigFromJSON = exports.instanceOfImportInstallationRequestConfig = void 0;
+const runtime_1 = require("../runtime");
+const ConfigContent_1 = require("./ConfigContent");
+/**
+ * Check if a given object implements the ImportInstallationRequestConfig interface.
+ */
+function instanceOfImportInstallationRequestConfig(value) {
+    let isInstance = true;
+    isInstance = isInstance && "content" in value;
+    return isInstance;
+}
+exports.instanceOfImportInstallationRequestConfig = instanceOfImportInstallationRequestConfig;
+function ImportInstallationRequestConfigFromJSON(json) {
+    return ImportInstallationRequestConfigFromJSONTyped(json, false);
+}
+exports.ImportInstallationRequestConfigFromJSON = ImportInstallationRequestConfigFromJSON;
+function ImportInstallationRequestConfigFromJSONTyped(json, ignoreDiscriminator) {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        'revisionId': !(0, runtime_1.exists)(json, 'revisionId') ? undefined : json['revisionId'],
+        'content': (0, ConfigContent_1.ConfigContentFromJSON)(json['content']),
+    };
+}
+exports.ImportInstallationRequestConfigFromJSONTyped = ImportInstallationRequestConfigFromJSONTyped;
+function ImportInstallationRequestConfigToJSON(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        'revisionId': value.revisionId,
+        'content': (0, ConfigContent_1.ConfigContentToJSON)(value.content),
+    };
+}
+exports.ImportInstallationRequestConfigToJSON = ImportInstallationRequestConfigToJSON;

package/build/generated-sources/api/src/models/Installation.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { Config } from './Config';
+import type { Connection } from './Connection';
+import type { Group } from './Group';
+/**
+ *
+ * @export
+ * @interface Installation
+ */
+export interface Installation {
+    /**
+     * The installation ID.
+     * @type {string}
+     * @memberof Installation
+     */
+    id: string;
+    /**
+     * The Ampersand project ID.
+     * @type {string}
+     * @memberof Installation
+     */
+    projectId: string;
+    /**
+     * The integration ID.
+     * @type {string}
+     * @memberof Installation
+     */
+    integrationId: string;
+    /**
+     *
+     * @type {Group}
+     * @memberof Installation
+     */
+    group?: Group;
+    /**
+     * The health status of the installation ("healthy", "unhealthy").
+     * @type {string}
+     * @memberof Installation
+     */
+    healthStatus: string;
+    /**
+     *
+     * @type {Connection}
+     * @memberof Installation
+     */
+    connection: Connection;
+    /**
+     * The time the integration was first installed.
+     * @type {Date}
+     * @memberof Installation
+     */
+    createTime: Date;
+    /**
+     * The person who did the installation, in the format of "consumer:{consumer-id}".
+     * @type {string}
+     * @memberof Installation
+     */
+    createdBy: string;
+    /**
+     * The time the installation was last updated with a new config.
+     * @type {Date}
+     * @memberof Installation
+     */
+    updateTime?: Date;
+    /**
+     *
+     * @type {Config}
+     * @memberof Installation
+     */
+    config: Config;
+}
+/**
+ * Check if a given object implements the Installation interface.
+ */
+export declare function instanceOfInstallation(value: object): boolean;
+export declare function InstallationFromJSON(json: any): Installation;
+export declare function InstallationFromJSONTyped(json: any, ignoreDiscriminator: boolean): Installation;
+export declare function InstallationToJSON(value?: Installation | null): any;

package/build/generated-sources/api/src/models/Installation.js

@@ -0,0 +1,79 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallationToJSON = exports.InstallationFromJSONTyped = exports.InstallationFromJSON = exports.instanceOfInstallation = void 0;
+const runtime_1 = require("../runtime");
+const Config_1 = require("./Config");
+const Connection_1 = require("./Connection");
+const Group_1 = require("./Group");
+/**
+ * Check if a given object implements the Installation interface.
+ */
+function instanceOfInstallation(value) {
+    let isInstance = true;
+    isInstance = isInstance && "id" in value;
+    isInstance = isInstance && "projectId" in value;
+    isInstance = isInstance && "integrationId" in value;
+    isInstance = isInstance && "healthStatus" in value;
+    isInstance = isInstance && "connection" in value;
+    isInstance = isInstance && "createTime" in value;
+    isInstance = isInstance && "createdBy" in value;
+    isInstance = isInstance && "config" in value;
+    return isInstance;
+}
+exports.instanceOfInstallation = instanceOfInstallation;
+function InstallationFromJSON(json) {
+    return InstallationFromJSONTyped(json, false);
+}
+exports.InstallationFromJSON = InstallationFromJSON;
+function InstallationFromJSONTyped(json, ignoreDiscriminator) {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        'id': json['id'],
+        'projectId': json['projectId'],
+        'integrationId': json['integrationId'],
+        'group': !(0, runtime_1.exists)(json, 'group') ? undefined : (0, Group_1.GroupFromJSON)(json['group']),
+        'healthStatus': json['healthStatus'],
+        'connection': (0, Connection_1.ConnectionFromJSON)(json['connection']),
+        'createTime': (new Date(json['createTime'])),
+        'createdBy': json['createdBy'],
+        'updateTime': !(0, runtime_1.exists)(json, 'updateTime') ? undefined : (new Date(json['updateTime'])),
+        'config': (0, Config_1.ConfigFromJSON)(json['config']),
+    };
+}
+exports.InstallationFromJSONTyped = InstallationFromJSONTyped;
+function InstallationToJSON(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        'id': value.id,
+        'projectId': value.projectId,
+        'integrationId': value.integrationId,
+        'group': (0, Group_1.GroupToJSON)(value.group),
+        'healthStatus': value.healthStatus,
+        'connection': (0, Connection_1.ConnectionToJSON)(value.connection),
+        'createTime': (value.createTime.toISOString()),
+        'createdBy': value.createdBy,
+        'updateTime': value.updateTime === undefined ? undefined : (value.updateTime.toISOString()),
+        'config': (0, Config_1.ConfigToJSON)(value.config),
+    };
+}
+exports.InstallationToJSON = InstallationToJSON;

package/build/generated-sources/api/src/models/Integration.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Ampersand public API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { Revision } from './Revision';
+/**
+ *
+ * @export
+ * @interface Integration
+ */
+export interface Integration {
+    /**
+     * The integration ID.
+     * @type {string}
+     * @memberof Integration
+     */
+    id: string;
+    /**
+     * The Ampersand project ID.
+     * @type {string}
+     * @memberof Integration
+     */
+    projectId: string;
+    /**
+     * The integration name.
+     * @type {string}
+     * @memberof Integration
+     */
+    name: string;
+    /**
+     * The SaaS provider that this integration connects to.
+     * @type {string}
+     * @memberof Integration
+     */
+    provider: string;
+    /**
+     * The time the integration was created.
+     * @type {Date}
+     * @memberof Integration
+     */
+    createTime: Date;
+    /**
+     * The time the integration was last updated.
+     * @type {Date}
+     * @memberof Integration
+     */
+    updateTime?: Date;
+    /**
+     *
+     * @type {Revision}
+     * @memberof Integration
+     */
+    latestRevision: Revision;
+}
+/**
+ * Check if a given object implements the Integration interface.
+ */
+export declare function instanceOfIntegration(value: object): boolean;
+export declare function IntegrationFromJSON(json: any): Integration;
+export declare function IntegrationFromJSONTyped(json: any, ignoreDiscriminator: boolean): Integration;
+export declare function IntegrationToJSON(value?: Integration | null): any;