@prismatic-io/spectral 7.0.13-pre → 7.0.16-pre

package/dist/serverTypes/index.d.ts

@@ -115,6 +115,11 @@ export interface Trigger {
     examplePayload?: unknown;
     isCommonTrigger?: boolean;
 }
+export interface DataSourceContext {
+    logger: ActionLogger;
+    customer: Customer;
+    instance: Instance;
+}
 export declare type DataSourceResult = {
     result: DataSourceResultType;
     supplementalData?: {
@@ -122,7 +127,7 @@ export declare type DataSourceResult = {
         contentType: string;
     };
 };
-export declare type DataSourcePerformFunction = (params: Record<string, unknown>) => Promise<DataSourceResult>;
+export declare type DataSourcePerformFunction = (context: DataSourceContext, params: Record<string, unknown>) => Promise<DataSourceResult>;
 export interface DataSource {
     key: string;
     display: DisplayDefinition & {

package/dist/testing.d.ts

@@ -4,7 +4,7 @@
  * information on unit testing, check out our docs:
  * https://prismatic.io/docs/custom-components/writing-custom-components/#testing-a-component
  */
-import { TriggerPayload, TriggerResult, ConnectionValue, ActionLogger, Component, ActionContext, ActionPerformReturn, DataSourceResult } from "./serverTypes";
+import { TriggerPayload, TriggerResult, ConnectionValue, ActionLogger, Component, ActionContext, ActionPerformReturn, DataSourceResult, DataSourceContext } from "./serverTypes";
 import { ConnectionDefinition, ActionDefinition, TriggerDefinition, Inputs, ActionInputParameters, DataSourceDefinition, ActionPerformReturn as InvokeActionPerformReturn, TriggerResult as InvokeTriggerResult, DataSourceResult as InvokeDataSourceResult } from "./types";
 export declare const createConnection: <T extends ConnectionDefinition>({ key }: T, values: Record<string, unknown>) => ConnectionValue;
 /**
@@ -55,7 +55,7 @@ export declare const invokeDataSource: <TInputs extends Inputs, TDataSourceType
     objectSelection: import("./types").ObjectSelection;
     objectFieldMap: import("./types").ObjectFieldMap;
     jsonForm: import("./types").JSONForm;
-}>({ perform }: DataSourceDefinition<TInputs, TDataSourceType>, params: ActionInputParameters<TInputs>) => Promise<InvokeDataSourceResult<TDataSourceType>>;
+}>({ perform }: DataSourceDefinition<TInputs, TDataSourceType>, params: ActionInputParameters<TInputs>, context?: Partial<DataSourceContext> | undefined) => Promise<InvokeDataSourceResult<TDataSourceType>>;
 export declare class ComponentTestHarness<TComponent extends Component> {
     component: TComponent;
     constructor(component: TComponent);
@@ -64,7 +64,7 @@ export declare class ComponentTestHarness<TComponent extends Component> {
     connectionValue({ key }: ConnectionDefinition): ConnectionValue;
     trigger(key: string, payload?: TriggerPayload, params?: Record<string, unknown>, context?: Partial<ActionContext>): Promise<TriggerResult>;
     action(key: string, params?: Record<string, unknown>, context?: Partial<ActionContext>): Promise<ActionPerformReturn>;
-    dataSource(key: string, params?: Record<string, unknown>): Promise<DataSourceResult>;
+    dataSource(key: string, params?: Record<string, unknown>, context?: Partial<DataSourceContext>): Promise<DataSourceResult>;
 }
 export declare const createHarness: <TComponent extends Component>(component: TComponent) => ComponentTestHarness<TComponent>;
 declare const _default: {
@@ -88,6 +88,6 @@ declare const _default: {
         objectSelection: import("./types").ObjectSelection;
         objectFieldMap: import("./types").ObjectFieldMap;
         jsonForm: import("./types").JSONForm;
-    }>({ perform }: DataSourceDefinition<TInputs_2, TDataSourceType>, params: ActionInputParameters<TInputs_2>) => Promise<InvokeDataSourceResult<TDataSourceType>>;
+    }>({ perform }: DataSourceDefinition<TInputs_2, TDataSourceType>, params: ActionInputParameters<TInputs_2>, context?: Partial<DataSourceContext> | undefined) => Promise<InvokeDataSourceResult<TDataSourceType>>;
 };
 export default _default;

package/dist/testing.js

@@ -37,7 +37,7 @@ const loggerMock = () => ({
     error: (0, jest_mock_1.spyOn)(console, "error"),
 });
 exports.loggerMock = loggerMock;
-const baseContext = {
+const baseActionContext = {
     logger: (0, exports.loggerMock)(),
     instanceState: {},
     crossFlowState: {},
@@ -68,7 +68,7 @@ const baseContext = {
  * action result and a mock logger for asserting logging.
  */
 const invoke = ({ perform }, params, context) => __awaiter(void 0, void 0, void 0, function* () {
-    const realizedContext = Object.assign(Object.assign({}, baseContext), context);
+    const realizedContext = Object.assign(Object.assign({}, baseActionContext), context);
     const result = yield perform(realizedContext, params);
     return {
         result,
@@ -120,7 +120,7 @@ exports.defaultTriggerPayload = defaultTriggerPayload;
  * trigger result and a mock logger for asserting logging.
  */
 const invokeTrigger = ({ perform }, context, payload, params) => __awaiter(void 0, void 0, void 0, function* () {
-    const realizedContext = Object.assign(Object.assign({}, baseContext), context);
+    const realizedContext = Object.assign(Object.assign({}, baseActionContext), context);
     const realizedPayload = Object.assign(Object.assign({}, (0, exports.defaultTriggerPayload)()), payload);
     const realizedParams = params || {};
     const result = yield perform(realizedContext, realizedPayload, realizedParams);
@@ -130,13 +130,26 @@ const invokeTrigger = ({ perform }, context, payload, params) => __awaiter(void
     };
 });
 exports.invokeTrigger = invokeTrigger;
+const baseDataSourceContext = {
+    logger: (0, exports.loggerMock)(),
+    customer: {
+        id: "customerId",
+        name: "Customer 1",
+        externalId: "1234",
+    },
+    instance: {
+        id: "instanceId",
+        name: "Instance 1",
+    },
+};
 /**
  * Invokes specified DataSourceDefinition perform function using supplied params.
  * Accepts a generic type matching DataSourceResult as a convenience to avoid extra
  * casting within test methods. Returns a DataSourceResult.
  */
-const invokeDataSource = ({ perform }, params) => __awaiter(void 0, void 0, void 0, function* () {
-    const result = yield perform(params);
+const invokeDataSource = ({ perform }, params, context) => __awaiter(void 0, void 0, void 0, function* () {
+    const realizedContext = Object.assign(Object.assign({}, baseDataSourceContext), context);
+    const result = yield perform(realizedContext, params);
     return result;
 });
 exports.invokeDataSource = invokeDataSource;
@@ -144,7 +157,7 @@ class ComponentTestHarness {
     constructor(component) {
         this.component = component;
     }
-    buildContext(context) {
+    buildContext(baseContext, context) {
         return Object.assign(Object.assign({}, baseContext), context);
     }
     buildParams(inputs, params) {
@@ -162,19 +175,19 @@ class ComponentTestHarness {
     trigger(key, payload, params, context) {
         return __awaiter(this, void 0, void 0, function* () {
             const trigger = this.component.triggers[key];
-            return trigger.perform(this.buildContext(context), Object.assign(Object.assign({}, (0, exports.defaultTriggerPayload)()), payload), this.buildParams(trigger.inputs, params));
+            return trigger.perform(this.buildContext(baseActionContext, context), Object.assign(Object.assign({}, (0, exports.defaultTriggerPayload)()), payload), this.buildParams(trigger.inputs, params));
         });
     }
     action(key, params, context) {
         return __awaiter(this, void 0, void 0, function* () {
             const action = this.component.actions[key];
-            return action.perform(this.buildContext(context), this.buildParams(action.inputs, params));
+            return action.perform(this.buildContext(baseActionContext, context), this.buildParams(action.inputs, params));
         });
     }
-    dataSource(key, params) {
+    dataSource(key, params, context) {
         return __awaiter(this, void 0, void 0, function* () {
             const dataSource = this.component.dataSources[key];
-            return dataSource.perform(this.buildParams(dataSource.inputs, params));
+            return dataSource.perform(this.buildContext(baseDataSourceContext, context), this.buildParams(dataSource.inputs, params));
         });
     }
 }

package/dist/types/DataSourcePerformFunction.d.ts

@@ -1,3 +1,9 @@
-import { Inputs, DataSourceResult, DataSourceType, ActionInputParameters } from ".";
+import { Inputs, DataSourceResult, DataSourceType, ActionInputParameters, ActionLogger, Customer, Instance } from ".";
+/** Context provided to perform method containing helpers and contextual data */
+export interface DataSourceContext {
+    logger: ActionLogger;
+    customer: Customer;
+    instance: Instance;
+}
 /** Definition of the function to perform when a Data Source is invoked. */
-export declare type DataSourcePerformFunction<TInputs extends Inputs, TDataSourceType extends DataSourceType> = (params: ActionInputParameters<TInputs>) => Promise<DataSourceResult<TDataSourceType>>;
+export declare type DataSourcePerformFunction<TInputs extends Inputs, TDataSourceType extends DataSourceType> = (context: DataSourceContext, params: ActionInputParameters<TInputs>) => Promise<DataSourceResult<TDataSourceType>>;

package/dist/types/Inputs.d.ts

@@ -26,6 +26,8 @@ export declare type JSONForm = {
     uiSchema: Record<string, unknown>;
     data: unknown;
 };
+export declare type DynamicObjectSelection = string;
+export declare type DynamicFieldSelection = string;
 /** InputField type enumeration. */
 export declare type InputFieldType = InputFieldDefinition["type"];
 export declare const InputFieldDefaultMap: Record<InputFieldType, string | undefined>;
@@ -33,7 +35,7 @@ export declare type Inputs = Record<string, InputFieldDefinition>;
 export declare type ConnectionInput = (StringInputField | DataInputField | TextInputField | PasswordInputField | BooleanInputField) & {
     shown?: boolean;
 };
-export declare type InputFieldDefinition = StringInputField | DataInputField | TextInputField | PasswordInputField | BooleanInputField | CodeInputField | ConditionalInputField | ConnectionInputField | ObjectSelectionInputField | ObjectFieldMapInputField | JSONFormInputField;
+export declare type InputFieldDefinition = StringInputField | DataInputField | TextInputField | PasswordInputField | BooleanInputField | CodeInputField | ConditionalInputField | ConnectionInputField | ObjectSelectionInputField | ObjectFieldMapInputField | JSONFormInputField | DynamicObjectSelectionInputField | DynamicFieldSelectionInputField;
 export declare type InputCleanFunction<TValue, TResult = TValue> = (value: TValue) => TResult;
 interface BaseInputField {
     /** Interface label of the InputField. */
@@ -192,6 +194,28 @@ export interface JSONFormInputField extends BaseInputField {
     /** Clean function */
     clean?: InputCleanFunction<NonNullable<this["default"]>>;
 }
+/** Defines attributes of a DynamicObjectSelectionInputField */
+export interface DynamicObjectSelectionInputField extends BaseInputField {
+    /** Data type the InputField will collect. */
+    type: "dynamicObjectSelection";
+    /** Collection type of the InputField */
+    collection?: InputFieldCollection;
+    /** Default value for this field. */
+    default?: unknown;
+    /** Clean function */
+    clean?: InputCleanFunction<NonNullable<this["default"]>>;
+}
+/** Defines attributes of a SelectedFieldInputField */
+export interface DynamicFieldSelectionInputField extends BaseInputField {
+    /** Data type the InputField will collect. */
+    type: "dynamicFieldSelection";
+    /** Collection type of the InputField */
+    collection?: InputFieldCollection;
+    /** Default value for this field. */
+    default?: unknown;
+    /** Clean function */
+    clean?: InputCleanFunction<NonNullable<this["default"]>>;
+}
 /** Defines a single Choice option for a InputField. */
 export interface InputFieldChoice {
     /** Label to display for this Choice. */

package/dist/types/Inputs.js

@@ -13,4 +13,6 @@ exports.InputFieldDefaultMap = {
     objectSelection: undefined,
     objectFieldMap: undefined,
     jsonForm: undefined,
+    dynamicObjectSelection: "",
+    dynamicFieldSelection: "",
 };

package/dist/util.d.ts

@@ -3,7 +3,7 @@
  * Many functions in the `util` module are used to coerce data into a particular type, and can be accessed through `util.types`.
  * For example, `util.types.toInt("5.5")` will return an integer, `5`.
  */
-import { KeyValuePair, DataPayload, ObjectSelection, ObjectFieldMap, JSONForm } from "./types";
+import { KeyValuePair, DataPayload, ObjectSelection, ObjectFieldMap, JSONForm, ConnectionDefinition } from "./types";
 /**
  * This function returns a lower cased version of the headers passed to it.
  *
@@ -45,6 +45,7 @@ declare const _default: {
         toJSONForm: (value: unknown) => JSONForm;
         isPicklist: (value: unknown) => boolean;
         isSchedule: (value: unknown) => boolean;
+        isConnection: (value: unknown) => value is ConnectionDefinition;
     };
     docs: {
         formatJsonExample: (input: unknown) => string;

package/dist/util.js

@@ -405,6 +405,37 @@ const isString = (value) => typeof value === "string" || value instanceof String
  * @returns This function returns the stringified version fo `value`, or `defaultValue` in the case that `value` is undefined or an empty string.
  */
 const toString = (value, defaultValue = "") => `${value !== null && value !== void 0 ? value : defaultValue}`;
+/**
+ * This function checks if value is a valid connection.
+ * @param value The variable to test.
+ * @returns This function returns true or false, depending on if `value` is a valid connection.
+ */
+const isConnection = (value) => {
+    if (typeof value === "string" && isJSON(value)) {
+        return isConnection(JSON.parse(value));
+    }
+    if (Boolean(value) && typeof value === "object") {
+        const { inputs } = value;
+        if (isObjectWithTruthyKeys(value, ["key", "label", "oauth2Type"])) {
+            return (isObjectWithTruthyKeys(inputs, [
+                "authorizeUrl",
+                "tokenUrl",
+                "scopes",
+                "clientId",
+                "clientSecret",
+            ]) ||
+                isObjectWithTruthyKeys(inputs, [
+                    "tokenUrl",
+                    "scopes",
+                    "clientId",
+                    "clientSecret",
+                ]));
+        }
+        return (isObjectWithTruthyKeys(value, ["key", "label"]) &&
+            typeof inputs === "object");
+    }
+    return false;
+};
 /**
  * This function returns true if `value` resembles the shape of JSON, and false otherwise.
  *
@@ -478,6 +509,7 @@ exports.default = {
         toJSONForm,
         isPicklist,
         isSchedule,
+        isConnection,
     },
     docs: {
         formatJsonExample,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prismatic-io/spectral",
-  "version": "7.0.13-pre",
+  "version": "7.0.16-pre",
   "description": "Utility library for building Prismatic components",
   "keywords": [
     "prismatic"