@useparagon/connect 2.3.2-experimental.1 → 2.4.0-experimental-19855.1

package/dist/src/server.types.d.ts

@@ -11,6 +11,7 @@ export type ConnectSdkEnvironments = {
     PASSPORT_PUBLIC_URL: string;
     PLATFORM_ENV: string;
     WORKER_PROXY_PUBLIC_URL: string;
+    API_TRIGGER_KIT_PUBLIC_URL: string;
     VERSION: string;
     ZEUS_PUBLIC_URL: string;
 };

package/dist/src/types/action.d.ts

@@ -1,7 +1,7 @@
-import type { ReactNode } from 'react';
+import { ReactNode } from 'react';
 import { AuthenticationScheme } from '../entities/credential.interface';
 import { CustomDropdownField, DynamicMappingField, DynamicMappingOptions, InstructionStage, SidebarInput } from './connect';
-import { DataType, KeyedSource, Source } from './resolvers';
+import { DataType, KeyedSource, Operator, Source } from './resolvers';
 export declare enum SidebarInputType {
     Auth = "AUTH",
     Enum = "ENUM",
@@ -174,7 +174,7 @@ export interface IntegrationConnectInput extends BaseInput {
     fallbackText?: string;
     hiddenInConnect?: boolean;
 }
-type EnumSection<T = any> = {
+export type EnumSection<T = any> = {
     title: string;
     items: EnumInputValue<T>[];
 };
@@ -400,4 +400,43 @@ export type AccountType = {
     skipPostOAuthInputs?: boolean;
 };
 export type InstructionMetadata = Pick<InstructionStage, 'content' | 'ctas' | 'finish' | 'packageInstallUrl'>;
+export interface DynamicInputSource {
+    sourceType: string;
+    dependencies: string[];
+}
+export declare enum DelayUnit {
+    SECONDS = "SECONDS",
+    MINUTES = "MINUTES",
+    HOURS = "HOURS",
+    DAYS = "DAYS"
+}
+export type GraphiteEnumInput = {
+    value: string | number;
+    dependentInputs?: IntentInputKeyConfig[];
+    label?: string;
+} | string | number;
+export type IntentInputKeyConfig = {
+    id: string;
+    title: string;
+    subtitle?: string;
+    placeholder?: string;
+    required?: boolean;
+    dependentInputs?: IntentInputKeyConfig[];
+    defaultValue?: unknown;
+    valuesSource?: DynamicInputSource;
+} & ({
+    type: `${SidebarInputType.TextArea}` | `${SidebarInputType.Switch}` | `${SidebarInputType.BooleanInput}` | `${SidebarInputType.Code}` | `${SidebarInputType.ValueText}` | `${SidebarInputType.Text}` | `${SidebarInputType.Password}` | `${SidebarInputType.Number}`;
+} | {
+    type: `${SidebarInputType.Enum}` | `${SidebarInputType.EditableEnum}` | `${SidebarInputType.EnumTextAreaPairInput}`;
+    values: GraphiteEnumInput[];
+} | {
+    type: `${SidebarInputType.Conditional}`;
+    supportedOperators?: `${Operator}`[];
+    disableOrCondition?: boolean;
+    supportedKeys?: string[];
+    supportedKeysSource?: DynamicInputSource;
+} | {
+    type: `${SidebarInputType.TimeConstraintInput}`;
+    supportedUnits?: `${DelayUnit}`[];
+});
 export {};

package/dist/src/types/connect.d.ts

@@ -2,9 +2,9 @@ import { IConnectSDKProject } from 'src/entities/project.interface';
 import { ConnectCredentialProviderData, CredentialStatus, IConnectCredential } from '../entities/connectCredential.interface';
 import { ConnectCredentialConfigMeta, IConnectCredentialConfig } from '../entities/connectCredentialConfig.interface';
 import { PersonaMeta } from '../entities/persona.interface';
-import { AccountType, BooleanInput, ComboInput, CopyableButtonInput, CustomDropdownInput, DataSource, DynamicComboInput, DynamicDataSource, DynamicEnumInput, EmailInput, FieldMapperInput, FileInput, IntegrationConnectInput, NumberInput, PasswordInput, PermissionInput, SidebarInputType, StaticEnumDataSource, SwitchInput, URLInput, ValueTextInput } from './action';
+import { AccountType, BooleanInput, ComboInput, CopyableButtonInput, CustomDropdownInput, DataSource, DynamicComboInput, DynamicDataSource, DynamicEnumInput, EmailInput, FieldMapperInput, FileInput, IntegrationConnectInput, IntentInputKeyConfig, NumberInput, PasswordInput, PermissionInput, SidebarInputType, StaticEnumDataSource, SwitchInput, URLInput, ValueTextInput } from './action';
 import { InstallFlowError } from './errors';
-import { OrConditions } from './resolvers';
+import { Operator, OrConditions } from './resolvers';
 import { CredentialConfigOptions, IntegrationInstallEvent, LoadCustomDropdownOptionsResult } from './sdk';
 export { CredentialStatus } from '../entities/connectCredential.interface';
 export type { IntegrationMetadata } from '../entities/integration.interface';
@@ -133,6 +133,11 @@ export type SingleSource = {
     kind: 'single';
     source: DynamicDataSource<any> | StaticEnumDataSource;
 };
+export type ConditionalSource = {
+    kind: 'conditional';
+    source: DynamicDataSource<any>;
+    supportedOperators?: `${Operator}`[];
+};
 export type FieldMapperSources = {
     kind: 'fieldMapper';
     recordSource: DynamicDataSource<any>;
@@ -152,7 +157,7 @@ export type DefaultFieldValueSources = {
     dependentInputSource: DynamicDataSource<any>;
     variableInputSource?: DynamicDataSource<any>;
 };
-export type InputSources = SingleSource | FieldMapperSources | ComboSources | DefaultFieldValueSources;
+export type InputSources = SingleSource | ConditionalSource | FieldMapperSources | ComboSources | DefaultFieldValueSources;
 type IntegrationWorkflowMetaMap = {
     [id: string]: IntegrationWorkflowMeta;
 };
@@ -272,6 +277,24 @@ export type GetIntegrationAccountOptions = {
     includeAccountAuth?: boolean;
     selectedCredentialId?: string;
 };
+export declare enum TriggerModel {
+    POLLING = "POLLING",
+    WEBHOOK = "WEBHOOK"
+}
+export interface TriggerDefinition {
+    type: string;
+    triggerModel: TriggerModel;
+    title: string;
+    description: string;
+    parameters: IntentInputKeyConfig[];
+}
+export interface GetTriggerTypesResponse {
+    triggers: Record<string, TriggerDefinition[]>;
+    errors?: Array<{
+        type: string;
+        message: string;
+    }>;
+}
 export type IConnectUser = Omit<AuthenticatedConnectUser, 'token'>;
 export type IConnectUserWithProject = IConnectUser & {
     project: IConnectSDKProject;

package/dist/src/types/resolvers.d.ts

@@ -231,7 +231,7 @@ type Condition = {
     variable: Source<DataType.STRING>;
     argument: Source<DataType.STRING>;
 };
-declare enum Operator {
+export declare enum Operator {
     'None' = "$none",
     'StringContains' = "$stringContains",
     'StringDoesNotContain' = "$stringDoesNotContain",

package/dist/src/types/sdk.d.ts

@@ -7,8 +7,8 @@ import { IConnectIntegrationWithCredentialInfo, IntegrationMetadata } from '../e
 import { PersonaMeta } from '../entities/persona.interface';
 import { IConnectUserContext } from '../helpers/ConnectUserContext';
 import { ConnectSdkEnvironments } from '../server.types';
-import { AuthenticatedConnectUser, CustomDropdownField, CustomDropdownOptions, DisableWorkflowOptions, DynamicMappingField, DynamicMappingOptions, GetIntegrationAccountOptions, InputSources, IntegrationWorkflowMeta, IntegrationWorkflowState, SerializedConnectInput, UninstallOptions } from '../types/connect';
-import { DataSource, DynamicDataSource, DynamicDefaultInput, EnumInputValue } from './action';
+import { AuthenticatedConnectUser, ConditionalSource, CustomDropdownField, CustomDropdownOptions, DisableWorkflowOptions, DynamicMappingField, DynamicMappingOptions, GetIntegrationAccountOptions, GetTriggerTypesResponse, InputSources, IntegrationWorkflowMeta, IntegrationWorkflowState, SerializedConnectInput, SingleSource, UninstallOptions } from '../types/connect';
+import { DataSource, DynamicDataSource, DynamicDefaultInput, EnumInputValue, EnumSection, IntentInputKeyConfig } from './action';
 import { Props as ConnectModalProps } from './connectModal';
 import { DataType, KeyedSource } from './resolvers';
 export type ConnectUser = {
@@ -187,7 +187,7 @@ export interface IConnectSDK {
      * @param path request path
      * @param init request initialization options {method: httpMethod, body:RequestBody, header}
      */
-    request<TResponse>(action: string, path: string, init?: ProxyRequestOptions): Promise<TResponse | undefined>;
+    request<TResponse>(action: string, path: string, init: ProxyRequestOptions): Promise<TResponse | undefined>;
     /**
      * listen on connect sdk events
      * @param eventName SDKEVENTS
@@ -219,6 +219,12 @@ export interface IConnectSDK {
      * @param options
      */
     getIntegrationAccount(integrationType: string, options?: GetIntegrationAccountOptions): Promise<IConnectIntegrationWithCredentialInfo>;
+    /**
+     * Get available trigger types grouped by integration.
+     * @param action - action name
+     * @param credentialOptions - multi-auth credential selection
+     */
+    getTriggers(action: string, credentialOptions?: Pick<CredentialConfigOptions, 'selectedCredentialId'>): Promise<GetTriggerTypesResponse>;
     /**
      * Connects to a resource using the provided credentials payload.
      * @param resourceSlug
@@ -282,7 +288,7 @@ export interface IConnectSDK {
         parameters?: KeyedSource<DataType.ANY>[];
         selectedCredentialId?: string;
     }): Promise<{
-        data: EnumInputValue[];
+        data: EnumInputValue[] | EnumSection[];
         nestedData: DynamicDefaultInput[];
         nextPageCursor: string | null;
     }>;
@@ -294,12 +300,13 @@ export interface IConnectSDK {
         parameters?: KeyedSource<DataType.ANY>[];
         selectedCredentialId?: string;
     }): Promise<{
-        data: EnumInputValue[];
+        data: EnumInputValue[] | EnumSection[];
         nestedData: DynamicDefaultInput[];
         nextPageCursor: string | null;
     }>;
     getDataSourceOptions(integrationName: string, action: string): Promise<DataSource | undefined>;
     getSourcesForInput(integrationName: string, input: SerializedConnectInput): InputSources | null;
+    getSourcesForActionInput(input: IntentInputKeyConfig): SingleSource | ConditionalSource | null;
     installFlow: InstallFlow;
     getAssetUrl(name: string): string;
 }
@@ -542,8 +549,8 @@ export type UpdateWorkflowStateResponse = {
 };
 export type ProxyRequestOptions = {
     selectedCredentialId?: string;
-    method?: RequestInit['method'];
-    body?: RequestInit['body'] | object;
-    headers?: RequestInit['headers'];
+    method: RequestInit['method'];
+    body: RequestInit['body'] | object;
+    headers: RequestInit['headers'];
 };
 export {};

package/dist/src/utils/connect.d.ts

@@ -21,14 +21,3 @@ export declare function sanitizeExternalConfigId(externalId: string): string;
 export declare const getHeadersForUserMeta: (userMeta?: PersonaMeta) => {
     [x: string]: string;
 };
-/**
- * Normalizes persona metadata keys to match DB conventions.
- * `name` (any casing) -> `Name`, `email` (any casing) -> `Email`,
- * all other keys are trimmed.
- */
-export declare function normalizePersonaMeta(meta: PersonaMeta): PersonaMeta;
-/**
- * Checks whether incoming metadata (from request header) would produce
- * a meaningful change when merged into the existing stored metadata.
- */
-export declare function hasPersonaMetaChanged(incomingMeta: PersonaMeta, storedMeta: PersonaMeta | undefined | null): boolean;

package/dist/src/utils/generic.d.ts

@@ -28,6 +28,12 @@ export declare function generateMatrix<T extends Record<string, any>>(input: {
     [k in keyof T]: T[k][];
 }, limit?: number): T[];
 export declare function sleep(milliseconds: number): Promise<void>;
+/**
+ * Normalizes a plain object for comparison by sorting keys (key-order independent).
+ * Only handles objects; does not accept or recurse into arrays.
+ */
+export declare function normalizeForMetaCompare(value: Record<string, unknown>): Record<string, unknown>;
+export declare function areObjectsEqual(a: Record<string, unknown>, b: Record<string, unknown>): boolean;
 export declare const uuidPattern: RegExp;
 export declare function isUUID(value: string | unknown): boolean;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@useparagon/connect",
-  "version": "2.3.2-experimental.1",
+  "version": "2.4.0-experimental-19855.1",
   "description": "Embed integrations into your app with the Paragon SDK",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -33,12 +33,9 @@
     "clone-deep": "^4.0.1",
     "hash.js": "^1.1.7",
     "jwt-decode": "^3.1.2",
-    "lodash": "^4.17.23",
+    "react": "^17.0.2",
     "tslib": "2.3.1"
   },
-  "peerDependencies": {
-    "react": "^17 || ^18 || ^19"
-  },
   "devDependencies": {
     "@babel/core": "^7.12.3",
     "@babel/preset-env": "^7.12.1",
@@ -49,7 +46,6 @@
     "@types/gapi": "^0.0.47",
     "@types/google.picker": "^0.0.42",
     "@types/jest": "^29.5.1",
-    "@types/lodash": "^4.17.24",
     "@types/node": "^18.13.0",
     "@types/react": "^17.0.11",
     "@types/react-dom": "^17.0.8",
@@ -81,7 +77,6 @@
     "pkg": "^5.8.1",
     "prettier": "^2.2.1",
     "process": "^0.11.10",
-    "react": "^17.0.2",
     "react-dom": "^17.0.2",
     "rimraf": "^3.0.2",
     "stream-browserify": "^3.0.0",