@integration-app/react 0.1.26 → 0.2.0

package/README.md

@@ -0,0 +1,68 @@
+## Releasing Package
+
+To release a new version of a package (@integration-app/sdk, @integration-app/ui, @integration-app/react), do the following:
+
+* Go to the package and type `npm version -- patch` (or `npm version -- minor` or `npm version -- major`) to bump the version.
+* Create a PR with the changes.
+* Merge the PR.
+* Run a Github Action to publish a package.
+
+# Rollup config
+
+Check out the [rollup.config.mjs](rollup.config.mjs) file for the full config.
+
+It's pretty self-explanatory, but here's some additional info:
+
+## Externals
+
+We set `{external: [/node_modules/]}` because we don't want to bundle any of our dependencies.
+If we need to bundle some dependencies and some not, we can use [`rollup-plugin-peer-deps-external`](https://www.npmjs.com/package/rollup-plugin-peer-deps-external) plugin instead of this.
+
+To prevent Rollup from bundling the `@integration-app/sdk` package during local development, we specify it as an external dependency since Rollup does not match locally placed packages with the `/node_modules/` rule. 
+
+## DTS
+
+DTS files are generated by `tsc` and placed in `dist/dts` folder.
+After that plugin `rollup-plugin-dts` is used to generate `*.d.ts` files for each bundle.
+
+# Package.json exports
+
+```json5
+{
+  "exports": {
+    "types": "./dist/index.d.ts",       // TypeScript typings for NodeNext modules
+    "require": "./dist/index.js",       // used for require() in Node 12+
+    "import": "./dist/index.module.mjs" // ESM bundle
+  },
+  "types": "./dist/index.d.ts",         // TypeScript typings
+  "main": "./dist/index.js",            // CommonJS bundle
+  "module": "./dist/index.module.mjs",  // ESM bundle
+  "unpkg": "./dist/index.umd.js",       // UMD bundle
+}
+```
+
+# Local and publish build workflow
+
+For a local development, we use locally placed `@integration-app/sdk` package. 
+
+And for publishing, we use `@integration-app/sdk@latest` package.
+
+To make it work, we use `dev` and `build` commands.
+
+## `dev` workflow
+
+- Delete `dist` folders
+- Install local `@integration-app/sdk` pointed to `sdk` folder
+- Remove `react` and `react-dom` packages from `node_modules` folder
+    - We should do it to allow out package work in `console`, `engine` and other local projects
+- Run `rollup` in watch mode to build a package
+
+## `build` workflow
+
+- Delete `dist` folders
+- Install `@integration-app/sdk@latest` package
+- Run `rollup` to build a package
+
+Because GitHub Actions use `build` command, we could be sure that package uses the latest `@integration-app/sdk` package.
+
+

package/dist/index.d.ts

@@ -0,0 +1,291 @@
+import * as _integration_app_sdk from '@integration-app/sdk';
+import { IntegrationAppClient, ConnectionSpec, Integration, IntegrationAccessor, FindIntegrationsQuery, Connection, ConnectionAccessor, FindConnectionsQuery, FieldMapping, FieldMappingAccessor, FindFieldMappingsQuery, FieldMappingInstanceSelector, IFieldMappingInstance, FieldMappingInstanceAccessor, OpenFieldMappingInstanceConfigurationOptions, FindFieldMappingInstancesQuery, DataSource, DataSourceAccessor, FindDataSourcesQuery, DataSourceInstanceSelector, DataSourceInstance, DataSourceInstanceAccessor, OpenDataSourceConfigurationOptions, DataCollectionFindRequest, DataCollectionCreateRequest, DataCollectionUpdateRequest, DataCollectionSpec, FindDataSourceEventsQuery, DataSourceEvent, FindAppEventsQuery, AppEvent, AppEventType, AppEventTypeAccessor, FindAppEventTypesQuery, AppEventSubscriptionSelector, AppEventSubscription, AppEventSubscriptionAccessor, FindAppEventSubscriptionsQuery, Flow, FlowAccessor, FindFlowsRequest, FlowInstanceSelector, FlowInstance, FlowInstanceAccessor, FindFlowInstancesQuery, FlowRun, FlowRunAccessor, FindFlowRunsRequest } from '@integration-app/sdk';
+export { DataForm } from '@integration-app/sdk';
+import { ReactNode } from 'react';
+
+interface IntegrationAppProviderProps {
+    token: string;
+    apiUri?: string;
+    uiUri?: string;
+    children: ReactNode;
+}
+declare const IntegrationAppProvider: ({ token, apiUri, uiUri, children, }: IntegrationAppProviderProps) => JSX.Element;
+declare function useIntegrationApp(): IntegrationAppClient;
+
+declare function useConnectorSpec(integrationKey: string): {
+    data: ConnectionSpec;
+    loading: boolean;
+    error: Error;
+};
+
+declare function useIntegration(idOrKey: string): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.CreateIntegrationRequest) => Promise<Integration>;
+    patch: (data: _integration_app_sdk.UpdateIntegrationRequest) => Promise<Integration>;
+    put: (data: _integration_app_sdk.CreateIntegrationRequest) => Promise<Integration>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: IntegrationAccessor;
+    integration: Integration;
+};
+
+declare function useIntegrations(query?: FindIntegrationsQuery): {
+    items: Integration[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useConnection(id: string): {
+    loading: boolean;
+    error?: Error;
+    create: (data: Partial<Connection>) => Promise<Connection>;
+    patch: (data: Partial<Connection>) => Promise<Connection>;
+    put: (data: Partial<Connection>) => Promise<Connection>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: ConnectionAccessor;
+    connection: Connection;
+};
+
+declare function useConnections(query?: FindConnectionsQuery): {
+    items: Connection[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useFieldMapping(idOrKey: string): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.CreateFieldMappingRequest) => Promise<FieldMapping>;
+    patch: (data: Partial<_integration_app_sdk.CreateFieldMappingRequest>) => Promise<FieldMapping>;
+    put: (data: _integration_app_sdk.CreateFieldMappingRequest) => Promise<FieldMapping>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: FieldMappingAccessor;
+    fieldMapping: FieldMapping;
+};
+
+declare function useFieldMappings(query?: FindFieldMappingsQuery): {
+    items: FieldMapping[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useFieldMappingInstance(selector: FieldMappingInstanceSelector | {
+    id: string;
+}): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.CreateFieldMappingInstanceRequest) => Promise<IFieldMappingInstance>;
+    patch: (data: _integration_app_sdk.UpdateFieldMappingInstanceRequest) => Promise<IFieldMappingInstance>;
+    put: (data: _integration_app_sdk.CreateFieldMappingInstanceRequest) => Promise<IFieldMappingInstance>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: FieldMappingInstanceAccessor;
+    fieldMappingInstance: IFieldMappingInstance;
+    setup: () => Promise<void>;
+    reset: () => Promise<void>;
+    openConfiguration: (options?: OpenFieldMappingInstanceConfigurationOptions) => Promise<void>;
+};
+
+declare function useFieldMappingInstances(query?: FindFieldMappingInstancesQuery): {
+    items: IFieldMappingInstance[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useDataSource(idOrKey: string): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.CreateDataSourceRequest) => Promise<DataSource>;
+    patch: (data: Partial<_integration_app_sdk.CreateDataSourceRequest>) => Promise<DataSource>;
+    put: (data: _integration_app_sdk.CreateDataSourceRequest) => Promise<DataSource>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: DataSourceAccessor;
+    dataSource: DataSource;
+};
+
+declare function useDataSources(query?: FindDataSourcesQuery): {
+    items: DataSource[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useDataSourceInstance(selector: DataSourceInstanceSelector | {
+    id: string;
+}): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.CreateDataSourceInstanceRequest) => Promise<DataSourceInstance>;
+    patch: (data: _integration_app_sdk.UpdateDataSourceInstanceRequest) => Promise<DataSourceInstance>;
+    put: (data: _integration_app_sdk.CreateDataSourceInstanceRequest) => Promise<DataSourceInstance>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: DataSourceInstanceAccessor;
+    dataSourceInstance: DataSourceInstance;
+    setup: () => Promise<void>;
+    subscribe: (eventType: any) => Promise<void>;
+    resubscribe: (eventType: any) => Promise<void>;
+    unsubscribe: (eventType: any) => Promise<void>;
+    pullUpdates: () => Promise<void>;
+    fullSync: () => Promise<void>;
+    reset: () => Promise<void>;
+    openConfiguration: (options?: OpenDataSourceConfigurationOptions) => Promise<void>;
+    findRecords: (request?: DataCollectionFindRequest) => Promise<_integration_app_sdk.DataCollectionFindResponse>;
+    findRecordById: (id: string) => Promise<_integration_app_sdk.DataCollectionFindByIdResponse>;
+    createRecord: (request?: DataCollectionCreateRequest) => Promise<_integration_app_sdk.DataCollectionCreateResponse>;
+    updateRecord: (request?: DataCollectionUpdateRequest) => Promise<_integration_app_sdk.DataCollectionUpdateResponse>;
+    deleteRecord: (id?: string) => Promise<_integration_app_sdk.DataCollectionDeleteResponse>;
+    unifiedFieldsToNative: (unifiedFields: any) => Promise<any>;
+};
+
+declare function useDataSourceInstanceCollection(dataSourceInstance: DataSourceInstance): {
+    loading: boolean;
+    error: Error;
+    refresh: () => void;
+    collection: DataCollectionSpec;
+};
+
+declare function useDataSourceInstanceLocations(dataSourceInstance: DataSourceInstance, args?: {
+    path?: string;
+    cursor?: string;
+}): {
+    loading: boolean;
+    error: Error;
+    refresh: () => void;
+    locations: _integration_app_sdk.DataLocation[];
+};
+
+declare function useDataSourceEvents(query?: FindDataSourceEventsQuery): {
+    items: DataSourceEvent[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useAppEvents(query?: FindAppEventsQuery): {
+    items: AppEvent[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useAppEventType(idOrKey: string): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.CreateAppEventTypeRequest) => Promise<AppEventType>;
+    patch: (data: _integration_app_sdk.CreateAppEventTypeRequest) => Promise<AppEventType>;
+    put: (data: _integration_app_sdk.CreateAppEventTypeRequest) => Promise<AppEventType>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: AppEventTypeAccessor;
+    appEventType: AppEventType;
+};
+
+declare function useAppEventTypes(query?: FindAppEventTypesQuery): {
+    items: AppEventType[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useAppEventSubscription(selector: AppEventSubscriptionSelector | {
+    id: string;
+}): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.IAppEventSubscriptionUpdate) => Promise<AppEventSubscription>;
+    patch: (data: _integration_app_sdk.IAppEventSubscriptionUpdate) => Promise<AppEventSubscription>;
+    put: (data: _integration_app_sdk.IAppEventSubscriptionUpdate) => Promise<AppEventSubscription>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: AppEventSubscriptionAccessor;
+    appEventSubscription: AppEventSubscription;
+};
+
+declare function useAppEventSubscriptions(query?: FindAppEventSubscriptionsQuery): {
+    items: AppEventSubscription[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useFlow(idOrKey: string): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.CreateFlowRequest) => Promise<Flow>;
+    patch: (data: _integration_app_sdk.UpdateFlowRequest) => Promise<Flow>;
+    put: (data: _integration_app_sdk.CreateFlowRequest) => Promise<Flow>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: FlowAccessor;
+    flow: Flow;
+};
+
+declare function useFlows(query?: FindFlowsRequest): {
+    items: Flow[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useFlowInstance(props: FlowInstanceSelector | {
+    id: string;
+}): {
+    loading: boolean;
+    error?: Error;
+    create: (data: _integration_app_sdk.CreateFlowInstanceRequest) => Promise<FlowInstance>;
+    patch: (data: _integration_app_sdk.UpdateFlowInstanceRequest) => Promise<FlowInstance>;
+    put: (data: _integration_app_sdk.CreateFlowInstanceRequest) => Promise<FlowInstance>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: FlowInstanceAccessor;
+    flowInstance: FlowInstance;
+};
+
+declare function useFlowInstances(query?: FindFlowInstancesQuery): {
+    items: FlowInstance[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+declare function useFlowRun(id: string): {
+    loading: boolean;
+    error?: Error;
+    create: (data: Partial<FlowRun>) => Promise<FlowRun>;
+    patch: (data: Partial<FlowRun>) => Promise<FlowRun>;
+    put: (data: Partial<FlowRun>) => Promise<FlowRun>;
+    archive: () => Promise<void>;
+    refresh: () => void;
+    accessor: FlowRunAccessor;
+    flowRun: FlowRun;
+};
+
+declare function useFlowRuns(query?: FindFlowRunsRequest): {
+    items: FlowRun[];
+    loading: boolean;
+    error?: Error;
+    refresh(): Promise<void>;
+    loadMore(): Promise<void>;
+};
+
+export { IntegrationAppProvider, useAppEventSubscription, useAppEventSubscriptions, useAppEventType, useAppEventTypes, useAppEvents, useConnection, useConnections, useConnectorSpec, useDataSource, useDataSourceInstanceCollection as useDataSourceCollection, useDataSourceEvents, useDataSourceInstance, useDataSourceInstanceLocations as useDataSourceLocations, useDataSources, useFieldMapping, useFieldMappingInstance, useFieldMappingInstances, useFieldMappings, useFlow, useFlowInstance, useFlowInstances, useFlowRun, useFlowRuns, useFlows, useIntegration, useIntegrationApp, useIntegrations };